Перевод видео сразу при расшифровке
Добавьте translate_to, двухбуквенный код ISO 639-1, в запрос, который создаёт расшифровку. Параметр wait дожидается и перевода. О загрузках и MCP рассказывает руководство по переводу.
Транскрипт создаётся как обычно: из речи или субтитров платформы. Перевод запускается позже и работает с этим текстом, поэтому оригинал всегда есть и его можно читать, даже если перевод ещё не готов.
Запрос принимает только один целевой язык. Чтобы получить второй язык, переведите тот же транскрипт ещё раз после его завершения.
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"}'Перевод уже готового транскрипта
Отправьте язык методом POST к расшифровке. API ответит кодом 202 и статусом перевода. Опрашивайте расшифровку или используйте вебхук. Коды статуса описаны в разделе Перевод.
Расшифровка должна быть завершена, иначе API вернёт transcript_not_ready. Повторять запрос безопасно: перевод в процессе или готовый возвращается как есть, а неудачный запускается снова.
Вебхуки отправляют transcription.translation.completed или transcription.translation.failed, поэтому приложению не нужно постоянно опрашивать API.
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"}'Двуязычные субтитры, только перевод или оригинал
Добавьте translation=both, only или none к GET /v1/transcriptions/:id или к скачиванию текста, SRT либо VTT. По умолчанию both.
При both сегменты JSON получают поле translation, в тексте переведённая строка идёт под оригиналом, а в каждом блоке SRT или VTT две строки. При only перевод заменяет оригинал, а таймкоды и говорящие остаются прежними.
В ответе также есть объект translation с языком и статусом: processing, completed или failed. Чтение другого формата готового транскрипта не расходует дополнительных минут.
| translation | Что вы получаете |
|---|---|
| both | Оригинал и перевод вместе, по паре на сегмент или блок. |
| only | Перевод вместо оригинала, с тем же временем. |
| none | Только исходный транскрипт. |
Что делает перевод и чего он не делает
Это машинный перевод текста транскрипта. Перед публикацией проверьте имена, термины и цитаты, а исходный транскрипт сохраните для сравнения.
transcript1 не дублирует видео и не переводит голос. Переведённого звука нет, а субтитры не вшиваются в видео. Вы получаете текст и файлы субтитров для своего редактора или плеера.
Перевод не расходует минуты. Минуты расшифровки списываются как обычно, а неудачный перевод не приводит к ошибке транскрипта и не возвращает минуты.