开始使用

快速开始

提交链接，等待任务完成，导出文稿。只需三个请求。

更新于 2026年10月9日

三个请求，就能把一个视频链接变成文稿文件。你需要一个 API 密钥：在 API 密钥页面创建。密钥只显示一次。每个账户每月都有 50 个免费点数。

1. 提交链接#

mode: "captions_only" 会以 1 个点数返回视频自带的字幕，所有套餐都可以使用，包括免费试用。在付费套餐中，发送 mode: "auto"，当视频没有字幕时会改用 AI 转录（按已开始的分钟数计费，每分钟 2 个点数）。Idempotency-Key 可以是你自己选择的、长度为 8 到 128 个字符的任意字符串；再次发送同一个 Idempotency-Key，会返回同一个任务，而不会创建第二个。

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

202 响应

{
  "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 秒，任务一完成就立即返回。字幕通常只需几秒；AI 转录大约需要视频时长的四分之一。如果 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"

200 响应

{
  "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（完整文本、带时间的分段，AI 转录还包含逐词时间）。导出免费，且不限次数。

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