API Reference

Translate the text in an image, preserving the original layout, and render it back into the image.

Quick start

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"
  }'

Authentication

All requests must include your API key in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_KEY

Keys are 32-byte random tokens prefixed with sk_imagetranslate_. Treat them like passwords — store them in a server-side secret manager, never commit them to source control, never expose them in client-side code.

Idempotency

If you retry a request after a network timeout, send the same Idempotency-Key header to avoid double-charging credits:

Idempotency-Key: <your-uuid>

• First call with a given key: processed normally.
• Subsequent call with the same key (per API key): returns 409 Conflict and the original recordId. The retry does not consume credit.
• Different keys = different calls.

Generate the key on the client (UUIDv4 is fine). Without it, retries each consume a fresh credit and run Torii again.

Translate Image

Synchronous endpoint. Returns the translated image base64-encoded (with a data:image/png;base64, prefix).

Base URL

https://api.imagetranslate.ai

Request body

Response

Examples

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"
  }'

Example response

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

Error codes

Error response format

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

Rate limits

Per-key per-minute limits based on your account plan.

Need a higher limit? Email [email protected].

Pricing

10 advanced credits per translation call. See pricing for plan details and credit packages.

Appendix

Language values

sourceLanguage accepts an ISO 639-1 / BCP-47 code, or auto for automatic detection. targetLanguage accepts the same codes (no auto).

Common codes:

Mode values

The mode field tunes the rendering style for different content types. Pick the one that best matches your image.

Translator values

The translator field selects which AI model performs the translation. All cost 10 credits per call.

• Grok (default)
• Gemini
• Deepseek
• ChatGPT
• Claude

Get started

Ready to integrate? Create your first API key →