batches

Übersetzungen auflisten

Die neuesten zuerst, archivierte sind standardmäßig ausgeschlossen. Die Paginierung erfolgt cursor-basiert: Übergeben Sie den next_cursor aus der vorherigen Antwort wortwörtlich. Offsets werden nicht unterstützt, da eine während der Paginierung erstellte Übersetzung diese stillschweigend verschieben würde. search sucht nach dem Namen einer Übersetzung oder, falls keiner vorhanden ist, nach dem Namen der hochgeladenen Datei. Dies ist dieselbe Suche, die die Batch-Liste der Web-App verwendet, sodass die Ergebnisse zwischen beiden niemals voneinander abweichen.

GET/v1/batches

Request

curl --request GET \
  --url 'https://api.ai-glot.com/v1/batches' \
  --header 'Authorization: <api-key>'

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/batches");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.ai-glot.com/v1/batches", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.ai-glot.com/v1/batches"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.ai-glot.com/v1/batches")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "file_name": "<string>",
      "status": "analyzing",
      "quality_tier": "<string>",
      "word_count": 123,
      "credit_cost": 123,
      "is_sample": true,
      "archived": true,
      "progress": {
        "phase": "<string>",
        "percent": 123.45,
        "updated_at": "<string>",
        "estimated_seconds_remaining": 123
      },
      "error": {
        "code": "<string>",
        "message": "<string>"
      },
      "created_at": "<string>",
      "completed_at": "<string>",
      "next_action": "provide_instruction",
      "plan": {
        "instruction": "<string>",
        "summary": {},
        "will_translate": {},
        "will_not_touch": {},
        "special_rules": [
          {}
        ],
        "assumptions": [
          {}
        ],
        "not_included": [
          {}
        ],
        "languages": [
          {}
        ],
        "totals": {
          "segments": {},
          "words": {},
          "files": {}
        },
        "credits": {
          "standard": {},
          "lite": {}
        },
        "preview": [
          {}
        ],
        "cached": true
      },
      "suggested_instructions": [
        "<string>"
      ]
    }
  ],
  "has_more": true,
  "next_cursor": null,
  "limit": 123,
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

Erfordert batches:read. Archivierte Übersetzungen sind standardmäßig ausgeschlossen. Übergeben Sie next_cursor unverändert zurück, um die nächste Seite abzurufen.

Filtern Sie mit status, archived, quality_tier, created_after und created_before. search findet Übereinstimmungen im Namen einer Übersetzung oder, falls keiner vorhanden ist, im Namen der hochgeladenen Datei. Dies ist dieselbe Suche, die auch die Liste in der Web-App verwendet, sodass beide niemals voneinander abweichen.

Dieser Endpunkt liest nur: Er startet keine Übersetzung und verbraucht keine Credits. Er listet jede Übersetzung im Workspace auf, unabhängig davon, über welche Schnittstelle sie erstellt wurde. Um eine Übersetzung zu starten, erstellen Sie eine Übersetzung.

Antwort

application/json

Übersetzungen auflisten

dataobject[]required

Show child attributes

idstringrequired

namestring | nullrequired

file_namestring | nullrequired

statusstringrequired

Der aktuelle Status der Übersetzung. Alle sieben Werte: analyzing - die Dateistruktur wird gelesen, was einige Sekunden dauert; Polling durchführen. awaiting_instructions - die Datei wurde gelesen, aber es wurde noch nicht festgelegt, was übersetzt werden soll; plan-Call ausführen. awaiting_approval - ein Plan wartet auf die Zustimmung; approve-Call ausführen, der einzige Aufruf, der Credits verbraucht. translating - läuft; Polling durchführen. completed - Ergebnis abrufen. failed - der Durchlauf konnte nicht abgeschlossen werden; error lesen. cancelled - jemand hat den Vorgang absichtlich gestoppt; ebenfalls ein Endzustand und kein Fehler. Die letzten drei sind Endzustände: Polling beenden.

quality_tierstring | nullrequired

word_countinteger | nullrequired

credit_costinteger | nullrequired

is_samplebooleanrequired

archivedbooleanrequired

progressobjectrequired

errorobject | nullrequired

created_atstring | nullrequired

completed_atstring | nullrequired

next_actionstring

Der nächste auszuführen Call, sodass ein Client status nicht selbst zuordnen muss. provide_instruction - plan-Call mit einer Anweisung ausführen. review_plan - der bepreiste Plan ist eingebettet; plan.not_included prüfen, dann genehmigen. wait - erneut pollen; progress.estimated_seconds_remaining gibt die verbleibende Zeit an. download - Ergebnis abrufen. read_error - der Durchlauf ist ohne Ergebnis beendet; error lesen (und status gibt an, ob er abgebrochen wurde oder fehlgeschlagen ist). Fehlt nur bei einem veralteten CSV-Batch vor dem 2026-08-31, der keinen Plan besitzt; jede seitdem erstellte Übersetzung antwortet.

planobject | null

suggested_instructionsstring[] | null

has_morebooleanrequired

next_cursorstringnullrequired

limitintegerrequired

request_idstringrequired

Übersetzungen auflisten

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown