Быстрый старт

Три запроса превращают ссылку на видео в файл транскрипта. Вам нужен API-ключ: создайте его на странице API-ключей. Ключ показывается один раз. Каждый аккаунт получает 50 бесплатных кредитов каждый месяц.

1. Отправьте ссылку#

mode: "captions_only" возвращает субтитры видео за 1 кредит и работает на каждом тарифе, включая пробный. На платном тарифе отправьте mode: "auto", чтобы при отсутствии субтитров переходить на ИИ-транскрипцию (2 кредита за каждую начатую минуту). В качестве Idempotency-Key подойдёт любая строка длиной от 8 до 128 символов, которую вы выбираете. Повторная отправка с тем же ключом возвращает ту же задачу, а не создаёт вторую.

curl -X POST https://www.transcriptdock.com/v1/jobs \
  -H "Authorization: Bearer td_live_YOUR_KEY" \
  -H "Idempotency-Key: my-first-job" \
  -H "Content-Type: application/json" \
  -d '{ "source": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, "mode": "captions_only" }'

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "queued",
  "stage": "resolve",
  "result_id": null,
  "error": null,
  "billing": { "credits_reserved": 1, "credits_charged": 0, "kind": "captions" },
  "source": { "platform": "youtube", "media_id": "dQw4w9WgXcQ", "canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": null, "upload_id": null },
  "options": { "mode": "captions_only", "language": null, "caption_preference": "prefer_creator" },
  "created_at": "2026-09-16T10:00:00.000Z"
}

2. Дождитесь результата#

?wait=25 удерживает запрос до 25 секунд и возвращает ответ, как только задача завершится. Субтитры обычно готовы за несколько секунд, ИИ-транскрипция занимает примерно четверть длины видео. Если status всё ещё не succeeded, failed или cancelled, повторите запрос.

curl "https://www.transcriptdock.com/v1/jobs/11111111-1111-4111-8111-111111111111?wait=25" \
  -H "Authorization: Bearer td_live_YOUR_KEY"

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "succeeded",
  "stage": null,
  "result_id": "22222222-2222-4222-8222-222222222222",
  "error": null,
  "billing": { "credits_reserved": 0, "credits_charged": 1, "kind": "captions" },
  "source": { "platform": "youtube", "media_id": "dQw4w9WgXcQ", "canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": null, "upload_id": null },
  "options": { "mode": "captions_only", "language": null, "caption_preference": "prefer_creator" },
  "created_at": "2026-09-16T10:00:00.000Z"
}

3. Получите транскрипт#

result_id указывает на транскрипт. Экспортируйте его как txt, srt, vtt или json (полный текст, сегменты с таймингами, а для ИИ-транскрипции также тайминги по словам). Экспорт бесплатный и без ограничений.

curl "https://www.transcriptdock.com/v1/transcripts/22222222-2222-4222-8222-222222222222/export?format=srt" \
  -H "Authorization: Bearer td_live_YOUR_KEY"

1
00:00:00,000 --> 00:00:02,400
Добро пожаловать на канал
 
2
00:00:02,400 --> 00:00:04,900
Сегодня мы разберём субтитры

Что дальше#

• Повторная отправка той же ссылки бесплатна: возвращается сохранённый результат.
• Много видео сразу: пакеты, до размера пакета вашего тарифа в одном запросе.
• Свои файлы: загрузки.
• Без опроса: вебхуки отправят вам уведомление, когда задача завершится.
• Из Claude, Cursor или другого ИИ-агента: MCP.