Dokumentation
API-Dokumentation

API-Dokumentation

Öffentliche REST-API von imagetranslate.ai. Per Bearer-Token authentifizieren, base64-kodiertes Bild senden, übersetztes Bild zurückerhalten.

Übersetzt Text in Bildern, behält das ursprüngliche Layout bei und rendert das Ergebnis zurück ins Bild.

Schnellstart

API-Key erstellen

Unter API Keys einen neuen Key generieren.

Erste Anfrage absetzen

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "grok-4-fast"
  }'

Antwort verarbeiten

response.resultImage ist ein base64-kodiertes PNG mit dem Präfix data:image/png;base64, — keine HTTP-URL. Im Browser direkt via <img src={response.resultImage} /> einbinden; zum Abspeichern das Präfix entfernen und den base64-Teil dekodieren.

Authentifizierung

Jede Anfrage muss den API-Key als Bearer-Token im Authorization-Header übergeben:

Authorization: Bearer YOUR_KEY

API-Keys sind 32-Byte-Zufallsstrings mit dem Präfix sk_imagetranslate_. Wie Passwörter behandeln — im serverseitigen Secret-Manager ablegen, nicht ins Repository committen und nicht im Frontend-Code ausliefern.

Idempotenz

Wird eine Anfrage nach einem Netzwerk-Timeout wiederholt, denselben Idempotency-Key-Header mitschicken, um doppelten Credit-Abzug zu vermeiden:

Idempotency-Key: <your-uuid>
  • Erster Aufruf mit einem Key: wird regulär verarbeitet.
  • Folgeaufruf mit demselben Key (pro API-Key): liefert 409 Conflict samt der ursprünglichen recordId. Der Retry verbraucht kein Credit.
  • Verschiedene Keys = verschiedene Aufrufe.

Den Key clientseitig generieren (UUIDv4 reicht). Ohne Key verbraucht jeder Retry frische Credits und ruft Torii erneut auf.

Bild übersetzen

Synchroner Endpoint. Liefert das übersetzte Bild als base64-kodiertes PNG mit Präfix data:image/png;base64, zurück.

Base URL

https://api.imagetranslate.ai

Request Body

FeldTypPflichtBeschreibung
imageBase64stringjabase64-kodiertes Bild. Akzeptiert sowohl reinen base64-String als auch vollständige Data-URL (data:image/png;base64,...). Maximal 20 MB nach Dekodierung.
sourceLanguagestringjaISO-Sprachcode oder auto zur automatischen Erkennung. Siehe Sprachcodes.
targetLanguagestringjaISO-Sprachcode. Siehe Sprachcodes.
modestringneinRenderstil. Standardwert: general. Siehe mode-Werte.
translatorstringneinÜbersetzungsmodell. Standardwert: grok-4. Siehe translator-Modelle.
customPromptstringneinZusätzliche Anweisungen an das Modell. Maximal 1000 Zeichen.

Response

FeldTypBeschreibung
successbooleantrue bei erfolgreicher Übersetzung.
recordIdstringEindeutige Log-ID dieses Aufrufs. Bei Problemen dem Support mitteilen.
resultImagestringÜbersetztes Bild als base64-kodiertes PNG mit Präfix data:image/png;base64, (keine HTTP-URL). Direkt via <img src={...} /> rendern oder zum Abspeichern das Präfix entfernen und base64 dekodieren.
remainingCreditnumberVerbleibendes Advanced-Credit-Guthaben nach diesem Aufruf.

Beispiele

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "grok-4-fast"
  }'

Beispiel-Response

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

Fehlercodes

StatusBedeutung
400Ungültiges Request-Format oder imageBase64 ist kein gültiger base64-String.
401API-Key fehlt oder ist ungültig. Unter API Keys einen neuen anlegen.
402Advanced Credits reichen nicht aus. Auf der Preisseite aufladen. Dieser Aufruf verbraucht keine Credits.
403Der aktuelle Plan umfasst keinen API-Zugriff. Upgrade auf Professional oder höher über die Preisseite.
409Idempotency-Key bereits verwendet. Liefert { "error": "idempotency_replay", "recordId": "<id>" }. Credit nicht abgebucht.
413Bild überschreitet nach base64-Dekodierung 20 MB. Bitte komprimieren oder verkleinern.
422Request-Body-Validierung fehlgeschlagen (fehlendes/ungültiges Feld). Body enthält detail-Array mit Fehlerort.
429Rate-Limit für deinen Plan überschritten. Keine Credits abgebucht.
500Übersetzung fehlgeschlagen. Credits werden automatisch erstattet.

Fehler-Response-Format

  • 4xx / 500: { "detail": "<message>" }
  • 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
  • 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

