---
title: "Criar uma tradução"
description: "Envie um arquivo via API e prepare uma tradução pronta para planejamento, usando texto JSON, uma URL HTTPS ou multipart/form-data para formatos binários."
canonical: "https://ai-glot.com/docs/pt/api/translations/create"
updated: "2026-08-31"
---

# Criar uma tradução

Requer `batches:create`. Criar uma tradução não custa nada: os créditos são reservados apenas quando você [aprova um plano](/docs/api/translations/approve).

## Como escolher a forma de envio do arquivo

Há três métodos de envio, e a escolha ideal depende do formato do arquivo, e não de preferência pessoal.

| Método                | Recomendado para          | Observações                                                                                                      |
| --------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| JSON com `content`    | Qualquer formato de texto | O próprio arquivo como texto em UTF-8. É o caminho mais simples para um agente que já tem o conteúdo em memória. |
| JSON com `file_url`   | Arquivos já hospedados    | Apenas HTTPS, obtido no lado do servidor. Redirecionamentos não são seguidos, portanto forneça a URL final.      |
| `multipart/form-data` | XLSX e ZIP                | **Obrigatório** para formatos binários: eles não podem ser enviados como texto JSON.                             |

O parâmetro `filename` é opcional, mas recomendável. O formato é identificado por meio da extensão; portanto, nomes como `strings.xml` e `export.csv` acionam parsers diferentes para bytes idênticos.

## Próximos passos

A resposta retorna um `batch_id`. A partir daí, a sequência é sempre a mesma:

1. [`POST /v1/batches/{batch_id}/plan`](/docs/api/translations/plan): descreva o que deve ser traduzido, com suas próprias palavras.
2. [`POST /v1/batches/{batch_id}/approve`](/docs/api/translations/approve): use créditos e inicie o processo.
3. [`GET /v1/batches/{batch_id}`](/docs/api/translations/retrieve): consulte o status até a conclusão.
4. [`GET /v1/batches/{batch_id}/result`](/docs/api/translations/download): obtenha o resultado. Retorna um link assinado, e não o arquivo diretamente.

> **Info: Os limites de tamanho variam por formato**
>
> Cada família de formatos tem seu próprio limite, variando de 4 MB a 60 MB. Consulte [Arquivos e formatos](/docs/platform/files-and-formats) para ver a tabela completa. Arquivos que excederem o limite serão recusados com o erro `file_too_large` antes que qualquer byte seja armazenado.