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

POST
https://translatemyimage.com/api/translate

Erforderliche Header

HeaderWert
Content-Typemultipart/form-data (wird automatisch vom HTTP-Client gesetzt)
X-API-KeyYOUR_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

ParameterTypBeschreibung
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

StatusBeschreibung
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_request
  • invalid_image
  • plan_required
  • insufficient_credits
  • content_blocked
  • service_unavailable
  • generation_failed
  • unknown

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.

Payload einer erfolgreichen Antwort
{
    "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" }
    }
}