> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /translate

> Traduza texto entre mais de 100 idiomas com uma única chamada de API. Retorna o texto traduzido e uma pontuação de confiança.

## 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

```json theme={null}
{
  "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**

```json theme={null}
{
  "text": "Hello world",
  "translated_text": "Olá mundo",
  "from": "en",
  "to": "pt"
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

Código de idioma inválido ou texto vazio.

```json theme={null}
{
  "detail": "Unsupported language code"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
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"}'
```