预录音转写 /v2

上传文件

POST /v2/upload
Content-Type: application/octet-stream

<音视频二进制>

{"upload_url": "https://cdn.assemblyai.com/upload/..."}

Hub 会记住这个 upload_url 属于哪个账号，之后用它提交转写时自动使用同一账号（AssemblyAI 要求上传与转写在同一项目）。官方限制单文件 2.2 GB；若前面有反向代理，还需放开它的请求体上限。

提交转写

POST /v2/transcript
Content-Type: application/json

{
  "audio_url": "https://cdn.assemblyai.com/upload/...",
  "speech_models": ["universal-3-5-pro", "universal-2"],
  "language_detection": true,
  "speaker_labels": true,
  "keyterms_prompt": ["AssemblyAI", "Universal-3.5"],
  "redact_pii": true,
  "redact_pii_policies": ["phone_number", "credit_card_number", "person_name"],
  "webhook_url": "https://your-app.example.com/hooks/aai",
  "webhook_auth_header_name": "X-Token",
  "webhook_auth_header_value": "secret"
}

• audio_url 可以是 /v2/upload 返回的地址，也可以是任意公网可访问的音视频 URL。
• 响应与官方一致；其中 webhook_url、webhook_auth_header_name 显示的是你自己的回调设置，而不是 Hub 内部使用的地址。
• 未通过 Hub 上传的 audio_url 会分配给账号池中的任意账号，失败时自动换号。

模型

值	说明
universal-3-5-pro	当前最佳模型，支持 18 种语言（含中文），支持 prompt、temperature 等
universal-2	支持 99 种语言

不传 speech_models 时由 AssemblyAI 决定（当前默认先用 Universal-3.5 Pro，不支持的语言回退 Universal-2）。实际使用的模型见响应里的 speech_model_used。

查询与删除

GET    /v2/transcript/{id}
DELETE /v2/transcript/{id}

请求会发往创建该转写的账号。GET 的响应额外包含 webhook_status_code：Hub 最近一次转发回调给你时收到的状态码。

Hub 没有记录的 id（不是经 Hub 创建的）返回 404 {"detail": {"error": "Transcript not found"}}。

列表

GET /v2/transcript?limit=10&status=completed&before_id=<id>&after_id=<id>

返回经 Hub 创建的转写（来自 Hub 数据库，跨所有账号合并），格式与官方相同：

{
  "page_details": {"limit": 10, "result_count": 10, "current_url": "...", "prev_url": "...", "next_url": null},
  "transcripts": [{"id": "...", "resource_url": "...", "status": "completed", "created": "...", "completed": "...", "audio_url": "...", "error": null}]
}

limit 最大 200。用 prev_url 翻到更早的一页。

导出与检索

GET /v2/transcript/{id}/sentences
GET /v2/transcript/{id}/paragraphs
GET /v2/transcript/{id}/srt?chars_per_caption=32
GET /v2/transcript/{id}/vtt
GET /v2/transcript/{id}/word-search?words=价格,price
GET /v2/transcript/{id}/redacted-audio

全部发往创建该转写的账号，参数与响应和官方一致。/v2/transcript/{id}/ 下 AssemblyAI 以后新增的子路径也会自动转发。

其它 /v2 接口

Hub 未单独处理的 /v2/* 路径会原样转发给账号池中的任意账号。