Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/translate

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Traduza texto entre mais de 100 idiomas com uma única chamada de API. A API de Tradução da Bunny aceita códigos de idioma de origem e destino e retorna o texto traduzido junto com uma pontuação de confiança.

​
Casos de uso

  • Criar interfaces multilíngues sem um backend de i18n dedicado
  • Traduzir conteúdo gerado por usuários em tempo real
  • Alimentar ferramentas de suporte ao cliente com tradução automática de mensagens
  • Adicionar detecção de idioma a pipelines de conteúdo

​
Detalhes

Usa códigos ISO 639-1 (ex.: en, pt, es, fr, de). O campo confidence (0–1) reflete a qualidade da tradução. Textos longos são suportados, mas o tempo de resposta escala com o tamanho.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
textstringSimTexto a traduzir
fromstringSimCódigo do idioma de origem (ISO 639-1, ex.: en)
tostringSimCódigo do idioma de destino (ISO 639-1, ex.: pt)

​
Exemplo

{
  "text": "Hello world",
  "from": "en",
  "to": "pt"
}

​
Resposta

​
200 OK

CampoTipoDescrição
textstringTexto original
translated_textstringTexto traduzido
fromstringCódigo do idioma de origem
tostringCódigo do idioma de destino
Exemplo 
{
  "text": "Hello world",
  "translated_text": "Olá mundo",
  "from": "en",
  "to": "pt"
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

Código de idioma inválido ou texto vazio. 
{
  "detail": "Unsupported language code"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/translate \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "from": "en", "to": "pt"}'