Traduções

Use as Traduções para traduzir texto, o texto visível em imagens e a fala em áudio para qualquer idioma. É adequado para conteúdo de produtos, mensagens de suporte, placas e capturas de tela, além de notas de voz que precisam alcançar usuários em outro idioma.

Antes de chamar este endpoint, crie uma chave de API e certifique-se de que a conta tenha um saldo positivo.

Endpoint #

Comportamento da solicitação #

Os idiomas são definidos livremente: um nome como Japanese, um código como pt-BR ou uma variante como Spanish (Mexico, informal). Os mesmos idiomas se aplicam a todos os documentos na solicitação.

O serviço retorna apenas o conteúdo traduzido. Preserva formatação, quebras de linha, Markdown, código, URLs, números e nomes próprios, e trata o conteúdo como texto a ser traduzido, não como instruções. Para imagens, traduz o texto visível; para áudio, traduz o conteúdo falado. Outros tipos de conteúdo, como arquivos ou vídeo, retornam 400 Bad Request. O erro não identifica qual documento foi rejeitado, portanto, verifique o tipo de conteúdo de cada documento na solicitação.

{
  "fromLanguage": "English",
  "toLanguage": "Brazilian Portuguese",
  "documents": [
    {
      "type": "text",
      "text": "Your order has shipped and should arrive within three business days."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/sign.png"
      }
    }
  ]
}

Leia a resposta #

data contém uma string traduzida por documento, na mesma ordem que documents. Os documentos são traduzidos independentemente e em paralelo. Se algum documento falhar, a solicitação retornará um erro em vez de resultados parciais. Documentos que foram concluídos antes da falha ainda serão cobrados, portanto, tente novamente apenas após corrigir o documento com falha.

{
  "message": null,
  "data": [
    "Seu pedido foi enviado e deve chegar em até três dias úteis.",
    "Proibido estacionar"
  ]
}

As traduções são geradas por modelos. Revise-as antes de publicar conteúdo legal, médico, financeiro ou outros conteúdos com consequências significativas, e mantenha o original disponível para referência.

Preços e limites #

As traduções são cobradas em unidades de processamento (PUs), abrangendo o uso de entrada e saída. O uso é registrado para cada documento. O preço da PU varia conforme o modelo de processamento selecionado para o tipo de conteúdo, e o multiplicador do plano se aplica.

O número de solicitações de tradução por minuto e por dia depende do plano; consulte Limites de processamento de dados. O limite conta solicitações HTTP, não documentos. Uma solicitação que exceder qualquer janela ativa retornará 429 Too Many Requests.

A referência de API embutida contém os detalhes de solicitação, resposta, autenticação e erros mantidos pelo servidor: