API
Translate images via API while preserving layout and style.
Get started in minutes
Create a key, send an image, and receive a translated image back.
API Reference
/api/v1/image-translateAuthorization: Bearer <key_id>.<secret>Never expose or share your API key — treat it like a password.
image (file) *
Image file upload.
source_language (string)
Source language code. Omit or use "auto" for auto-detect.
target_language (string)
Language code. Default: en.
translator_model (string)
Translator model ID (grok | openai | claude | gemini). Default: gemini (subject to plan restrictions).
Success (200)
success (boolean)
Always true for a 200 response.
credits (number, optional)
Remaining credits for the account (omitted for anonymous).
image (string)
Translated image as a data URL (e.g. data:image/png;base64,...).
chunks (array)
Detected text regions: label, sourceText, translatedText.
word_mapping (object)
Map of original text to translated text used for the image edit.
target_language (string)
Target language code (e.g. ja, en).
{
"success": true,
"credits": 1234,
"image": "data:image/png;base64,...",
"chunks": [
{
"label": 1,
"sourceText": "Hello",
"translatedText": "こんにちは",
}
],
"word_mapping": { "Hello": "こんにちは" },
"target_language": "ja"
}
On Error (4xx/5xx)
{ "error": "Message", "code": "ERROR_CODE" }
API_KEY=itk_xxx.its_yyy
curl -X POST "https://api.translatenets.com/api/v1/image-translate" \
-H "Authorization: Bearer ${API_KEY}" \
-F "image=@./image.png" \
-F "target_language=ja" \
-F "translator_model=gemini"
Build your request
- Supported image types: PNG, JPEG/JPG, WebP, GIF.
- Empty uploads are rejected.