---
title: "Übersetzung erstellen"
description: "Laden Sie eine Datei über die API hoch und bereiten Sie eine Übersetzung für die Planung vor – per JSON-Text, HTTPS-URL oder Multipart-Formulardaten für Binärformate."
canonical: "https://ai-glot.com/docs/de/api/translations/create"
updated: "2026-08-31"
---

# Übersetzung erstellen

Erfordert `batches:create`. Das Erstellen einer Übersetzung ist kostenlos: Credits werden erst reserviert, wenn Sie einen [Plan genehmigen](/docs/api/translations/approve).

## Ü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:

1. [`POST /v1/batches/{batch_id}/plan`](/docs/api/translations/plan): Beschreiben Sie in eigenen Worten, was übersetzt werden soll.
2. [`POST /v1/batches/{batch_id}/approve`](/docs/api/translations/approve): Credits einlösen und Vorgang starten.
3. [`GET /v1/batches/{batch_id}`](/docs/api/translations/retrieve): Status abfragen, bis der Vorgang abgeschlossen ist.
4. [`GET /v1/batches/{batch_id}/result`](/docs/api/translations/download): Ergebnis abrufen. Gibt einen signierten Link zurück, nicht die Datei selbst.

> **Info: Größenlimits gelten pro Format**
>
> Jede Formatfamilie hat ein eigenes Limit zwischen 4 MB und 60 MB. Die vollständige Übersicht finden Sie unter [Dateien und Formate](/docs/platform/files-and-formats). Eine Datei, die das Limit überschreitet, wird mit dem Fehler `file_too_large` abgewiesen, noch bevor Bytes gespeichert werden.