Traducir subtítulos mientras transcribes un video
Agrega translate_to, un código ISO 639-1 de dos letras, a la solicitud que crea la transcripción. wait también espera la traducción. La guía de traducción explica las subidas y MCP.
La transcripción se crea como siempre, a partir del audio o de los subtítulos de la plataforma. La traducción se hace después sobre ese texto, así que el original siempre existe y se puede leer aunque la traducción aún no esté lista.
Cada solicitud acepta un solo idioma de destino. Para obtener otro idioma, vuelve a traducir la misma transcripción cuando termine.
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"}'Traducir una transcripción que ya existe
Envía el idioma con POST a la transcripción. La API responde 202 con el estado de la traducción. Consulta la transcripción o usa un webhook. Los códigos de estado están en Traducción.
La transcripción debe estar completada; si no, la API devuelve transcript_not_ready. Repetir la solicitud es seguro: una traducción en proceso o completada se devuelve tal cual, y una fallida se reintenta.
Los webhooks envían transcription.translation.completed o transcription.translation.failed, así que tu aplicación no necesita consultar el estado una y otra vez.
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"}'Subtítulos bilingües, solo traducción u original
Agrega translation=both, only o none a GET /v1/transcriptions/:id o a una descarga de texto, SRT o VTT. El valor predeterminado es both.
Con both, los segmentos JSON incluyen un campo translation, el texto pone la línea traducida debajo de la original y cada bloque SRT o VTT tiene dos líneas. Con only, el texto traducido reemplaza al original y los tiempos y hablantes no cambian.
La respuesta también trae un objeto translation con el idioma y un estado: processing, completed o failed. Leer otro formato de una transcripción terminada no consume más minutos.
| translation | Qué obtienes |
|---|---|
| both | El texto original y el traducido juntos, un par por segmento o bloque. |
| only | El texto traducido en lugar del original, con los mismos tiempos. |
| none | Solo la transcripción original. |
Qué hace la traducción y qué no hace
Es traducción automática del texto de la transcripción. Revisa nombres, términos técnicos y citas antes de publicar, y guarda la transcripción original para comparar.
transcript1 no dobla ni traduce la voz de un video. No hay audio traducido ni se incrustan subtítulos en el video. Recibes texto y archivos de subtítulos para usar en tu editor o reproductor.
Traducir no cuesta minutos. Los minutos de transcripción se aplican como siempre, y una traducción fallida ni hace fallar la transcripción ni la reembolsa.