Áudio e tempo real

Create Translation

Traduz áudio para texto em inglês

POST
/v1/audio/translations

Visão Geral

Traduz áudio em qualquer idioma suportado para texto em inglês. Diferente da transcrição, este endpoint sempre gera texto em inglês, independentemente do idioma de entrada.

Este endpoint traduz áudio para inglês. Não envie language; ele não é suportado para tradução de áudio e pode retornar unsupported_parameter. Para tradução de texto, use POST /v1/translations; recommended_for=translation refere-se a essa API de texto.

Corpo da Requisição

A tradução é retornada quando o processamento termina. Para áudios mais longos, permita um timeout do cliente HTTP de pelo menos 120s.

filefileobrigatório

O arquivo de áudio a ser traduzido. Formatos suportados: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. O tamanho máximo do arquivo é de 25 MB.

modelstringobrigatório

Nenhum modelo público declara suporte atualmente para POST /v1/audio/translations; não há ID de modelo padrão ou copiável.

promptstring

Um texto opcional para guiar o estilo do modelo ou continuar um segmento anterior. Deve estar em inglês.

response_formatstringpadrão: json

Formato de saída. Os valores aceitos dependem do modelo; consulte seus detalhes. text retorna texto puro em vez de um objeto JSON.

temperaturenumber

Temperatura de amostragem de 0 a 1, apenas para modelos que listam este parâmetro.

Resposta

Os campos abaixo descrevem respostas em JSON de transcrição ou tradução. text, srt e vtt retornam texto puro ou legendas em vez de um objeto JSON. Campos adicionais dependem do modelo e do formato de saída.

textstring

O texto traduzido em inglês.

Para o formato verbose_json, a resposta também inclui:

languagestring

Rótulo do idioma informado na resposta, quando fornecido.

durationnumber

A duração do áudio de entrada em segundos.

segmentsarray

Segmentos do texto traduzido com marcações de tempo (timestamps).

Requisição

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-model-id" \
  -F "file=@german_audio.mp3"

Resposta

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

Tradução vs Transcrição

RecursoTraduçãoTranscrição
Idioma de saídaSempre inglêsO mesmo da entrada
Caso de usoConverter áudio estrangeiro para inglêsPreservar o idioma original
Parâmetro de idiomaNão aplicávelDica opcional

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

  • "auto"
  • "verified"
  • "official"

Corpo da requisição

multipart/form-data

Resposta

application/json

application/json

application/json

application/json

application/json

application/json