Documentação da API

Traduza o texto de uma imagem preservando o layout original e receba o resultado renderizado de volta na própria imagem.

Início rápido

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

Autenticação

Toda requisição precisa incluir a API key no header Authorization como token Bearer:

Authorization: Bearer YOUR_KEY

API keys são strings aleatórias de 32 bytes com o prefixo sk_imagetranslate_. Trate como senha: guarde em um gerenciador de segredos no servidor, nunca faça commit no repositório e nunca exponha no código front-end.

Idempotência

Se você reenviar uma requisição após um timeout de rede, inclua o mesmo header Idempotency-Key para evitar cobrança dupla de créditos:

Idempotency-Key: <seu-uuid>

• Primeira chamada com uma chave: processada normalmente.
• Chamadas seguintes com a mesma chave (por API key): retornam 409 Conflict e o recordId original. A repetição não consome crédito.
• Chaves diferentes = chamadas diferentes.

Gere a chave no cliente (UUIDv4 funciona bem). Sem ela, cada repetição consome um novo crédito e roda o Torii de novo.

Traduzir imagem

Endpoint síncrono. Retorna a imagem traduzida em base64 (com o prefixo data:image/png;base64,).

Base URL

https://api.imagetranslate.ai

Corpo da requisição

Resposta

Exemplos

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

Exemplo de resposta

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

Códigos de erro

Formato da resposta de erro

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

Limites de requisições

Por API key, por minuto, de acordo com o plano:

Precisa de mais? Envie um email para [email protected].

Preços

10 advanced credits por chamada. Confira planos e pacotes de crédito na página de preços.

Apêndice

Códigos de idioma

sourceLanguage aceita códigos ISO 639-1 / BCP-47 ou auto para detecção automática. targetLanguage aceita os mesmos códigos (exceto auto).

Códigos mais comuns:

Valores de mode

mode define o estilo de renderização. Escolha o que mais se aproxima do conteúdo da sua imagem.

Modelos translator

translator define o modelo de IA que faz a tradução. Todos custam 10 créditos por chamada.

• Grok (padrão)
• Gemini
• Deepseek
• ChatGPT
• Claude

Começar

Pronto para integrar? Gere sua primeira API key →