{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/4mwbl4y07","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
POST
\n
\nhttps://qianfan.baidubce.com/v2/tools/media_insight/task_create\n
\n
\n
\n

本接口用于将待转写的音频文件 URL 作为输入，通过该接口发起创建 AI 纪要生成的任务，实现音频内容自动转写与总结。

\n
\n
\n

权限说明

\n

调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\nmedia_url\n\nstring\n
\n

音视频外部下载链接URL

\n
\n
可选
\n
\n
\n
\n\nlanguage\n\nstring\n
\n

语种类型： 如果不传语种，会自动识别语种进行转写（支持中英日韩）
zh：中文
en：英文
zh-en：中英文
yueyu：粤语
jp：日语
ko：韩语
zh_tianjing: 天津话
zh_hebei:河北话
zh_dongbei:东北话
zh_gansu:甘肃话
zh_shandong:山东话
zh_taiyuan:太原话

\n
\n
可选
\n
\n
\n
\n\ntask_key\n\nstring\n
\n

用户设置的自定义标识，用以关联本任务

\n
\n
可选
\n
\n
\n
\n\nai_outline_enable\n\nboolean\n
\n

是否启用 AI 纪要

\n
\n
可选
\n
\n
\n
\n\nai_neat_enable\n\nboolean\n
\n

是否启用篇章规整，目前仅支持中文、英文篇章规整

\n
\n
可选
\n
\n
\n
\n\nhotword_words\n\narray\n
\n

普通热词，有以下注意项
1.仅限输入中英文（数字仅支持大写汉字，不支持阿拉伯数字；
2.不支持其他符号） words 和 contacts最多支持200个热词 每个中文词汇最多1-8个字；
3.每个中英文单词或词组最多1-8个字符；每个英文单词或英文词组最多1-16个字符

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nstring\n
\n
\n
\n
\n
\n
\n
\n
\n\nhotword_contacts\n\narray\n
\n

人名热词，注意项同hotword_words

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nstring\n
\n
\n
\n
\n
\n
\n
\n
\n\nrole_num\n\ninteger\n
\n

备注：日语、韩语不支持声纹
0：不区分声纹
1：区分声纹

\n
\n
可选
\n
\n
\n
\n\nai_outline_module_names\n\narray\n
\n

如果AI 纪要开启，该字段必填
开启纪要功能时，需传入期望的纪要模块类型。
basicInfo：基础信息
realRecord：基础实录
fullSummary：全文总结
segmentedSummary：分段摘要
courseSummary：课程摘要
segmentedSummaryKP：分段知识点总结
mdSegmentedSummary：markdown分段摘要
dispute：纠纷
decision：决议
todo：待办
keyData：关键数据
industryFinancial：金融信息
qaRealRecord：问答实录

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nstring\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST /v2/tools/media_insight/task_create HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: Bearer <API Key>\nContent-Type: application/json\n\n{\n  \"media_url\": \"https://www.youtube.com/watch?v=kNusX-7Nhm0\",\n  \"language\": \"zh\",\n  \"task_key\": \"\",\n  \"ai_outline_enable\": true,\n  \"ai_neat_enable\": true,\n  \"hotword_words\": [\n    \"\"\n  ],\n  \"hotword_contacts\": [\n    \"\"\n  ],\n  \"role_num\": 0,\n  \"ai_outline_module_names\": [\n    \"basicInfo\",\n    \"fullSummary\"\n  ]\n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
curl
\n\n
\n
\n\n
\n
curl -X POST \"https://qianfan.baidubce.com/v2/tools/media_insight/task_create\" \\\n  -H \"Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"media_url\": \"https://www.youtube.com/watch?v=kNusX-7Nhm0\",\n  \"ai_outline_enable\": true,\n  \"ai_neat_enable\": true,\n  \"ai_outline_module_names\": [\n    \"basicInfo\",\n    \"fullSummary\"\n  ]\n}'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\nerrno\n\ninteger\n
\n

成功的

\n
\n
可选
\n
\n
\n
\n\nrequestId\n\nstring\n
\n

请求ID

\n
\n
可选
\n
\n
\n
\n\nshow_msg\n\nstring\n
\n

异常信息

\n
\n
可选
\n
\n
\n
\n\nserver_time\n\ninteger\n
\n

服务器时间秒

\n
\n
可选
\n
\n
\n
\n\ndata\n\nobject {2}\n
\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ntask_id\n\nstring\n
\n

任务ID

\n
\n
可选
\n
\n
\n
\n\ntask_key\n\nstring\n
\n

跟用户输入的task_key一致，用来标识用户的

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
成功响应
\n\n
\n
\n\n
\n
{\n  \"data\": {\n    \"task_id\": \"2f1fea3a46854a65b68ad80ad60e8e7b\",\n    \"task_key\": \"用户自定义标识\"\n  },\n  \"errno\": 0,\n  \"newno\": \"\",\n  \"requestId\": \"\",\n  \"server_time\": 1762942516,\n  \"show_msg\": \"\"\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
","fields":{"slug":"4mwbl4y07","title":"创建AI纪要任务","date":"2026-11-11","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"4mwbl4y07","prev":{"id":"Hmwbl4xyh","name":"查询AI纪要任务","path":"Hmwbl4xyh","filePath":"Agent/组件与工具/实用工具/百度网盘AI纪要/查询AI纪要任务.md","seo":null,"parentIds":["Mmwbl4qxa","fmwbl4qxj","Amwbl4s0l","xmwbl4xy9"],"parents":[{"id":"Mmwbl4qxa","documentId":"14a689a9-e16b-4e40-ba67-9e0a3a66f51e","name":"Agent","repoName":"qianfan-api","filePath":"Agent","disabled":false,"path":"Mmwbl4qxa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"fmwbl4qxj","documentId":"34784fae-a5dc-4489-831c-575783fa4672","name":"组件与工具","repoName":"qianfan-api","filePath":"Agent/组件与工具","disabled":false,"path":"fmwbl4qxj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Amwbl4s0l","documentId":"442eea7a-c358-455f-9c53-866b8baf21d8","name":"实用工具","repoName":"qianfan-api","filePath":"Agent/组件与工具/实用工具","disabled":false,"path":"Amwbl4s0l","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4xy9","documentId":"869a6f66-643a-4bbf-be0c-e4d26507003b","name":"百度网盘AI纪要","repoName":"qianfan-api","filePath":"Agent/组件与工具/实用工具/百度网盘AI纪要","disabled":false,"path":"xmwbl4xy9","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"0mwbl4y1v","name":"百度文库AI绘本","path":"0mwbl4y1v","filePath":"Agent/组件与工具/实用工具/百度文库AI绘本/创建AI绘本任务.md","seo":null,"parentIds":["Mmwbl4qxa","fmwbl4qxj","Amwbl4s0l","9mwbl4y1n"],"parents":[{"id":"Mmwbl4qxa","documentId":"14a689a9-e16b-4e40-ba67-9e0a3a66f51e","name":"Agent","repoName":"qianfan-api","filePath":"Agent","disabled":false,"path":"Mmwbl4qxa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"fmwbl4qxj","documentId":"34784fae-a5dc-4489-831c-575783fa4672","name":"组件与工具","repoName":"qianfan-api","filePath":"Agent/组件与工具","disabled":false,"path":"fmwbl4qxj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Amwbl4s0l","documentId":"442eea7a-c358-455f-9c53-866b8baf21d8","name":"实用工具","repoName":"qianfan-api","filePath":"Agent/组件与工具/实用工具","disabled":false,"path":"Amwbl4s0l","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mwbl4y1n","documentId":"cc82c1bf-dc2e-4b28-9c04-c0e78c63dc2e","name":"百度文库AI绘本","repoName":"qianfan-api","filePath":"Agent/组件与工具/实用工具/百度文库AI绘本","disabled":false,"path":"9mwbl4y1n","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Mmwbl4qxa","documentId":"14a689a9-e16b-4e40-ba67-9e0a3a66f51e","name":"Agent","repoName":"qianfan-api","filePath":"Agent","disabled":false,"path":"Mmwbl4qxa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"fmwbl4qxj","documentId":"34784fae-a5dc-4489-831c-575783fa4672","name":"组件与工具","repoName":"qianfan-api","filePath":"Agent/组件与工具","disabled":false,"path":"fmwbl4qxj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Amwbl4s0l","documentId":"442eea7a-c358-455f-9c53-866b8baf21d8","name":"实用工具","repoName":"qianfan-api","filePath":"Agent/组件与工具/实用工具","disabled":false,"path":"Amwbl4s0l","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4xy9","documentId":"869a6f66-643a-4bbf-be0c-e4d26507003b","name":"百度网盘AI纪要","repoName":"qianfan-api","filePath":"Agent/组件与工具/实用工具/百度网盘AI纪要","disabled":false,"path":"xmwbl4xy9","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}