翻译

transcript1 先转录媒体，再把转录文本翻译成你选择的一种语言。翻译按片段对齐，并保留原始时间戳和说话人。它只翻译文字：没有配音，也没有翻译后的音频。

翻译免费。它使用 0 分钟，在用量记录中显示为免费的“Translation”条目。转录的分钟照常计算，翻译失败既不会让转录文本失败，也不会退还。

转录时同步翻译

在创建转录的请求中加入 translate_to。它是两位小写 ISO 639-1 代码，例如 es 或 en。它适用于 POST /v1/transcriptions JSON 请求体中的视频链接、分块上传预留，以及一次性 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"
}

该调用是幂等的。状态为 processing 或 completed 的翻译会原样返回，failed 的翻译会被重试。MCP 工具 translate_transcription 接受 id 和 language。

读取翻译

GET /v1/transcriptions/:id 以及文本、SRT、VTT 下载都接受 translation：

响应中有 translation 对象；如果没有申请翻译，则为 null：

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

status 为 processing、completed 或 failed。翻译失败时还会有 error 消息。wait 也会等待已申请的翻译；等待超时时，状态为 processing。MCP 的 get_transcription 工具有取值相同的 translation 参数。

Webhook

除了保持不变的 transcription.completed 和 transcription.failed，还有两个事件报告翻译结果：

data 是转录对象加上 translation: { language, status, error }。签名和投递规则见 Webhooks。