Tradução | transcript1 docs

O transcript1 transcreve a mídia primeiro e depois traduz o texto da transcrição para um idioma à sua escolha. A tradução é alinhada por segmento e mantém os tempos e os falantes originais. É apenas tradução de texto: não há dublagem nem áudio traduzido.

A tradução é gratuita. Ela usa 0 minutos e aparece no seu histórico de uso como uma entrada gratuita "Translation". Os minutos de transcrição valem como sempre, e uma tradução com falha nunca faz a transcrição falhar nem a reembolsa.

Traduzir ao transcrever

Adicione translate_to à requisição que cria a transcrição. É um código ISO 639-1 de duas letras minúsculas, como es ou en. Funciona com um link de vídeo no corpo JSON de POST /v1/transcriptions, na reserva de um upload em partes e em um upload multipart de uma só requisição.

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'

Em um upload de arquivo, envie translate_to como campo de formulário:

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F [email protected] \
  -F translate_to=en

A ferramenta MCP transcribe também aceita translate_to. Um idioma de destino por requisição.

Traduzir uma transcrição que já existe

Peça a tradução de uma transcrição concluída:

curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en"}'

A API responde 202:

{
  "transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "language": "en",
  "status": "processing"
}

Status	Significado
`404`	A transcrição não foi encontrada.
`409 transcript_not_ready`	A transcrição ainda não está `completed`.
`422`	O idioma não é um código válido de duas letras.

A chamada é idempotente. Uma tradução processing ou completed é devolvida como está, e uma failed é tentada de novo. A ferramenta MCP translate_transcription recebe id e language.

Ler a tradução

GET /v1/transcriptions/:id e os downloads em texto, SRT e VTT aceitam translation:

`translation`	Resultado
`both` (padrão)	Os segmentos JSON ganham um campo `translation`. O texto coloca a linha traduzida abaixo da original. Os blocos SRT e VTT têm duas linhas: a original e depois a tradução.
`only`	O texto traduzido substitui `text`. Os tempos e os falantes continuam iguais.
`none`	Somente a transcrição original.

A resposta tem um objeto translation, ou null quando nenhuma tradução foi pedida:

{
  "translation": { "language": "es", "status": "completed" }
}

status é processing, completed ou failed. Uma tradução com falha também traz uma mensagem error. O wait também espera pela tradução pedida; se o tempo acabar, o status é processing. A ferramenta MCP get_transcription tem um parâmetro translation com os mesmos valores.

Webhooks

Dois eventos informam o resultado da tradução, além de transcription.completed e transcription.failed, que não mudam:

`type`	Enviado quando
`transcription.translation.completed`	Uma tradução pedida chegou a `completed`.
`transcription.translation.failed`	Uma tradução pedida chegou a `failed`.

data é o objeto da transcrição mais translation: { language, status, error }. Veja Webhooks para assinaturas e regras de entrega.