Rate Limits

Pro API-Key und Minute, abhängig vom Kontoplan.

PlanLimit
Freenicht verfügbar
Starternicht verfügbar
Professional60 req/min
Enterprise300 req/min

Höhere Limits erforderlich? Eine kurze Mail an [email protected] genügt.

Preise

10 Advanced Credits pro Aufruf. Pläne und Credit-Pakete sind auf der Preisseite zu finden.

Anhang

Sprachcodes

sourceLanguage akzeptiert ISO-639-1- bzw. BCP-47-Codes oder auto zur automatischen Erkennung. targetLanguage akzeptiert dieselben Codes (außer auto).

Gängige Codes:

CodeSpracheCodeSprache
autoAuto-Erkennung (nur source)ptPortugiesisch
enEnglischruRussisch
zhChinesischarArabisch
zh-cnVereinfachtes ChinesischhiHindi
zh-twTraditionelles ChinesischthThai
jaJapanischviVietnamesisch
koKoreanischidIndonesisch
esSpanischtrTürkisch
frFranzösischitItalienisch
deDeutschnlNiederländisch
Vollständige Liste — über 130 Sprachen, nach Region gruppiert

Ostasien

CodeSprache
zhChinesisch
zh-cnVereinfachtes Chinesisch
zh-twTraditionelles Chinesisch
jaJapanisch
koKoreanisch
mnMongolisch
jvJavanisch
suSundanesisch

Südostasien

CodeSprache
viVietnamesisch
thThai
idIndonesisch
msMalaiisch
myBirmanisch
kmKhmer
loLaotisch
filFilipino
cebCebuano
iloIlokano

Südasien

CodeSpracheCodeSprache
hiHindineNepali
bnBengalischsiSinghalesisch
urUrduasAssamesisch
taTamilbhoBhojpuri
teTelugudvDhivehi
mlMalayalamdoiDogri
guGujaratigomKonkani
knKannadamaiMaithili
mrMarathilusMizo
orOdiapaPunjabi
saSanskritsdSindhi

Afrika

CodeSpracheCodeSprache
amAmharischkriKrio
swSwahililnLingala
haHausansoNord-Sotho
yoYorubaomOromo
zuZulustSesotho
xhXhosasnShona
afAfrikaanstiTigrinya
mgMadagassischtsTsonga
soSomaliakTwi
bmBambaraeeEwe
nyChichewalgLuganda
igIgborwKinyarwanda

Europa

CodeSpracheCodeSprache
frFranzösischltLitauisch
deDeutschlvLettisch
esSpanischetEstnisch
itItalienischisIsländisch
ruRussischsqAlbanisch
plPolnischhyArmenisch
ukUkrainischazAserbaidschanisch
nlNiederländischeuBaskisch
ptPortugiesischbeWeißrussisch
elGriechischbsBosnisch
csTschechischcaKatalanisch
huUngarischcoKorsisch
svSchwedischfyFriesisch
daDänischglGalicisch
fiFinnischkaGeorgisch
noNorwegischkkKasachisch
roRumänischkyKirgisisch
bgBulgarischlbLuxemburgisch
hrKroatischmkMazedonisch
skSlowakischmtMaltesisch
slSlowenischsrSerbisch
tgTadschikischttTatarisch
tkTurkmenischugUigurisch
uzUsbekisch

Naher Osten

CodeSprache
arArabisch
faPersisch
trTürkisch
heHebräisch
kuKurdisch
ckbSorani-Kurdisch
psPaschtu

Amerika & Ozeanien

CodeSprache
ayAymara
gnGuaraní
htHaitianisches Kreolisch
hawHawaiisch
quQuechua
smSamoanisch
miMaori

Sonstige

CodeSprache
eoEsperanto
laLatein
cyWalisisch
gaIrisch
gdSchottisch-Gälisch
hmnHmong
yiJiddisch

mode-Werte

mode legt den Renderstil fest. Den jeweils passendsten Wert für das Bild wählen.

ValueBeschreibung
general (Standard)Standardmodus ohne spezielle Darstellung.
mangaOriginallayout mit Textumrandung.
e-commerceOriginallayout ohne Textumrandung.
light-novelÜbersetzten Text über das Originalbild legen.

translator-Modelle

translator bestimmt das KI-Modell für die Übersetzung. Alle Modelle kosten 10 Credits pro Aufruf.

  • grok-4 (Standard)
  • gemini-2.5-flash
  • deepseek
  • gpt-5
  • claude-sonnet-4-5

Loslegen

Bereit für die Integration? Ersten API-Key erstellen →

Vorherige Seite

Dokumentation

Auf dieser Seite