AI纪要
更新时间：2025-12-05
1.AI纪要创建接口
概述
用户可将待转写的音频文件 URL 作为输入，通过该接口发起创建 AI 纪要生成的任务，实现音频内容自动转写与总结。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/media_insight/task_create |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | 请求签名(Bearer |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| media_url | str | 是 | 音视频外部下载链接url，这个url是可以直接下载视频的，不能是播放url |
| language | str | 否 | 语种类型： 如果不传语种，会自动识别语种进行转写（支持中英日韩） zh：中文 en：英文 zh-en：中英文 yueyu：粤语 jp：日语 ko：韩语 zh_tianjing: 天津话 zh_hebei:河北话 zh_dongbei:东北话 zh_gansu:甘肃话 zh_shandong:山东话 zh_taiyuan:太原话 |
| task_key | str | 否 | 用户设置的自定义标识，用以关联本任务 |
| ai_outline_enable | bool | 否 | 是否启用 AI 纪要 |
| ai_neat_enable | bool | 否 | 是否启用篇章规整 目前仅支持中文、英文篇章规整 |
| hotword_words | []string | 否 | 普通热词，有以下注意项 1.仅限输入中英文（数字仅支持大写汉字，不支持阿拉伯数字； 2.不支持其他符号） words 和 contacts最多支持200个热词 每个中文词汇最多1-8个字； 3.每个中英文单词或词组最多1-8个字符；每个英文单词或英文词组最多1-16个字符 |
| hotword_contacts | []string | 否 | 人名热词 注意项同hotword_words |
| role_num | int | 否 | 备注：日语、韩语不支持声纹 0：不区分声纹 1：区分声纹 |
| ai_outline_module_names | []string | 否 | 如果AI 纪要开启，该字段必填 开启纪要功能时，需传入期望的纪要模块类型。 basicInfo：基础信息 realRecord：基础实录 fullSummary：全文总结 segmentedSummary：分段摘要 courseSummary：课程摘要 segmentedSummaryKP：分段知识点总结 mdSegmentedSummary：markdown分段摘要 dispute：纠纷 decision：决议 todo：待办 keyData：关键数据 industryFinancial：金融信息 qaRealRecord：问答实录 |
请求示例
Plain Text
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/media_insight/task_create \
3 --header 'Authorization: Bearer xxxxxxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "media_url": "https://www.youtube.com/watch?v=kNusX-7Nhm0",
7 "ai_outline_enable": true,
8 "ai_neat_enable": true,
9 "ai_outline_module_names": [
10 "basicInfo",
11 "fullSummary"
12 ]
13}'响应参数
正确响应
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| errno | int | 是 | 成功的 |
| requestId | str | 是 | 请求ID |
| show_msg | str | 是 | 异常信息 |
| server_time | int | 是 | 服务器时间秒 |
| data | |||
| data.task_id | string | 是 | 任务ID |
| data.task_key | string | 是 | 跟用户输入的task_key一致，用来标识用户的 |
响应示例
Plain Text
1{
2 "data": {
3 "task_id": "2f1fea3a46854a65b68ad80ad60e8e7b",
4 "task_key": "用户自定义标识"
5 },
6 "errno": 0,
7 "newno": "",
8 "requestId": "",
9 "server_time": 1762942516,
10 "show_msg": ""
11}异常响应
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| requestId | str | 是 | 请求ID |
| code | str | 否 | 0 表示成功，其他都是异常 |
| message | str | 否 | 错误消息 |
| detail | 否 | 异常详情信息 |
二、任务查询接口
概述
用户可使用创建任务接口返回的 task_id，通过本接口查询 AI 纪要任务的处理进度与最终结果，实现转写内容的获取。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/media_insight/task_query |
|---|---|
| Method | GET |
Headers
| 字段 | 值 |
|---|---|
| Authorization | 请求签名(Bearer |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数定义
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| task_id | string | 否 | 任务ID |
请求示例
Plain Text
1curl --request GET \
2 --url https://qianfan.baidubce.com/v2/tools/media_insight/task_query?task_id=2f1fea3a46854a65b68ad80ad60e8e7b响应体定义
成功返回响应体
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| errno | int | 是 | 成功的 |
| requestId | str | 是 | 请求ID |
| show_msg | str | 是 | 异常信息 |
| server_time | int | 是 | 服务器时间秒 |
| data | Result | 是 | 任务实际查询结果数据 |
Result定义
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务ID |
| task_key | string | 是 | 用户请求时填入的标识用户的字段 |
| task_type_detail | struct | 是 | 任务类型说明 |
| +ai_outline_enable | bool | 是 | 是否启用 AI 纪要 |
| +translation_enable | bool | 是 | 是否启用翻译 |
| +ai_neat_enable | bool | 是 | 是否启用篇章规整 |
| duration | int | 是 | 音频时长（单位秒） |
| download_status | int | 是 | 100：下载任务已提交 200：下载进行中 300：下载已完成 301：下载不支持 400：下载失败 |
| error_code | int | 是 | 下载失败错误码，0表示成功，其他失败 |
| error_message | string | 是 | 下载失败错误信息 |
| transcription | struct | 否 | 转写结果 |
| +transcription_script | string | 否 | 转写结果 json格式文件下载链接：xxx.json |
| +transcription_srt | string | 否 | 转写字幕 srt 格式文件下载链接：xxx.srt |
| +status | int | 否 | 100：任务已提交 200：任务进行中 300：任务已完成 301：任务不支持 400：任务失败 |
| +error_code | int | 否 | 转写失败错误码 |
| +error_message | string | 否 | 转写失败错误信息 |
| ai_neat | struct | 否 | 篇章规整结果 |
| +status | int | 否 | 100：任务已提交 200：任务进行中 300：任务已完成 301：任务不支持 400：任务失败 |
| +result | string | 否 | 纪要模块下载链接 xxx.json |
| +error_code | int | 否 | 篇章规整错误码 |
| +error_message | string | 否 | 篇章规整错误信息 |
| ai_outline | []struct | 否 | AI纪要结果 |
| +module_name | string | 否 | 纪要模块名称 |
| +status | int | 100：任务已提交 200：任务进行中 300：任务已完成 301：任务不支持 400：任务失败 |
|
| +result | string | 否 | 纪要模块下载链接 xxx.json |
| +error_code | int | 否 | 纪要生成错误码 |
| +error_message | string | 否 | 纪要生成错误信息 |
响应示例
Plain Text
1{
2 "data": {
3 "ai_neat": null,
4 "ai_outline": [],
5 "download_status": 300,
6 "duration": 178,
7 "error_code": 0,
8 "error_message": "",
9 "task_id": "2f1fea3a46854a65b68ad80ad60e8e7b",
10 "task_key": "2f1fea3a46854a65b68ad80ad60e8e7b",
11 "task_type_detail": {
12 "ai_neat_enable": false,
13 "ai_outline_enable": false,
14 "translation_enable": false
15 },
16 "transcription": {
17 "error_code": 0,
18 "error_message": "",
19 "status": 300,
20 "transcription_script": "https://allall02.baidupcs.com/file/20251112/20251112181953-c56a3cc657e74c3f874d58f2e29ee79e_transcribe.json?bkt=en-85a9dbd70d2e7960614b0e94cf370520b7da09198b070b8d&fid=282335-250528-&time=1762945200&sign=FDTAXUVGEQlBHSKfWqij-GBWOGYTBgG0KqHy7wNbwoLTVMyJyK6xE-rsNBQ1DbJ2haJ8htH9CTmM%2BbGV8%3D&to=80&size=199&sta_dx=199&sta_cs=0&sta_ft=json&sta_ct=7&sta_mt=7&fm2=MH%2CBaoding%2CAnywhere%2C%2Cdefault%2Cany&ctime=0&mtime=0&dt3=0&resv0=-1&resv1=0&resv2=rlim&resv3=5&resv4=199&vuk=0&iv=2&vl=0&htype=&randtype=&newver=1&newfm=1&secfm=1&flow_ver=3&pkey=en-6a45ce385b8d0546118235e94a1bf8368bd59569fbea94978dec1387e6cd02d0fd5d604ae7346102d3793b1770c05316392aba995776461a305a5e1275657320&expires=8h&r=976795588&vbdid=-&fin=20251112%2F20251112181953-c56a3cc657e74c3f874d58f2e29ee79e_transcribe.json&rtype=1&dp-logid=406571327960346841&dp-callid=0.1&hps=1&tsl=0&csl=0&fsl=-1&csign=dmayhhcqdS1jXSxjkf6DN1P7N8o%3D&so=0&ut=1&uter=0&serv=-1&uc=0&ti=718800a01e5121ca56afef5411c6cb25734c62c70c544c6e305a5e1275657320&hflag=30&from_type=&adg=n&reqlabel=250528_n_e89c05d66b5a8215a7e0ce3c5d4730ed_0_11f5b66f73d6eea6432d081708696753&chkv=5&bid=mediainsight&by=themis",
21 "transcription_srt": "https://allall02.baidupcs.com/file/20251112/20251112181953-c56a3cc657e74c3f874d58f2e29ee79e_transcribe.srt?bkt=en-85a9dbd70d2e7960614b0e94cf370520b7da09198b070b8d&fid=282335-250528-&time=1762945200&sign=FDTAXUVGEQlBHSKfWqij-GBWOGYTBgG0KqHy7wNbwoLTVMyJyK6xE-qpgevbU2fRZmJFk%2B7HKL73fXlDo%3D&to=80&size=199&sta_dx=199&sta_cs=0&sta_ft=srt&sta_ct=7&sta_mt=7&fm2=MH%2CYangquan%2CAnywhere%2C%2Cdefault%2Cany&ctime=0&mtime=0&dt3=0&resv0=-1&resv1=0&resv2=rlim&resv3=5&resv4=199&vuk=0&iv=2&vl=0&htype=&randtype=&newver=1&newfm=1&secfm=1&flow_ver=3&pkey=en-36f3a117c61b76810a61202fe895e3e864708c9543d335a2c518e7b2a424cbec13418a5e169c730689987498d537f6665594529d8246fea0305a5e1275657320&expires=8h&r=810010257&vbdid=-&fin=20251112%2F20251112181953-c56a3cc657e74c3f874d58f2e29ee79e_transcribe.srt&rtype=1&dp-logid=406571327960346841&dp-callid=0.1&hps=1&tsl=0&csl=0&fsl=-1&csign=dmayhhcqdS1jXSxjkf6DN1P7N8o%3D&so=0&ut=1&uter=0&serv=-1&uc=0&ti=3612dd02eb4608abf77ac7c27968e41f9bce4b5cebfbc831&hflag=30&from_type=&adg=n&reqlabel=250528_n_e89c05d66b5a8215a7e0ce3c5d4730ed_0_11f5b66f73d6eea6432d081708696753&chkv=5&bid=mediainsight&by=themis"
22 }
23 },
24 "errno": 0,
25 "newno": "",
26 "requestId": "",
27 "server_time": 1762945200,
28 "show_msg": ""
29}异常响应
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| requestId | str | 是 | 请求ID |
| code | str | 否 | 0 表示成功，其他都是异常 |
| message | str | 否 | 错误消息 |
| detail | 否 | 异常详情信息 |