Übersetzung erstellen
Send the file one of three ways: JSON with content (the file itself as UTF-8 text — text formats only, the simplest path for agents), JSON with file_url (HTTPS, fetched server-side, no redirects), or multipart/form-data with a file field (required for XLSX and ZIP). filename is optional: if omitted, a clean default name is generated and the format is inferred automatically from the content. Include instruction to get the full trust-gated plan back in the same response (takes some seconds); omit it to receive four grounded suggested_instructions and continue with the plan endpoint. Quality is chosen at approval, not here — the plan quotes both tiers. Per-format size limits are on /v1/account as entitlements.max_upload_bytes_by_format. The upload also appears in the web app.
POST/v1/batches
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.