API-Dokumentation

Vollständige Referenz zur Integration der TranslateMyImage-API

Details zum API-Endpunkt

Sende ein Bild mit einem aktiven API-Schlüssel zur Übersetzung. API-Schlüssel sind ab dem Tarif Pro verfügbar. Jede abgeschlossene Übersetzung verbraucht ein Guthaben.

Endpunkt

POST

https://translatemyimage.com/api/translate

Erforderliche Header

Header	Wert
Content-Type	multipart/form-data (wird automatisch vom HTTP-Client gesetzt)
X-API-Key	YOUR_API_KEY

Erstelle deinen Schlüssel auf der API-Schlüsselseite. Er wird nur einmal angezeigt. Sende 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. Verwende «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 Guthaben wird verbraucht.
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.
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. Versuche 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 deine 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ähle deine 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" }
    }
}