# 创建语音妙记任务

提交可公网访问的录音/录像 URL，立即返回任务 ID。用 `GET /v1/audio/minutes/{taskId}` 轮询（建议间隔 ≥30 秒）。

**仅中国站。** 两条模型共用同一接口，换 `model` 即可。

- `xrtoken-minutes`（会议纪要）：录音文件识别 2.0 + DeepSeek V4 Flash 总结。只需 `model` + `file_url`。默认返回转写、全文总结、章节（每句带说话人编号）。`features` / `all_activate` 不生效。识别按时长计费，总结按 Flash token，价格见模型市场。
- `doubao-minutes`（豆包语音妙记）：火山官方妙记。转写必开，且至少再开一项附加能力，或 `all_activate=true` 打包全部（总结/章节/待办/问答/翻译）。按时长计费，价格见模型市场。

`file_url` 须 http(s)，上游要能拉到（可用 `POST /v1/files` 上传后用返回的 URL）。文件 < 1GB、时长 ≤ 2 小时。提交时预冻，成功按实际时长/token 结算，失败退还。

## POST /v1/audio/minutes

> 创建语音妙记任务

提交可公网访问的录音/录像 URL，立即返回任务 ID。用 `GET /v1/audio/minutes/{taskId}` 轮询（建议间隔 ≥30 秒）。

**仅中国站。** 两条模型共用同一接口，换 `model` 即可。

- `xrtoken-minutes`（会议纪要）：录音文件识别 2.0 + DeepSeek V4 Flash 总结。只需 `model` + `file_url`。默认返回转写、全文总结、章节（每句带说话人编号）。`features` / `all_activate` 不生效。识别按时长计费，总结按 Flash token，价格见模型市场。
- `doubao-minutes`（豆包语音妙记）：火山官方妙记。转写必开，且至少再开一项附加能力，或 `all_activate=true` 打包全部（总结/章节/待办/问答/翻译）。按时长计费，价格见模型市场。

`file_url` 须 http(s)，上游要能拉到（可用 `POST /v1/files` 上传后用返回的 URL）。文件 < 1GB、时长 ≤ 2 小时。提交时预冻，成功按实际时长/token 结算，失败退还。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  妙记模型 ID。`doubao-minutes`（官方妙记）或 `xrtoken-minutes`（识别 2.0 + Flash 总结）
- **file_url** `string` **(required)**  
  可公网访问的音频或视频 URL（< 1GB，时长 ≤ 2 小时）
- **file_type** ``audio` | `video``  
  不传则按 URL 后缀推断
- **source_lang** ``zh_cn` | `en_us`` (default: `zh_cn`)  
  
- **all_activate** `boolean` (default: `false`)  
  仅 doubao-minutes。true 时开启全部附加能力。xrtoken-minutes 忽略此字段。
- **speaker_identification** `boolean` (default: `true`)  
  说话人分离。`xrtoken-minutes` 默认开启且不可关。
- **number_of_speakers** `integer` (default: `0`)  
  0 表示算法自动识别
- **hot_words** `string`  
  
- **need_word_time_series** `boolean` (default: `false`)  
  
- **features** `object`  
  仅 `doubao-minutes` 的附加能力。`all_activate` 不为 true 时至少开一项。`xrtoken-minutes` 忽略此字段，默认出总结和章节。
- **features.summary** `boolean`  
  全文总结
- **features.chapters** `boolean`  
  章节总结
- **features.todos** `boolean`  
  待办提取
- **features.qa** `boolean`  
  问答提取
- **features.translate** `boolean`  
  中英互译
- **features.target_lang** ``zh_cn` | `en_us``  
  翻译目标语言，开启 translate 时使用

### Response

- **id** `string` **(required)**  
  
- **request_id** `string`  
  
- **model** `string` **(required)**  
  
- **status** ``processing`` **(required)**  
  
- **created_at** `string` **(required)**  
  

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: 
- `502`: