POST /translate

Endpoint

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

Autenticação

Header	Obrigatório	Valor
`X-API-Key`	Sim	Sua chave de API (`bun_...`)
`Content-Type`	Sim	`application/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

Campo	Tipo	Obrigatório	Descrição
`text`	string	Sim	Texto a traduzir
`from`	string	Sim	Código do idioma de origem (ISO 639-1, ex.: `en`)
`to`	string	Sim	Código do idioma de destino (ISO 639-1, ex.: `pt`)

Exemplo

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

Resposta

200 OK

Campo	Tipo	Descrição
`text`	string	Texto original
`translated_text`	string	Texto traduzido
`from`	string	Código do idioma de origem
`to`	string	Có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"}'

Introdução

Referência da API

POST /translate

Endpoint

Autenticação

Visão geral

Casos de uso

Detalhes

Corpo da requisição

Exemplo

Resposta

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

Exemplo cURL

​Endpoint

​Autenticação

​Visão geral

​Casos de uso

​Detalhes

​Corpo da requisição

​Exemplo

​Resposta

​200 OK

​401 Unauthorized

​402 Payment Required

​422 Unprocessable Entity

​429 Too Many Requests

​Exemplo cURL

Endpoint

Autenticação

Visão geral

Casos de uso

Detalhes

Corpo da requisição

Exemplo

Resposta

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

Exemplo cURL