batches

Übersetzung erstellen

Senden Sie die Datei auf eine von drei Arten: JSON mit content (die Datei selbst als UTF-8-Text - nur Textformate, der einfachste Weg für Agenten), JSON mit file_url (HTTPS, serverseitig abgerufen, keine Weiterleitungen) oder multipart/form-data mit einem file-Feld (erforderlich für XLSX und ZIP). filename ist optional: Wird es weggelassen, wird ein sauberer Standardname generiert und das Format automatisch aus dem Inhalt abgeleitet. Fügen Sie instruction hinzu, um den vollständigen, zustimmungsbedürftigen Plan in derselben Antwort zu erhalten (dauert einige Sekunden); lassen Sie es weg, um vier fundierte suggested_instructions zu erhalten und mit dem Plan-Endpunkt fortzufahren. Die Qualität wird bei der Genehmigung gewählt, nicht hier - der Plan führt beide Tiers auf. Formatbezogene Größenbeschränkungen finden Sie unter /v1/account als entitlements.max_upload_bytes_by_format. Der Upload erscheint ebenfalls in der Web-App.

POST/v1/batches

Request

curl --request POST \
  --url 'https://api.ai-glot.com/v1/batches' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "file_url": "<string>",
  "content": "<string>",
  "filename": "<string>",
  "instruction": "<string>"
}'

import json
import requests

url = "https://api.ai-glot.com/v1/batches"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.ai-glot.com/v1/batches", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "file_url": "<string>",
    "content": "<string>",
    "filename": "<string>",
    "instruction": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/batches");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

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

package main

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

func main() {
  req, _ := http.NewRequest("POST", "https://api.ai-glot.com/v1/batches", bytes.NewBuffer([]byte("{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  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>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}"))
    .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::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}"

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": "<string>",
      "will_translate": "<string>",
      "will_not_touch": "<string>",
      "special_rules": [
        "<string>"
      ],
      "assumptions": [
        "<string>"
      ],
      "not_included": [
        "<string>"
      ],
      "languages": [
        {
          "source": {},
          "target": {},
          "segments": {},
          "words": {}
        }
      ],
      "totals": {
        "segments": 123,
        "words": 123,
        "files": {}
      },
      "credits": {
        "standard": 123,
        "lite": 123
      },
      "preview": [
        {
          "location": {},
          "source_text": {},
          "source_lang": {},
          "target_lang": {}
        }
      ],
      "cached": true
    },
    "suggested_instructions": [
      "<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>"
}

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

Erfordert batches:create. Das Erstellen einer Übersetzung ist kostenlos: Credits werden erst reserviert, wenn Sie einen Plan genehmigen.

Übertragungsweg für die Datei wählen

Es stehen drei Übertragungswege zur Verfügung. Die Wahl hängt vom Dateiformat ab, nicht von persönlichen Präferenzen.

Übertragungsweg	Verwendung für	Hinweise
JSON mit `content`	Jedes Textformat	Die Datei selbst als UTF-8-Text. Der einfachste Weg für einen Agenten, der den Inhalt bereits im Arbeitsspeicher vorhält.
JSON mit `file_url`	Bereits gehostete Dateien	Nur HTTPS, serverseitig abgerufen. Weiterleitungen wird nicht gefolgt; geben Sie daher die finale URL an.
`multipart/form-data`	XLSX und ZIP	Erforderlich für Binärformate: Diese können nicht als JSON-Text übertragen werden.

filename ist optional, wird jedoch empfohlen. Das Format wird anhand der Dateiendung erkannt. Namen wie strings.xml und export.csv führen daher bei identischen Bytes zu unterschiedlichen Parsern.

Wie es weitergeht

Die Antwort enthält eine batch_id. Der weitere Ablauf ist stets derselbe:

POST /v1/batches/{batch_id}/plan: Beschreiben Sie in eigenen Worten, was übersetzt werden soll.
POST /v1/batches/{batch_id}/approve: Credits einlösen und Vorgang starten.
GET /v1/batches/{batch_id}: Status abfragen, bis der Vorgang abgeschlossen ist.
GET /v1/batches/{batch_id}/result: Ergebnis abrufen. Gibt einen signierten Link zurück, nicht die Datei selbst.

Antwort

application/json

Übersetzung aus einer Datei erstellen

dataobjectrequired

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

request_idstringrequired

Übersetzung erstellen

Übertragungsweg für die Datei wählen

Wie es weitergeht

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown