Перевод | transcript1 docs

transcript1 сначала расшифровывает запись, а затем переводит текст транскрипта на выбранный вами язык. Перевод выравнивается по сегментам и сохраняет исходные таймкоды и говорящих. Это только перевод текста: без дубляжа и переведённого звука.

Перевод бесплатный. Он расходует 0 минут и отображается в истории использования как бесплатная запись «Translation». Минуты расшифровки списываются как обычно, а неудачный перевод никогда не приводит к ошибке транскрипта и не возвращает минуты.

Перевод сразу при расшифровке

Добавьте translate_to в запрос, который создаёт расшифровку. Это двухбуквенный код ISO 639-1 в нижнем регистре, например es или en. Он работает со ссылкой на видео в JSON-теле POST /v1/transcriptions, с резервированием поэтапной загрузки и с одношаговой multipart-загрузкой.

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"}'

При загрузке файла передайте translate_to как поле формы:

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

Инструмент MCP transcribe тоже принимает translate_to. Один целевой язык на запрос.

Перевод уже готового транскрипта

Закажите перевод завершённой расшифровки:

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"}'

API отвечает кодом 202:

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

Статус	Значение
`404`	Расшифровка не найдена.
`409 transcript_not_ready`	Расшифровка ещё не в статусе `completed`.
`422`	Язык не является допустимым двухбуквенным кодом.

Вызов идемпотентен. Перевод в статусе processing или completed возвращается как есть, а failed запускается повторно. Инструмент MCP translate_transcription принимает id и language.

Чтение перевода

GET /v1/transcriptions/:id и скачивание текста, SRT и VTT принимают translation:

`translation`	Результат
`both` (по умолчанию)	Сегменты JSON получают поле `translation`. В тексте переведённая строка идёт под оригиналом. Блоки SRT и VTT состоят из двух строк: оригинал, затем перевод.
`only`	Перевод заменяет `text`. Таймкоды и говорящие остаются прежними.
`none`	Только исходный транскрипт.

В ответе есть объект translation, а если перевод не заказывали, то null:

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

status равен processing, completed или failed. У неудачного перевода есть также сообщение error. wait дожидается и заказанного перевода; если время ожидания истекло, статус processing. У инструмента MCP get_transcription есть параметр translation с теми же значениями.

Вебхуки

Два события сообщают о результате перевода, помимо неизменных transcription.completed и transcription.failed:

`type`	Отправляется, когда
`transcription.translation.completed`	Заказанный перевод достиг статуса `completed`.
`transcription.translation.failed`	Заказанный перевод достиг статуса `failed`.

data — это объект расшифровки плюс translation: { language, status, error }. Подписи и правила доставки описаны в разделе Webhooks.