API-Dokumentation
Die TranslateMyImage-API übersetzt den Text in einem Bild und gibt ein neues Bild zurück, keine Liste von Zeichenketten. Sie senden ein JPG, PNG oder WebP und eine Zielsprache an einen einzigen Endpunkt; die JSON-Antwort verlinkt das übersetzte Bild, das unter Beibehaltung des ursprünglichen Layouts erzeugt wird.
Neu bei der API? Lesen Sie, was die Bildübersetzungs-API leistet, mit Anfragebeispielen in curl, Python und Node.js.
Details zum API-Endpunkt
Senden Sie ein Bild mit einem aktiven API-Schlüssel zur Übersetzung. API-Schlüssel sind ab dem Tarif Pro verfügbar. Jede abgeschlossene Übersetzung verbraucht einen Credit.
Endpunkt
https://translatemyimage.com/api/translateErforderliche Header
| Header | Wert |
|---|---|
| Content-Type | multipart/form-data (wird automatisch vom HTTP-Client gesetzt) |
| X-API-Key | YOUR_API_KEY |
Erstellen Sie Ihren Schlüssel auf der API-Schlüsselseite. Er wird nur einmal angezeigt. Senden Sie ihn im X-API-Key-Header; API-Clients benötigen keine Browsersitzung.
Body-Anforderungen
| Parameter | Typ | Beschreibung |
|---|---|---|
| file | Erforderlich File | Eine Bilddatei (JPG, PNG oder WEBP), bis zu 10 MB und 25 Megapixel. |
| target_lang | Erforderlich String | Zielsprachencode: en, fr, es, de, it, pt, ja, ko oder zh. |
| source_lang | Optional String | Quellsprachencode. Wenn nicht angegeben, wird er automatisch erkannt. Verwenden Sie «auto» für dasselbe Verhalten. |
| quality | Optional String | «basic» (Standard) oder «ultra». |
| business_type | Optional String | «default», «marketing», «edition» oder «technical documentation». |
| custom_prompt | Optional String | Optionale KI-Anweisungen mit bis zu 1.000 Zeichen, verfügbar ab dem Tarif Pro. |
Antworten
| Status | Beschreibung |
|---|---|
200 OK | Übersetzung abgeschlossen; ein Credit wird verbraucht. |
202 Accepted | Das Hauptmodell hat dieses Bild abgelehnt, daher übersetzt es ein alternatives Modell, was einige Minuten dauert. Die Antwort enthält translation.status: "processing". Rufen Sie GET /api/translate?id= mit der zurückgegebenen translation.id und demselben X-API-Key auf, bis translations[0].status den Wert completed (dann wird ein Credit verbraucht) oder failed hat; translations[0].metadata.failureCode nennt dann einen der unten aufgeführten Codes. |
400 Bad Request | Ungültige Eingabe, nicht unterstütztes Format oder fehlende Datei. |
401 Unauthorized | API-Schlüssel fehlt, ist ungültig oder widerrufen, wenn keine Sitzung vorhanden ist. |
402 Payment Required | Nicht genügend Credits (Code insufficient_credits). Ein erneuter Versuch hilft nicht: Fügen Sie Credits hinzu oder warten Sie auf die monatliche Erneuerung. |
403 Forbidden | API-Schlüssel erfordern den Tarif Pro oder höher; einige Optionen benötigen ebenfalls einen geeigneten Tarif. |
429 Too Many Requests | Der Bilddienst ist rate-limitiert. Versuchen Sie es später erneut. |
500 Internal Server Error | Verarbeitung fehlgeschlagen. |
Fehlerantworten verwenden JSON mit success: false und einer Nachricht im Feld error.
Nach der Authentifizierung enthalten Fehlerantworten zusätzlich ein stabiles Feld code, damit Ihre Integration darauf reagieren kann, ohne die englische Nachricht auszuwerten:
invalid_requestinvalid_imageplan_requiredinsufficient_creditscontent_blockedservice_unavailablegeneration_failedunknown
Authentifizierungsfehler (fehlender, ungültiger oder widerrufener API-Schlüssel oder ein Konto ohne API-Zugang) haben keinen Code.
Beispiel für einen API-Aufruf
Wählen Sie Ihre Programmiersprache für das Implementierungsbeispiel
curl -X POST https://translatemyimage.com/api/translate \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "target_lang=en" \
-F "source_lang=auto"Antwortformat
Die API liefert ein JSON-Objekt mit Übersetzungsergebnissen und URLs.
{
"success": true,
"translation": {
"id": "clxb1234567890",
"originalUrl": "https://storage.com/original.jpg",
"translatedUrl": "https://storage.com/translated.jpg",
"sourceLang": "fr",
"targetLang": "en",
"status": "completed",
"createdAt": "2026-09-21T15:27:39.000Z",
"metadata": { "quality": "basic", "model": "muse-image" }
}
}