{"info":{"_postman_id":"24664fd3-aaf7-40b6-8ce4-144589903011","name":"同合云API","description":"<html><head></head><body><p>同合云引擎围绕内容生成、处理与分发流程，为AI Agent生态提供更易接入的智能创作能力与工作流支持。 默认入口为 <a href=\"https://api.ai-mcn.tv:10000%E3%80%82\">https://api.ai-mcn.tv:10000。</a></p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"12043199","collectionId":"24664fd3-aaf7-40b6-8ce4-144589903011","publishedId":"2sBXiqE952","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-05T14:01:25.000Z"},"item":[{"name":"系统监控","item":[{"name":"健康检查接口","id":"9cf06fc3-3c12-4f92-85c3-1a1d8e7b8792","request":{"method":"GET","header":[],"url":"https://api.ai-mcn.tv:10000/health","description":"<p>健康检查接口\n用于K8s探针或负载均衡器检测服务存活状态</p>\n<p>operationId: <code>healthCheck</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 服务运行正常</li>\n</ul>\n","urlObject":{"path":["health"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9cf06fc3-3c12-4f92-85c3-1a1d8e7b8792"}],"id":"e0fa38c7-99ca-4b86-a2b2-163ab3392e99","_postman_id":"e0fa38c7-99ca-4b86-a2b2-163ab3392e99","description":""},{"name":"文件管理","item":[{"name":"上传文件","id":"90e2401f-2e53-41c7-a6c1-fabeea4732e7","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"<p>目标二进制文件 (支持格式: mp4, mp3, jpg, png等)</p>\n","type":"file","value":""}]},"url":"https://api.ai-mcn.tv:10000/base/file/upload","description":"<p>上传文件\n支持上传音频、图像、视频文件到云存储。\n注意：Content-Type 必须为 multipart/form-data。</p>\n<p>operationId: <code>uploadFile</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 上传成功</li>\n<li>400: 参数错误或文件格式不支持</li>\n<li>401: 鉴权失败</li>\n<li>413: 文件体积超出限制 (Max 20GB)</li>\n<li>500: 服务器内部处理异常</li>\n</ul>\n","urlObject":{"path":["base","file","upload"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"90e2401f-2e53-41c7-a6c1-fabeea4732e7"},{"name":"获取文件详情","id":"d645d55e-7982-47a4-9b11-ce42f4540d31","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/base/file/537489015178246","description":"<p>获取文件详情\n通过文件ID查询文件的元数据信息（大小、下载地址、过期时间等）。</p>\n<p>operationId: <code>getFile</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 文件不存在或已被清理</li>\n<li>500: 服务器内部错误</li>\n</ul>\n","urlObject":{"path":["base","file","537489015178246"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d645d55e-7982-47a4-9b11-ce42f4540d31"},{"name":"创建分片上传会话（大文件断点续传入口）","id":"3fc277f1-d828-4bf0-ac32-ec6bef6071df","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"filename\": \"<string>\",\n  \"size\": 0,\n  \"blake3_id\": \"<string>\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/base/file/upload/chunk/init","description":"<p>创建分片上传会话（大文件断点续传入口）\n声明文件名与总大小，返回会话与分片约定；携带 blake3_id 时命中未过期同内容文件可秒传。</p>\n<p>operationId: <code>chunkUploadInit</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 会话已创建（返回 upload_id / part_size / total_parts / expires_at）， 或秒传命中（返回与单发上传同构的文件信息，附 instant=true）</li>\n<li>400: 参数缺失 / 文件类型不支持 / 大小为 0</li>\n<li>401: 鉴权失败</li>\n<li>413: 声明大小超出限制（Max 20GB）</li>\n</ul>\n","urlObject":{"path":["base","file","upload","chunk","init"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3fc277f1-d828-4bf0-ac32-ec6bef6071df"},{"name":"上传单个分片（幂等，可乱序、可并行、断点重传安全）","id":"b28f4170-6929-4b9c-bb35-6215336e58a0","request":{"method":"PUT","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"\"<string>\"","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/base/file/upload/chunk/{{upload_id}}/{{index}}?blake3=","description":"<p>上传单个分片（幂等，可乱序、可并行、断点重传安全）\n请求体为分片原始字节；分片大小须等于 init 返回的 part_size（末片为余数）。</p>\n<p>operationId: <code>chunkUploadPart</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 已收下该分片（返回 received / total_parts 进度）</li>\n<li>400: 分片序号越界 / 大小不符 / 校验不符</li>\n<li>401: 鉴权失败</li>\n<li>404: 会话不存在或已过期</li>\n</ul>\n","urlObject":{"path":["base","file","upload","chunk","{{upload_id}}","{{index}}"],"host":["https://api.ai-mcn.tv:10000"],"query":[{"description":{"content":"<p>可选。该分片内容的 Blake3，提供则服务端校验，不符不置位</p>\n","type":"text/plain"},"key":"blake3","value":""}],"variable":[]}},"response":[],"_postman_id":"b28f4170-6929-4b9c-bb35-6215336e58a0"},{"name":"查询分片上传会话状态（断点续传依据）","id":"0bd48f7f-0d97-4046-903d-76e5ab5098ec","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/base/file/upload/chunk/{{upload_id}}","description":"<p>查询分片上传会话状态（断点续传依据）\n返回缺失分片序号列表，客户端只需补传缺片后 complete。</p>\n<p>operationId: <code>chunkUploadStatus</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 会话状态（size / part_size / total_parts / received / missing / expires_at）</li>\n<li>401: 鉴权失败</li>\n<li>404: 会话不存在或已过期</li>\n</ul>\n","urlObject":{"path":["base","file","upload","chunk","{{upload_id}}"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"0bd48f7f-0d97-4046-903d-76e5ab5098ec"},{"name":"完成分片上传（校验齐片 → 入库）","id":"e21759c8-d015-49b4-9538-0d53bc90e7a4","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/base/file/upload/chunk/{{upload_id}}/complete","description":"<p>完成分片上传（校验齐片 → 入库）\n与单发上传同一去重、续期、入库语义；响应结构与 POST /base/file/upload 同构。</p>\n<p>operationId: <code>chunkUploadComplete</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 上传完成（返回 file_id / download_url 等，与单发上传同构）</li>\n<li>400: 仍有缺片 / 装配大小与声明不符</li>\n<li>401: 鉴权失败</li>\n<li>404: 会话不存在或已过期</li>\n</ul>\n","urlObject":{"path":["base","file","upload","chunk","{{upload_id}}","complete"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e21759c8-d015-49b4-9538-0d53bc90e7a4"},{"name":"废弃分片上传会话（幂等）","id":"d030df30-adef-44d1-9426-afeda1eae87e","request":{"method":"DELETE","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/base/file/upload/chunk/{{upload_id}}","description":"<p>废弃分片上传会话（幂等）\n删除装配文件与会话状态；重复调用或会话已不存在同样返回成功。</p>\n<p>operationId: <code>chunkUploadAbort</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 已废弃（幂等成功）</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["base","file","upload","chunk","{{upload_id}}"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d030df30-adef-44d1-9426-afeda1eae87e"}],"id":"c5d2eb3d-29fe-4a24-9b25-b157656dfcc7","_postman_id":"c5d2eb3d-29fe-4a24-9b25-b157656dfcc7","description":""},{"name":"用户管理","item":[{"name":"获取用户信息","id":"28f68c0c-86d3-45ec-b9b6-365827027778","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/user/get_user_info","description":"<p>获取用户信息\n查询当前登录用户的详细信息，包括公司、行业、昵称、头像等。</p>\n<p>operationId: <code>getUserInfo</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 用户不存在</li>\n<li>500: 服务器内部错误</li>\n</ul>\n","urlObject":{"path":["user","get_user_info"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"28f68c0c-86d3-45ec-b9b6-365827027778"}],"id":"f4fe6192-0221-4e88-bb7f-87fcef57785e","_postman_id":"f4fe6192-0221-4e88-bb7f-87fcef57785e","description":""},{"name":"任务管理","item":[{"name":"取消任务","id":"cae0784e-8711-455e-b8f0-38f81e14403d","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/537489015178247/cancel","description":"<p>取消任务\n取消指定ID的任务。仅处于 queued 状态的任务可以被取消。</p>\n<p>operationId: <code>cancelTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 取消成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 任务状态不允许取消</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","537489015178247","cancel"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"cae0784e-8711-455e-b8f0-38f81e14403d"},{"name":"获取任务列表","id":"f1d54a09-0779-4702-89db-75bdb6768cfe","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/list?user_id=&status=queued&task_type=&page=1&page_size=20","description":"<p>获取任务列表\n查询任务列表，支持按用户、状态、类型筛选。</p>\n<p>operationId: <code>listTasks</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>500: 服务器内部错误</li>\n</ul>\n","urlObject":{"path":["task","list"],"host":["https://api.ai-mcn.tv:10000"],"query":[{"description":{"content":"<p>用户ID（筛选指定用户的任务）</p>\n","type":"text/plain"},"key":"user_id","value":""},{"description":{"content":"<p>任务状态</p>\n","type":"text/plain"},"key":"status","value":"queued"},{"description":{"content":"<p>任务类型（如 asr, image_purify）</p>\n","type":"text/plain"},"key":"task_type","value":""},{"description":{"content":"<p>页码</p>\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"<p>每页数量</p>\n","type":"text/plain"},"key":"page_size","value":"20"}],"variable":[]}},"response":[],"_postman_id":"f1d54a09-0779-4702-89db-75bdb6768cfe"}],"id":"0e5df9ad-2f49-467e-b714-437f00e8a172","_postman_id":"0e5df9ad-2f49-467e-b714-437f00e8a172","description":""},{"name":"音频处理","item":[{"name":"创建ASR语音转文字任务","id":"b1ba3f75-309a-4c46-8dce-d9463fb13311","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"language\": \"zh-CN\",\n  \"word_level\": false,\n  \"script_text\": \"今天我们聊一聊工程纪律。做完再说。\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/asr","description":"<p>创建ASR语音转文字任务\n将音频文件转换为文字，支持多语言和字级别时间戳；传入 script_text 可按已知稿件做有稿对齐。</p>\n<p>operationId: <code>createAsrTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误。含 6015（不支持的语言代码）—— 传入的 language 不在支持清单内（有稿模式下不在对齐语种内）； 6016 —— script_text 超过 20000 个字符或类型错误。错误信息里会给出可行动的替代码。</li>\n</ul>\n","urlObject":{"path":["task","asr"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b1ba3f75-309a-4c46-8dce-d9463fb13311"},{"name":"查询ASR任务结果","id":"fe4494ad-96db-4378-95b7-bf2b95e91962","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/asr/537489015178247","description":"<p>查询ASR任务结果\n查询语音转文字任务的状态和结果。</p>\n<p>operationId: <code>getAsrTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","asr","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"fe4494ad-96db-4378-95b7-bf2b95e91962"},{"name":"音频语种检测（同步返回，1 积分/次）","id":"de6f71b3-b59e-4827-a869-e3c02a066670","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_language_detect","description":"<p>音频语种检测（同步返回，1 积分/次）\n给一个已上传的音频或视频 <code>file_id</code>，<strong>同步返回</strong>它的语种判定与置信度，无需轮询。\n<strong>只判语种、不产转写</strong>：本能力不返回转写文本、字幕或时码。要转写请用\n<code>/task/asr</code>；要字幕请用 <code>/task/video_ai_subtitle</code>。\n<strong>判据是音频的前 30 秒</strong>（与识别模型的单窗长度一致，超出部分本就不参与判定）。\n解码在取样阶段即截断，因此<strong>耗时与源文件时长无关</strong>——一条 2 小时的视频与一条 30 秒\n的音频代价相同，这也是按次计费的原因。源文件短于 30 秒时照常受理，响应的\n<code>detected_window_sec</code> 会如实回传实际判据时长。\n<strong>置信度要看</strong>：语种判定基于概率分布，对静音、纯音乐与环境噪声也<strong>一定会</strong>给出\n某个语种。请结合 <code>confidence</code> 与 <code>candidates</code> 自行判断，服务端不代为设阈值。\n中文与粤语、西语与葡语、印尼语与马来语是已知的易混组，<code>candidates</code> 就是为它们准备的。\n<strong>语种码认不出时 <code>language</code> 为 null</strong>：模型识别出的语种不在平台语种表内时（例如泰语），\n<code>language</code> 返回 null、<code>raw_language</code> 返回模型原始码，绝不回退成某个缺省语种。\n注意：识别模型按需加载 + 空闲逐出，<strong>逐出后的首个请求可能慢</strong>（分钟级冷启动），\n客户端超时请设 ≥180s。模型正忙（有长任务占用）时返回 6402，稍后重试即可。\n鉴权：Authorization 头直传 API Key。</p>\n<p>operationId: <code>createAudioLanguageDetectTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 检测成功（响应携 task_id 计费留痕）</li>\n<li>400: 参数错误；或输入文件没有可用音频流（错误码 6016）</li>\n<li>401: 鉴权失败</li>\n<li>402: 余额/配额不足（前置拒绝，不触上游、不扣费）</li>\n<li>404: file_id 文件不存在或不属于当前用户</li>\n<li>6401: 上游识别服务不可用（不扣费）</li>\n<li>6402: 上游超时或模型正忙（不扣费）。识别模型同一时刻只服务一个任务， 有长任务占用时本接口会快速失败，稍后重试即可</li>\n</ul>\n","urlObject":{"path":["task","audio_language_detect"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"de6f71b3-b59e-4827-a869-e3c02a066670"},{"name":"创建音乐分析与打标任务","id":"8eaf7105-89c2-4559-96a4-024357ab0dbd","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"enable_semantic_tags\": false,\n  \"language\": \"zh-CN\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_music_analyze","description":"<p>创建音乐分析与打标任务\n对音频做结构化音乐分析。硬指标层（BPM、调性、节拍/鼓点、段落、主副歌、高潮点）本地计算必出；\n软语义层（曲风/情绪/乐器/描述/标签云）可选开启，默认关闭。</p>\n<p>operationId: <code>createAudioMusicAnalyzeTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","audio_music_analyze"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"8eaf7105-89c2-4559-96a4-024357ab0dbd"},{"name":"查询音乐分析与打标任务结果","id":"ec473c3e-ef07-4510-8f41-d1dd9367892c","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_music_analyze/537489015178247","description":"<p>查询音乐分析与打标任务结果\n查询任务的执行状态和分析结果。</p>\n<p>operationId: <code>getAudioMusicAnalyzeTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_music_analyze","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"ec473c3e-ef07-4510-8f41-d1dd9367892c"},{"name":"创建音频降噪任务","id":"e50369b9-f347-4051-89b6-af4d172f3927","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"prop_decrease\": 0.8\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_noise_reduce","description":"<p>创建音频降噪任务\n对音频进行降噪处理，降低背景噪声，提升人声清晰度。</p>\n<p>operationId: <code>createAudioNoiseReduceTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","audio_noise_reduce"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e50369b9-f347-4051-89b6-af4d172f3927"},{"name":"查询音频降噪任务结果","id":"268b155e-a73c-4729-ae33-dd98e6274890","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_noise_reduce/537489015178247","description":"<p>查询音频降噪任务结果\n查询音频降噪任务的状态和结果。</p>\n<p>operationId: <code>getAudioNoiseReduceTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_noise_reduce","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"268b155e-a73c-4729-ae33-dd98e6274890"},{"name":"创建人声伴奏分离任务","id":"1dcc2c70-c63e-4515-a96d-5162d52adedb","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"mode\": \"fast\",\n  \"need_vocals\": true,\n  \"need_instrumental\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_separation","description":"<p>创建人声伴奏分离任务\n将音频中的人声与伴奏分离，输出独立音轨。支持 fast / turbo 两种分离模式。</p>\n<p>operationId: <code>createAudioSeparationTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","audio_separation"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"1dcc2c70-c63e-4515-a96d-5162d52adedb"},{"name":"查询人声伴奏分离任务结果","id":"3cb3394c-8835-45c6-8f4e-f064697e6c76","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_separation/537489015178247","description":"<p>查询人声伴奏分离任务结果\n查询任务的执行状态和分离结果。</p>\n<p>operationId: <code>getAudioSeparationTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_separation","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3cb3394c-8835-45c6-8f4e-f064697e6c76"},{"name":"创建静音片段移除任务","id":"3516725d-0d10-4bff-a846-a67e09379a7a","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"min_silence_len\": 1500,\n  \"desired_silence_len\": 1500\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_silence_remove","description":"<p>创建静音片段移除任务\n移除音频中的静音片段，并可在非静音片段之间保留指定长度的静音，使音频更加紧凑流畅。</p>\n<p>operationId: <code>createAudioSilenceRemoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","audio_silence_remove"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3516725d-0d10-4bff-a846-a67e09379a7a"},{"name":"查询静音片段移除任务结果","id":"4f5ab435-4b1f-49ce-aa14-7bf7e6010bd0","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_silence_remove/537489015178247","description":"<p>查询静音片段移除任务结果\n查询静音移除任务的状态和结果。</p>\n<p>operationId: <code>getAudioSilenceRemoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_silence_remove","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4f5ab435-4b1f-49ce-aa14-7bf7e6010bd0"},{"name":"创建音频人声归档任务","id":"8b05b178-12fb-4d9d-b5ff-5f366d6eeb95","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"only_struct\": true,\n  \"keep_origin_length\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_speaker_split","description":"<p>创建音频人声归档任务\n根据说话人信息将音频切片合并为多条单说话人的独立音轨文件。</p>\n<p>operationId: <code>createAudioSpeakerSplitTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","audio_speaker_split"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"8b05b178-12fb-4d9d-b5ff-5f366d6eeb95"},{"name":"查询音频人声归档任务结果","id":"00a6fb2a-08ca-4d62-80b8-061b514df0f1","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_speaker_split/537489015178247","description":"<p>查询音频人声归档任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getAudioSpeakerSplitTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_speaker_split","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"00a6fb2a-08ca-4d62-80b8-061b514df0f1"},{"name":"创建音频变调变速任务","id":"e924bd03-8e29-4770-af4d-7fe89ff51622","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"semitones\": 2.0,\n  \"speed\": 1.5\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_stretch","description":"<p>创建音频变调变速任务\n调整音频的音高与播放速度，二者相互独立：改速度不影响音高、改音高不影响时长。\n基于高质量算法处理，变调时自动保留音色（不会出现\"花栗鼠\"声）。</p>\n<p>operationId: <code>createAudioStretchTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","audio_stretch"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e924bd03-8e29-4770-af4d-7fe89ff51622"},{"name":"查询音频变调变速任务结果","id":"d5bd2a3e-899a-4340-962b-2651139bfdf5","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_stretch/537489015178247","description":"<p>查询音频变调变速任务结果\n查询音频变调变速任务的状态和结果。</p>\n<p>operationId: <code>getAudioStretchTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_stretch","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d5bd2a3e-899a-4340-962b-2651139bfdf5"},{"name":"创建声音克隆配音任务","id":"3d159aa5-0a33-4504-b90a-235985c95bb1","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"text\": \"你好，欢迎收听本期节目。\",\n  \"speaker\": \"narrator\",\n  \"text_lang\": \"zh-CN\",\n  \"output_format\": \"wav\",\n  \"speed\": 1.0,\n  \"refresh\": false,\n  \"text_split_method\": \"cut1\",\n  \"fragment_interval\": 0.2,\n  \"subtitle_format\": \"srt\",\n  \"canvas\": [\n    1080,\n    1920\n  ],\n  \"strip_punctuation\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_tts_clone","description":"<p>创建声音克隆配音任务\n输入文本与艺人(speaker)，生成该艺人音色的配音音频。无需上传文件。\n按文本字符数计费（measure=千字符）：计费单位数 = 字符数 ÷ 1000。\n字符数按 Unicode 码点计——一个中日韩字符算 1 个字符，与英文字母、数字、标点同等计量；\n文本首尾空白不计，中间的空格与换行各计 1。</p>\n<p>operationId: <code>createAudioTtsCloneTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["task","audio_tts_clone"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d159aa5-0a33-4504-b90a-235985c95bb1"},{"name":"查询声音克隆配音任务结果","id":"0d6fadf1-15b2-4e61-a3d9-0d53e5a06951","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_tts_clone/537489015178247","description":"<p>查询声音克隆配音任务结果</p>\n<p>operationId: <code>getAudioTtsCloneTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","audio_tts_clone","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"0d6fadf1-15b2-4e61-a3d9-0d53e5a06951"},{"name":"创建零样本音色配音任务","id":"21fe7ad5-6103-49f1-b23a-92aa6008d018","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"text\": \"你好，欢迎收听本期节目。\",\n  \"ref_file_id\": \"537489015178246\",\n  \"ref_text\": \"大家好，欢迎收看今天的节目。\",\n  \"ref_lang\": \"zh-CN\",\n  \"text_lang\": \"zh-CN\",\n  \"output_format\": \"wav\",\n  \"speed\": 1.0,\n  \"fragment_interval\": 0.2,\n  \"subtitle_format\": \"srt\",\n  \"canvas\": [\n    1080,\n    1920\n  ],\n  \"strip_punctuation\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/audio_tts_zero_shot","description":"<p>创建零样本音色配音任务\n上传一段参考音频（或含人声的视频）与一段文本，用参考中说话人的音色合成这段文本的配音。\n服务端会从参考媒体里自动选出 3–10 秒的干净单人声段作为克隆参考（含背景音乐时先分离人声），\n并在产物 report.ref 里如实报告选用了哪一段。零样本克隆的相似度受参考质量影响较大，\n参考尽量选清晰、无混响、单人说话的片段。\n按文本字符数计费（measure=千字符）：计费单位数 = 字符数 ÷ 1000，口径与声音克隆配音一致；\n参考媒体的时长不参与计费。</p>\n<p>operationId: <code>createAudioTtsZeroShotTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误（含语种越界、语速越界、参考媒体过短或过长）</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n<li>404: 参考文件不存在</li>\n</ul>\n","urlObject":{"path":["task","audio_tts_zero_shot"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"21fe7ad5-6103-49f1-b23a-92aa6008d018"},{"name":"查询零样本音色配音任务结果","id":"1a55c128-540a-4cdb-8e6f-7bb1c7d91213","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/audio_tts_zero_shot/537489015178247","description":"<p>查询零样本音色配音任务结果\n产物形状与声音克隆配音一致（音频、句级时码 segments、可选字幕），另含 report.ref 说明本次选用的参考段。</p>\n<p>operationId: <code>getAudioTtsZeroShotTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","audio_tts_zero_shot","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"1a55c128-540a-4cdb-8e6f-7bb1c7d91213"},{"name":"创建音乐可视化任务","id":"12033061-cbc6-4659-98ab-7821b36865a3","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"template_id\": \"aurora\",\n  \"background_file_id\": \"<string>\",\n  \"cover_file_id\": \"<string>\",\n  \"track\": \"<string>\",\n  \"artist\": \"<string>\",\n  \"resolution\": {},\n  \"fps\": 0,\n  \"c1\": \"<string>\",\n  \"c2\": \"<string>\",\n  \"blur\": 0\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/music_visualizer","description":"<p>创建音乐可视化任务\n音频(主导输入) + 模板，渲染为音乐可视化成片 mp4。可选封面图 / 底图背景(图或视频) / 曲名歌手 / 分辨率 / 帧率 /\n频谱配色(单色或双色渐变) / 背景模糊。按音频时长(分钟)计费。</p>\n<p>operationId: <code>createMusicVisualizerTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["task","music_visualizer"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"12033061-cbc6-4659-98ab-7821b36865a3"},{"name":"查询音乐可视化任务结果","id":"58e5254e-35c0-4360-9e34-410da72df744","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/music_visualizer/537489015178247","description":"<p>查询音乐可视化任务结果</p>\n<p>operationId: <code>getMusicVisualizerTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","music_visualizer","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"58e5254e-35c0-4360-9e34-410da72df744"},{"name":"创建钢琴歌曲修复/增强任务","id":"be0156ff-611c-4d8f-b6a3-03f7839198c3","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/piano_audio_enhance","description":"<p>创建钢琴歌曲修复/增强任务\n将上传的钢琴音频转写为 MIDI 后重新渲染为修复/增强后的 WAV 音频。</p>\n<p>operationId: <code>createPianoAudioEnhanceTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误、文件不存在、文件类型不支持或媒体探测失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["task","piano_audio_enhance"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"be0156ff-611c-4d8f-b6a3-03f7839198c3"},{"name":"查询钢琴歌曲修复/增强任务结果","id":"9a2db8f4-b65f-4f0c-9da1-d18d140b8d9e","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/piano_audio_enhance/537489015178247","description":"<p>查询钢琴歌曲修复/增强任务结果\n查询任务状态与生成的 WAV 音频文件。</p>\n<p>operationId: <code>getPianoAudioEnhanceTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","piano_audio_enhance","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9a2db8f4-b65f-4f0c-9da1-d18d140b8d9e"},{"name":"创建钢琴音频转 MIDI 任务","id":"9575291a-21a2-4d35-865d-4fe681097eaf","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/piano_audio_to_midi","description":"<p>创建钢琴音频转 MIDI 任务\n将上传的钢琴音频转换为 MIDI 文件。</p>\n<p>operationId: <code>createPianoAudioToMidiTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误、文件不存在、文件类型不支持或媒体探测失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["task","piano_audio_to_midi"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9575291a-21a2-4d35-865d-4fe681097eaf"},{"name":"查询钢琴音频转 MIDI 任务结果","id":"0f47a993-0b4a-4524-919f-20d75101f563","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/piano_audio_to_midi/537489015178247","description":"<p>查询钢琴音频转 MIDI 任务结果\n查询任务状态与生成的 MIDI 文件。</p>\n<p>operationId: <code>getPianoAudioToMidiTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","piano_audio_to_midi","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"0f47a993-0b4a-4524-919f-20d75101f563"},{"name":"音色清单（公开只读，免鉴权）","id":"9413c41f-afae-4a99-a56a-1ec6e7172dfa","request":{"method":"GET","header":[],"url":"https://api.ai-mcn.tv:10000/task/tts/voices?maturity=&engine=","description":"<p>音色清单（公开只读，免鉴权）\n返回全部 status=ready 的音色对外投影：标识、展示名、性别、语言、人设格位、\n语速可调区间、风格、中文描述与标签、适用题材。<code>visibility=internal</code> 的音色<strong>照常展示</strong>\n并带 <code>internal_only: true</code> 与说明（展示 ≠ 可用）；<code>maturity=experimental</code> 的音色带\n实验性标注（不保证稳定、音色可能变动、仅供测试）。\n中文（zh-CN / zh-HK / yue-HK）音色另带<strong>挂钟语速估值</strong>两键：<code>speech_rate_cpm</code>\n（字/分钟 = 稿件字符数 ÷ 合成音频总时长，含句间停顿；基线是该音色实际生效的默认合成参数，\n<code>speed_range.default</code> 并不代表这个基线）与出处标记 <code>speech_rate_basis</code>（<code>measured</code> 实测标定 /\n<code>derived</code> 由声学测量推算）。它是<strong>估值</strong>，服务端不对时长作承诺，<strong>MUST NOT 用于计费</strong>。\n英文 / 日文音色与无数据的音色两键一并省略（不出 null），此时请退回你自己的缺省值。\n带 <code>If-None-Match</code> 且内容未变时回 304 空体，消费端复用本地缓存。</p>\n<p>operationId: <code>listTtsVoices</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 音色清单</li>\n<li>304: 内容未变（命中 If-None-Match），空体</li>\n</ul>\n","urlObject":{"path":["task","tts","voices"],"host":["https://api.ai-mcn.tv:10000"],"query":[{"description":{"content":"<p>仅返回指定成熟度（stable / experimental）。不传则全返回</p>\n","type":"text/plain"},"key":"maturity","value":""},{"description":{"content":"<p>仅返回指定引擎的音色</p>\n","type":"text/plain"},"key":"engine","value":""}],"variable":[]}},"response":[],"_postman_id":"9413c41f-afae-4a99-a56a-1ec6e7172dfa"},{"name":"音色语义检索（按题材/气质用自然语言找音色）","id":"7a5ba3d7-2b5a-447c-b31d-8cc6377b310a","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"query\": \"<string>\",\n  \"top_k\": 0,\n  \"filters\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/tts/voices/search","description":"<p>音色语义检索（按题材/气质用自然语言找音色）\n用一句自然语言描述你要做的内容（如「旅拍解说，轻松幽默的年轻男声」「讲历史的低沉男声，\n像老学者那样」），返回最匹配的 <strong>top-k 候选</strong>，每条带相似度与命中理由。\n可选过滤条件（engine / persona / gender / dialect）用于收窄范围。\n<strong>返回的是候选不是判决</strong>：音色是审美选择，最终选哪个由你或你的 agent 决定；\n本接口不会依据分数替你剔除。\n每条候选与清单是同一套投影字段：中文音色同样带 <code>speech_rate_cpm</code> / <code>speech_rate_basis</code>\n挂钟语速估值（与清单同一音色同一个值；<strong>估值，MUST NOT 用于计费</strong>），选音色时当场就能估稿件篇幅，\n不必为了拿语速再拉一次清单。</p>\n<p>operationId: <code>searchTtsVoices</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 候选列表，形如 {\"voices\": [{\"voice_id\": \"...\", \"display_name\": \"...\", \"score\": 0.7486, \"why\": \"男声沉稳厚重；低沉、极暗…；适合历史人文讲述、人物传记\"}, ...]}</li>\n<li>400: query 缺失或为空</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","tts","voices","search"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7a5ba3d7-2b5a-447c-b31d-8cc6377b310a"}],"id":"31f87a4b-ebfe-4b96-b99b-ff88f62e3b10","_postman_id":"31f87a4b-ebfe-4b96-b99b-ff88f62e3b10","description":""},{"name":"图片处理","item":[{"name":"创建图片去黑边任务","id":"f545b6c1-7b5f-42df-83cb-ce34627a42c5","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_blackborder_remove","description":"<p>创建图片去黑边任务\n自动检测并去除图片的黑边。</p>\n<p>operationId: <code>createImageBlackborderRemoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","image_blackborder_remove"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"f545b6c1-7b5f-42df-83cb-ce34627a42c5"},{"name":"查询图片去黑边任务结果","id":"e1f8f507-518b-493e-a2dd-114a8953b875","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_blackborder_remove/537489015178247","description":"<p>查询图片去黑边任务结果</p>\n<p>operationId: <code>getImageBlackborderRemoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_blackborder_remove","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e1f8f507-518b-493e-a2dd-114a8953b875"},{"name":"创建图片比例转换任务","id":"02db7b3c-9a78-4d0c-a74d-eee8720753db","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"canvas_width\": 1080,\n  \"canvas_height\": 1920,\n  \"canvas_type\": \"normal\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_canvas_adapt","description":"<p>创建图片比例转换任务\n将图片转换为指定的目标尺寸。</p>\n<p>operationId: <code>createImageCanvasAdaptTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","image_canvas_adapt"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"02db7b3c-9a78-4d0c-a74d-eee8720753db"},{"name":"查询图片比例转换任务结果","id":"c88523ff-bb43-4e28-8628-fa82c1c8d525","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_canvas_adapt/537489015178247","description":"<p>查询图片比例转换任务结果</p>\n<p>operationId: <code>getImageCanvasAdaptTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_canvas_adapt","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"c88523ff-bb43-4e28-8628-fa82c1c8d525"},{"name":"创建智能拼图/封面图任务","id":"3d189a77-f8df-4098-a08e-dff09548b3fc","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_ids\": [\n    \"537489015178246\",\n    \"537489015178247\"\n  ],\n  \"main_title\": \"精彩瞬间\",\n  \"sub_title\": \"2024年度回顾\",\n  \"mode\": \"full\",\n  \"aspect\": \"3:4\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_classic_template","description":"<p>创建智能拼图/封面图任务\n根据多张图片生成智能拼图或封面图，支持添加标题文字。</p>\n<p>operationId: <code>createImageClassicTemplateTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","image_classic_template"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d189a77-f8df-4098-a08e-dff09548b3fc"},{"name":"查询智能拼图/封面图任务结果","id":"d8c64363-a181-47fc-8419-352c077e96b6","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_classic_template/537489015178247","description":"<p>查询智能拼图/封面图任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getImageClassicTemplateTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_classic_template","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d8c64363-a181-47fc-8419-352c077e96b6"},{"name":"创建图片抠像任务","id":"e1231ec0-22ae-4455-90ea-e2320beab832","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"output_format\": \"png\",\n  \"high_res\": true,\n  \"output_background\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_matting","description":"<p>创建图片抠像任务\n用 BiRefNet 抠出图片主体并输出透明背景（含发丝级软边 alpha），公益免费。</p>\n<p>operationId: <code>createImageMattingTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","image_matting"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e1231ec0-22ae-4455-90ea-e2320beab832"},{"name":"查询图片抠像任务结果","id":"c4088844-6c4e-47b8-a467-a58c3c50e442","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_matting/537489015178247","description":"<p>查询图片抠像任务结果</p>\n<p>operationId: <code>getImageMattingTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_matting","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"c4088844-6c4e-47b8-a467-a58c3c50e442"},{"name":"创建推拉摇移图片运镜任务","id":"bce8238c-6c40-4ed2-a9b3-66ecae361d3c","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"width\": 1920,\n  \"height\": 1080,\n  \"duration\": 8,\n  \"fps\": 60,\n  \"motion\": \"zoom_in_center\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_move","description":"<p>创建推拉摇移图片运镜任务\n将静态图片转换为具有运镜效果的视频。</p>\n<p>operationId: <code>createImageMoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","image_move"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"bce8238c-6c40-4ed2-a9b3-66ecae361d3c"},{"name":"查询推拉摇移图片运镜任务结果","id":"1d1b8421-8d90-4cfb-9ae7-1031369d9ab1","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_move/537489015178247","description":"<p>查询推拉摇移图片运镜任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getImageMoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_move","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"1d1b8421-8d90-4cfb-9ae7-1031369d9ab1"},{"name":"创建图片去水印任务","id":"53bc2b67-1a7b-492e-bcd2-76f7f0d1786e","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"purify_scope\": \"region\",\n  \"regions\": [\n    {\n      \"x\": 0.02,\n      \"y\": 0.02,\n      \"w\": 0.15,\n      \"h\": 0.08\n    }\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_purify","description":"<p>创建图片去水印任务\n去除图片中的水印、Logo等不需要的元素。</p>\n<p>operationId: <code>createImagePurifyTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","image_purify"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"53bc2b67-1a7b-492e-bcd2-76f7f0d1786e"},{"name":"查询图片去水印任务结果","id":"37440a35-4987-4d62-b48a-86524a504893","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_purify/537489015178247","description":"<p>查询图片去水印任务结果</p>\n<p>operationId: <code>getImagePurifyTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_purify","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"37440a35-4987-4d62-b48a-86524a504893"},{"name":"创建智能livephoto任务","id":"d87bf33b-24bc-4398-92ef-974988375dc4","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"output_format\": \"mp4\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_to_live","description":"<p>创建智能livephoto任务\n将静态图片转换为会动起来的短视频（类似 livephoto）：以微动效果为主，可伴随轻微的镜头运动，并非画面完全静止。</p>\n<p>operationId: <code>createImageToLiveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n<li>503: 功能临时下架（上游供给暂停，恢复后重新开放），业务错误码 6029</li>\n</ul>\n","urlObject":{"path":["task","image_to_live"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d87bf33b-24bc-4398-92ef-974988375dc4"},{"name":"查询智能livephoto任务结果","id":"b544c43a-da3b-4ae3-86c0-b2a268e84dd5","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_to_live/537489015178247","description":"<p>查询智能livephoto任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getImageToLiveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_to_live","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b544c43a-da3b-4ae3-86c0-b2a268e84dd5"},{"name":"创建长图转方图任务","id":"e257835e-4aac-47c6-b96b-7696b4ab591a","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"max_line\": 4000\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_to_square","description":"<p>创建长图转方图任务\n将长图智能分割并拼接成方图，使其更适合在社交媒体展示。</p>\n<p>operationId: <code>createImageToSquareTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","image_to_square"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e257835e-4aac-47c6-b96b-7696b4ab591a"},{"name":"查询长图转方图任务结果","id":"b768ad41-f483-4fd3-8b07-939bfc490655","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_to_square/537489015178247","description":"<p>查询长图转方图任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getImageToSquareTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_to_square","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b768ad41-f483-4fd3-8b07-939bfc490655"},{"name":"创建拼长图任务","id":"f258438f-dfbe-41d3-a126-77d2b65fe18c","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_ids\": [\n    \"537489015178246\",\n    \"537489015178247\"\n  ],\n  \"show_filename\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/image_vertical_stitch","description":"<p>创建拼长图任务\n将多张图片竖向拼接为一张长图，可选择是否显示文件名标签。</p>\n<p>operationId: <code>createImageVerticalStitchTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["task","image_vertical_stitch"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"f258438f-dfbe-41d3-a126-77d2b65fe18c"},{"name":"查询拼长图任务结果","id":"caaf5010-bd42-45ca-ad6d-a9ef61f9e5df","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/image_vertical_stitch/537489015178247","description":"<p>查询拼长图任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getImageVerticalStitchTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","image_vertical_stitch","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"caaf5010-bd42-45ca-ad6d-a9ef61f9e5df"},{"name":"创建动态照片封装任务","id":"5eda1c67-d65f-4d0f-a594-affb9f455299","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"video_file_id\": \"537489015178250\",\n  \"target\": \"both\",\n  \"mute\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/live_photo_pack","description":"<p>创建动态照片封装任务\n上传一张照片和一段视频，直出安卓动态照片与苹果实况照片（Live Photo）。不做任何生成，只做封装。</p>\n<p>operationId: <code>createLivePhotoPackTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误、文件类型不匹配、视频超出体积或时长限制、视频无法解析</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["task","live_photo_pack"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5eda1c67-d65f-4d0f-a594-affb9f455299"},{"name":"查询动态照片封装任务结果","id":"8cd09fac-ac16-4fee-9f47-88333b225b85","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/live_photo_pack/537489015178247","description":"<p>查询动态照片封装任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getLivePhotoPackTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["task","live_photo_pack","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"8cd09fac-ac16-4fee-9f47-88333b225b85"}],"id":"cc24dfdb-34ea-4f45-aaf4-ee7200560fe5","_postman_id":"cc24dfdb-34ea-4f45-aaf4-ee7200560fe5","description":""},{"name":"视频处理","item":[{"name":"视频素材语义检索（对外客户接口，同步返回，按次计费）","id":"4fab19dd-1657-4547-967f-14de4ade37d6","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"query\": \"日落海边礁石上一人持相机的剪影\",\n  \"top_k\": 10,\n  \"diversity\": false,\n  \"request_id\": \"<string>\",\n  \"filters\": {\n    \"min_duration\": 0.0,\n    \"max_duration\": 0.0,\n    \"orientation\": \"landscape\",\n    \"min_width\": 0,\n    \"exclude_ids\": [\n      0\n    ]\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/video_clip_search","description":"<p>视频素材语义检索（对外客户接口，同步返回，按次计费）\n按自然语言或关键词检索可剪辑的视频素材片段，返回带片内时间段 segments、取片直链、\n时长/画幅/fps 的排序结果；固定只检索有版权素材。<strong>同步返回（非异步任务）</strong>。\n计费: 每次成功查询按 task_type <code>video_clip_search</code> 计费一次(与条数无关), 响应携 task_id 留痕可查;\n成功检索的素材获<strong>持久授予</strong>(可经 /task/material_resign 免费无限重签原片直链); 检索失败不扣费。\n余额/配额不足返回 402。鉴权：Authorization 头传 API Key。</p>\n<p>operationId: <code>videoClipSearch</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 检索成功(响应携 task_id)</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 余额/配额不足(前置拒绝, 不触上游不扣费)</li>\n<li>6401: 上游检索服务不可用(不扣费)</li>\n</ul>\n","urlObject":{"path":["task","video_clip_search"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4fab19dd-1657-4547-967f-14de4ade37d6"},{"name":"创建 HTML 动画渲染任务","id":"48c5162d-afc4-4c7a-9487-f9b3adf9f852","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"composition\": {},\n  \"render\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/html_animate_render","description":"<p>创建 HTML 动画渲染任务\n将一份合成规格（视频底轨 + 任意自定义 HTML 动画颗粒）合成渲染为成片 mp4。\n素材通过 composition.assets.file_id 引用平台已有文件。按分钟计费（成片总时长）。</p>\n<p>operationId: <code>createHtmlAnimateRenderTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["html_animate_render"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"48c5162d-afc4-4c7a-9487-f9b3adf9f852"},{"name":"查询 HTML 动画渲染任务结果","id":"097a737c-3213-443c-8807-d0c5ac69ab3c","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/html_animate_render/537489015178247","description":"<p>查询 HTML 动画渲染任务结果</p>\n<p>operationId: <code>getHtmlAnimateRenderTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["html_animate_render","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"097a737c-3213-443c-8807-d0c5ac69ab3c"},{"name":"创建 HTML 动画渲染任务（单点合成）","id":"9206c8a0-f188-4fb6-948b-9e548bbcfd8e","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"composition\": {},\n  \"render\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/html_render_simple","description":"<p>创建 HTML 动画渲染任务（单点合成）\n将一份合成规格（视频底轨 + 任意自定义 HTML 动画颗粒）<strong>单点合成</strong>渲染为成片 mp4——底轨+颗粒\n一个根合成、一次渲染，适合「无长视频底轨贯穿 / 不透明全屏切入 / 纯 HTML 动画」。长视频底轨 +\n服务端透明叠加合成请用整轨接口 /task/html_animate_render。素材通过 composition.assets.file_id 引用\n平台已有文件。按分钟计费（成片总时长）。\nrender.output_format=webm 则切换为<strong>透明颗粒层</strong>输出（VP8-alpha WebM，beats-only、tracks 可空）：\n云端只渲颗粒透明层、不烧入底轨，客户端拉回后用原生合成器叠到本地口播（口播不上云）。</p>\n<p>operationId: <code>createHtmlRenderSimpleTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["html_render_simple"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9206c8a0-f188-4fb6-948b-9e548bbcfd8e"},{"name":"查询 HTML 动画渲染任务结果（单点合成）","id":"edc293c9-eaff-4358-93f8-4e48b3209b78","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/html_render_simple/537489015178247","description":"<p>查询 HTML 动画渲染任务结果（单点合成）</p>\n<p>operationId: <code>getHtmlRenderSimpleTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["html_render_simple","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"edc293c9-eaff-4358-93f8-4e48b3209b78"},{"name":"MAD 技法 wiki 版本发现入口（公开只读、免鉴权）。","id":"66b1e76a-e35b-4c5f-8e06-d12cf71b5883","request":{"method":"GET","header":[],"url":"https://api.ai-mcn.tv:10000/task/mad/manifest","description":"<p>MAD 技法 wiki 版本发现入口（公开只读、免鉴权）。\n返回当前生效版本、各已发布数据集的绝对 URL 与校验信息、静态重资产基址。三消费端同源，勿硬编码数据 URL。\n带 If-None-Match 且版本未变时回 304 空体。尚未灌装（空表）时回业务错误码 404。</p>\n<p>operationId: <code>getMadManifest</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 当前 manifest，形如 {\"version\": 1, \"datasets\": {\"catalog\": {\"url\": \"https://.../task/mad/dataset/catalog\", \"version\": 1, \"size\": 106541, \"sha256\": \"...\"}, ...}, \"assets_base\": \"https://.../mad_wiki/v1\"}； datasets 为累积态清单（可含 version 滞后的 key），各条目 url/sha256 与其自身版本自洽</li>\n<li>304: 版本未变（命中 If-None-Match），空体，消费端复用本地缓存</li>\n<li>404: 尚未灌装（空表）——业务码 404 NOT_FOUND，非系统错误</li>\n</ul>\n","urlObject":{"path":["task","mad","manifest"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"66b1e76a-e35b-4c5f-8e06-d12cf71b5883"},{"name":"按 key 整存直出 MAD 数据集 JSON（公开只读、免鉴权）。","id":"a5ab4fed-788d-4de8-af28-dd389f83dbd9","request":{"method":"GET","header":[],"url":"https://api.ai-mcn.tv:10000/task/mad/dataset/{{key}}","description":"<p>按 key 整存直出 MAD 数据集 JSON（公开只读、免鉴权）。\nkey 值域为白名单 catalog / projects_index / techniques_index / patterns / mad_pool；命中时以\napplication/json 直出该数据集完整 JSON（byte-exact，sha256 与 manifest 声明相符，不做逐条拼装）。\n按 manifest 当前清单声明的 version 取行。带 If-None-Match 且版本未变时回 304（不读大字段）。\n白名单外 / 清单未声明（如 mad_pool 未灌）/ 版本行缺失均回业务码 404。</p>\n<p>operationId: <code>getMadDataset</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 该数据集完整 JSON（原样直出，Content-Type application/json）</li>\n<li>304: 版本未变（命中 If-None-Match），空体</li>\n<li>404: 未知 key / 尚未灌装 / 清单未声明——业务码 404 NOT_FOUND，非系统错误</li>\n</ul>\n","urlObject":{"path":["task","mad","dataset","{{key}}"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"a5ab4fed-788d-4de8-af28-dd389f83dbd9"},{"name":"创建智能字幕翻译任务","id":"e2a57a3a-fe57-4628-a4fd-7551ed4f65ab","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"language\": \"zh-CN\",\n  \"translate_language\": \"en-US\",\n  \"output_format\": \"ass\",\n  \"line_mode\": \"resegment\",\n  \"lingual_type\": \"monolingual\",\n  \"subtitle_type\": \"default\",\n  \"subtitle_color\": \"雅黑\",\n  \"video_size\": [\n    1920,\n    1080\n  ],\n  \"strip_punctuation\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/subtitle_translate","description":"<p>创建智能字幕翻译任务\n把已有字幕文件（.ass / .srt）翻译成另一种语言，可选套用平台自有的字幕样式。\n本能力不做语音识别、不接受音视频输入——从音视频生成字幕请用「智能字幕识别」。\n按文本字符数计费（measure=千字符）：计费单位数 = 字幕总字符数 ÷ 1000。\n字符数按 Unicode 码点计，一个中日韩字符算 1 个字符。</p>\n<p>operationId: <code>createSubtitleTranslateTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误 / 字幕文件无法采纳 / 超出规模上限</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["subtitle_translate"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e2a57a3a-fe57-4628-a4fd-7551ed4f65ab"},{"name":"查询智能字幕翻译任务结果","id":"b49e78a1-3020-45b1-bff1-ccb11dce1bc2","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/subtitle_translate/537489015178247","description":"<p>查询智能字幕翻译任务结果</p>\n<p>operationId: <code>getSubtitleTranslateTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["subtitle_translate","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b49e78a1-3020-45b1-bff1-ccb11dce1bc2"},{"name":"创建视频智能分镜任务","id":"fa77f3eb-6a57-44c0-b986-d157d9f09e43","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"mode\": \"scene\",\n  \"only_struct\": true,\n  \"need_audio\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_ai_segment","description":"<p>创建视频智能分镜任务\n基于多模态大模型对视频进行语义级镜头切分和结构化归类，可选输出切片文件。</p>\n<p>operationId: <code>createVideoAiSegmentTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_ai_segment"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa77f3eb-6a57-44c0-b986-d157d9f09e43"},{"name":"查询视频智能分镜任务结果","id":"7cb974ab-bc8b-4f6e-bdea-a1718bdbc495","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_ai_segment/537489015178247","description":"<p>查询视频智能分镜任务结果</p>\n<p>operationId: <code>getVideoAiSegmentTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_ai_segment","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7cb974ab-bc8b-4f6e-bdea-a1718bdbc495"},{"name":"创建智能字幕识别任务","id":"a4247206-4684-493e-ad2b-814f0df48c16","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"language\": \"zh-CN\",\n  \"translate_language\": \"\",\n  \"need_render\": false,\n  \"need_pure\": false,\n  \"lingual_type\": \"bilingual\",\n  \"subtitle_type\": \"default\",\n  \"subtitle_color\": \"雅黑\",\n  \"video_size\": [\n    3840,\n    2160\n  ],\n  \"subtitle_format\": \"both\",\n  \"strip_punctuation\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_ai_subtitle","description":"<p>创建智能字幕识别任务\n对视频或音频文件进行语音识别，自动生成字幕，支持翻译和多种字幕样式。\n<strong>支持视频与音频文件</strong>两类输入（按上传物后缀自动识别）：\n音频支持 .wav / .mp3 / .m4a / .ape / .aac / .ogg / .flac / .wma（.ogg 恒按音频处理）。\n音频输入走同一条识别与字幕链，正常产出 .ass 字幕、全量转写与摘要；音频没有画面，\nneed_render / need_pure 传 true 会在创建任务时被 400 拒绝（错误码 6016）。</p>\n<p>operationId: <code>createVideoAiSubtitleTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误（错误码 6016）：音频输入传了 need_render / need_pure 取 true （音频无画面可烧录/净化，建单即拒、文案点名被拒参数）；或 video_size 形态非法。 或语种不受理（错误码 6015）—— 该码在共享白名单内但本能力的识别侧无引擎 （当前为 es-ES、pt-PT），响应文案会说明它可作 translate_language 使用。 语言代码不在支持列表为 6015</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_ai_subtitle"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"a4247206-4684-493e-ad2b-814f0df48c16"},{"name":"查询智能字幕识别任务结果","id":"a749cd76-e680-4ef1-8d17-2829b2c7b5d9","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_ai_subtitle/537489015178247","description":"<p>查询智能字幕识别任务结果</p>\n<p>operationId: <code>getVideoAiSubtitleTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_ai_subtitle","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"a749cd76-e680-4ef1-8d17-2829b2c7b5d9"},{"name":"创建视频去黑边任务","id":"972e55fe-e805-40f2-9c43-680fe9263be0","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_blackborder_remove","description":"<p>创建视频去黑边任务\n自动检测并去除视频的黑边，保留原视频的音频。</p>\n<p>operationId: <code>createVideoBlackborderRemoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_blackborder_remove"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"972e55fe-e805-40f2-9c43-680fe9263be0"},{"name":"查询视频去黑边任务结果","id":"1efd882f-1ab2-4b33-a975-f934107bad5a","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_blackborder_remove/537489015178247","description":"<p>查询视频去黑边任务结果</p>\n<p>operationId: <code>getVideoBlackborderRemoveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_blackborder_remove","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"1efd882f-1ab2-4b33-a975-f934107bad5a"},{"name":"创建视频比例转换任务","id":"d360c29b-8a9e-420d-8ee8-b77bd207b2c8","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"target_width\": 1080,\n  \"target_height\": 1920,\n  \"canvas_type\": \"normal\",\n  \"start\": 0,\n  \"end\": 0,\n  \"need_audio\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_canvas_adapt","description":"<p>创建视频比例转换任务\n将视频转换为指定的目标尺寸，支持画布类型选择和视频片段截取。</p>\n<p>operationId: <code>createVideoCanvasAdaptTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["video_canvas_adapt"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d360c29b-8a9e-420d-8ee8-b77bd207b2c8"},{"name":"查询视频比例转换任务结果","id":"6b72ae31-2640-4933-ac10-0f9c8f9156a4","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_canvas_adapt/537489015178247","description":"<p>查询视频比例转换任务结果\n查询视频比例转换任务的状态和结果。</p>\n<p>operationId: <code>getVideoCanvasAdaptTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_canvas_adapt","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"6b72ae31-2640-4933-ac10-0f9c8f9156a4"},{"name":"创建多脸追踪/身份聚类任务","id":"00bce1a3-a4a8-45c5-9497-40b842fe56a5","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"time_ranges\": [\n    {\n      \"begin_time\": 0,\n      \"end_time\": 30000\n    }\n  ],\n  \"sample_fps\": 5,\n  \"max_faces\": 5,\n  \"min_face_ratio\": 0.001,\n  \"enable_body_match\": false,\n  \"similarity_threshold\": 0.45\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_face_track","description":"<p>创建多脸追踪/身份聚类任务\n检测视频中的多张可见人脸，输出任务内稳定的人物 ID、可见时间段与采样轨迹。</p>\n<p>operationId: <code>createVideoFaceTrackTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 请求参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_face_track"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"00bce1a3-a4a8-45c5-9497-40b842fe56a5"},{"name":"查询多脸追踪/身份聚类任务","id":"5bb84a43-ba90-40bc-a24c-e55744ab846d","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_face_track/537489015178247","description":"<p>查询多脸追踪/身份聚类任务</p>\n<p>operationId: <code>getVideoFaceTrackTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_face_track","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5bb84a43-ba90-40bc-a24c-e55744ab846d"},{"name":"创建视频插帧任务","id":"92fc1f3d-2086-40a1-8883-f5c003b156c2","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"multiplier\": 2\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_interpolate","description":"<p>创建视频插帧任务\n使用AI算法对视频进行帧插值，提升视频流畅度。</p>\n<p>operationId: <code>createVideoInterpolateTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["video_interpolate"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"92fc1f3d-2086-40a1-8883-f5c003b156c2"},{"name":"查询视频插帧任务结果","id":"afe6ce43-0f17-4313-97de-27a74796b3ae","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_interpolate/537489015178247","description":"<p>查询视频插帧任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getVideoInterpolateTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_interpolate","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"afe6ce43-0f17-4313-97de-27a74796b3ae"},{"name":"创建长视频转高光短视频（粗剪）任务","id":"26cd4d0b-0bc7-4131-9c52-2165f0495ec6","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"language\": \"zh-CN\",\n  \"output_language\": \"<string>\",\n  \"stt\": {},\n  \"subtitle_file_id\": \"<string>\",\n  \"subtitle\": {},\n  \"main_topic\": \"<string>\",\n  \"output_size\": \"<string>\",\n  \"jump_cut\": false,\n  \"duration\": {},\n  \"split_screen\": {},\n  \"outputs\": [\n    \"report\"\n  ],\n  \"source_path\": \"<string>\",\n  \"project_formats\": [\n    \"<string>\"\n  ],\n  \"struct_meta\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_long2short","description":"<p>创建长视频转高光短视频（粗剪）任务\n对长内容（播客/圆桌/脱口秀/访谈）按语义抽取多条不同主题的高光短片：先选段（话题），\n再可选跳剪（话题内压缩冗余、抽干货脊柱），按字级时间戳精确切点。产物：每条 clip 的 gtrk v1\n工程文件（该 clip files[] 里 format=gtrk，恒出）+ 选段报告（必出）；其余 NLE 工程文件、渲染粗剪\n成片（outputs 可选）。可选分屏（多人同框时多格）。\n按输入视频时长（分钟）计费。</p>\n<p>operationId: <code>createVideoLong2ShortTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误。含语种不受理（6015）—— 该码在共享白名单内但本能力的识别引擎不支持，响应文案会给出可行动替代</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["video_long2short"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"26cd4d0b-0bc7-4131-9c52-2165f0495ec6"},{"name":"查询长视频转高光短视频任务结果","id":"b800b71d-23b8-42eb-a22f-f46597ee759c","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_long2short/537489015178247","description":"<p>查询长视频转高光短视频任务结果</p>\n<p>operationId: <code>getVideoLong2ShortTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_long2short","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b800b71d-23b8-42eb-a22f-f46597ee759c"},{"name":"创建长视频转高光短视频（精剪 / 直接出片）任务","id":"bce4bff1-12c1-4fde-8715-bd9e6181839d","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"language\": \"zh-CN\",\n  \"output_language\": \"<string>\",\n  \"stt\": {},\n  \"subtitle_file_id\": \"<string>\",\n  \"main_topic\": \"<string>\",\n  \"output_size\": \"<string>\",\n  \"jump_cut\": false,\n  \"duration\": {},\n  \"split_screen\": {},\n  \"camera_move\": {},\n  \"speed\": {},\n  \"seam\": {},\n  \"subtitle\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_long2short_pro","description":"<p>创建长视频转高光短视频（精剪 / 直接出片）任务\n对长内容（播客/圆桌/脱口秀/访谈）按语义抽取多条不同主题高光短片，并一键出成品：选段 + 跳剪\n内核之上叠加 画布模糊背景填充（横竖互转）、克制运镜（亚像素推/拉）、整体调速（保音高）、智能字幕\n（去标点切短句、可选去源片烧录字幕），可选分屏（多人同框时多格、说话人在上/面对面、白边）。\n只输出渲染好的成片 mp4（每条高光一条），不出剪辑时间线/工程文件。按输入视频时长（分钟）计费。</p>\n<p>operationId: <code>createVideoLong2ShortProTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误。含语种不受理（6015）—— 该码在共享白名单内但本能力的识别引擎不支持，响应文案会给出可行动替代</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["video_long2short_pro"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"bce4bff1-12c1-4fde-8715-bd9e6181839d"},{"name":"查询长视频转高光短视频（精剪）任务结果","id":"720ac247-3bde-4378-b12a-7b0273e4c67c","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_long2short_pro/537489015178247","description":"<p>查询长视频转高光短视频（精剪）任务结果</p>\n<p>operationId: <code>getVideoLong2ShortProTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_long2short_pro","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"720ac247-3bde-4378-b12a-7b0273e4c67c"},{"name":"创建视频抠像任务","id":"5183ddba-250f-4dc8-bb89-fb4820d84868","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"target_mode\": \"auto\",\n  \"mask_file_id\": \"<string>\",\n  \"output_format\": \"webm\",\n  \"max_size\": 0,\n  \"output_background\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_matting","description":"<p>创建视频抠像任务\n无绿幕人物视频抠像：MatAnyone2 记忆传播 + BiRefNet 首帧主体 mask，输出 WebM/VP9\n透明视频（时序稳定、发丝级软边）。公益免费。</p>\n<p>operationId: <code>createVideoMattingTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_matting"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5183ddba-250f-4dc8-bb89-fb4820d84868"},{"name":"查询视频抠像任务结果","id":"29f4428c-4b82-45a8-a932-506e391ac281","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_matting/537489015178247","description":"<p>查询视频抠像任务结果</p>\n<p>operationId: <code>getVideoMattingTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_matting","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"29f4428c-4b82-45a8-a932-506e391ac281"},{"name":"创建视频运镜分析任务","id":"98c115b1-fc99-43a6-85ad-6e79164c71a6","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_motion_cut","description":"<p>创建视频运镜分析任务\n基于 OpenCVMotionCut 检测视频中具有明显动作或运镜的高光区间，并返回纯结构化结果。</p>\n<p>operationId: <code>createVideoMotionCutTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_motion_cut"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"98c115b1-fc99-43a6-85ad-6e79164c71a6"},{"name":"查询视频运镜分析任务结果","id":"fdfb513c-34b0-4281-acdb-3c3e9583d13d","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_motion_cut/537489015178247","description":"<p>查询视频运镜分析任务结果</p>\n<p>operationId: <code>getVideoMotionCutTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_motion_cut","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"fdfb513c-34b0-4281-acdb-3c3e9583d13d"},{"name":"创建智能口播剪辑任务","id":"fa29d75a-95d8-42b3-9132-f01ad4c64769","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"script\": \"<string>\",\n  \"la\": \"zh-CN\",\n  \"outputs\": [\n    \"project\"\n  ],\n  \"project_formats\": [\n    \"<string>\"\n  ],\n  \"render\": {},\n  \"rhythm_preset\": \"steady\",\n  \"adaptive_rhythm\": false,\n  \"punctuation_breaks\": {},\n  \"intra_gap_max\": 0.0,\n  \"intra_gap_target\": 0.0,\n  \"pad_in\": 0.0,\n  \"pad_out\": 0.0,\n  \"visual_assist\": false,\n  \"source_path\": \"<string>\",\n  \"struct_meta\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_oral_cut","description":"<p>创建智能口播剪辑任务\n对口播毛片做智能剪辑：剔除错读/重读/弃读片段（同段内容多次录读只保留最后一次\n读顺的版本）、收紧气口、按标点整形停顿节奏（break 时长可调）。提供文稿（script）\n时剪辑质量最佳；不提供时由智能分析重建终稿。按输入视频时长（分钟）计费。\n产物：gtrk v1 工程文件（files[] 里 format=gtrk，恒出）+ 剪辑报告（必出）；其余剪辑工程文件\n（xml/fcpxml/otio/jianying/capcut）、渲染成片（outputs 可选）。</p>\n<p>operationId: <code>createVideoOralCutTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误。含语种不受理（6015）—— 该码在共享白名单内但本能力的识别引擎不支持，响应文案会给出可行动替代</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["video_oral_cut"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa29d75a-95d8-42b3-9132-f01ad4c64769"},{"name":"查询智能口播剪辑任务结果","id":"d52f0c1a-a6eb-4611-9743-4992691e0bda","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_oral_cut/537489015178247","description":"<p>查询智能口播剪辑任务结果</p>\n<p>operationId: <code>getVideoOralCutTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_oral_cut","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d52f0c1a-a6eb-4611-9743-4992691e0bda"},{"name":"创建视频工程文件生成任务","id":"7a42fa1e-53cd-4ebc-83c1-77eb146b3316","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"version\": \"v1\",\n  \"video_size\": [\n    1920,\n    1080\n  ],\n  \"video_rate\": 60,\n  \"materials\": [\n    {}\n  ],\n  \"video_track\": [\n    {}\n  ],\n  \"audio_track\": [\n    {}\n  ],\n  \"duration\": 0.0,\n  \"beat_track\": [\n    {}\n  ],\n  \"struct_meta\": {},\n  \"project_formats\": [\n    \"<string>\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_project_struct","description":"<p>创建视频工程文件生成任务\n将 gtrk v1 通用契约（timeline 形态的中枢 JSON）转换为多种 NLE 工程文件：\nPremiere/FCP7 XML、Final Cut Pro X、OpenTimelineIO、剪映草稿、CapCut 草稿、同合云自有工程文件 .gtrk。\nBody 即 gtrk v1 结构本身（无需上传文件），素材两种引用形态：materials[].id（云端=平台文件ID）\n引用平台已有文件，或带本机 path（服务端不读文件，path 原样进工程文件、免平台校验）。</p>\n<p>operationId: <code>createVideoProjectStructTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["video_project_struct"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7a42fa1e-53cd-4ebc-83c1-77eb146b3316"},{"name":"查询视频工程文件生成任务结果","id":"4db897b9-95c9-4dd6-9be0-e60deae45cb8","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_project_struct/537489015178247","description":"<p>查询视频工程文件生成任务结果</p>\n<p>operationId: <code>getVideoProjectStructTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_project_struct","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4db897b9-95c9-4dd6-9be0-e60deae45cb8"},{"name":"查询净化协议能力（不建单、不计费）。","id":"4899b17f-162e-40af-b962-5c6c9b472d21","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_purify/capabilities","description":"<p>查询净化协议能力（不建单、不计费）。</p>\n<p>operationId: <code>getVideoPurifyCapabilities</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 返回当前服务支持的确认协议版本；版本 2 支持保护区和精确写回</li>\n</ul>\n","urlObject":{"path":["video_purify","capabilities"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4899b17f-162e-40af-b962-5c6c9b472d21"},{"name":"创建视频去水印任务","id":"c8d26224-5060-428b-a2f7-705a25258891","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"phase\": \"detect\",\n  \"detect_scope\": \"full_screen\",\n  \"detect_roi\": {},\n  \"purify_scope\": \"subtitle\",\n  \"roi\": {\n    \"x\": 0.0,\n    \"y\": 0.78,\n    \"w\": 1.0,\n    \"h\": 0.2\n  },\n  \"regions\": [\n    {\n      \"x\": 0.8,\n      \"y\": 0.02,\n      \"w\": 0.18,\n      \"h\": 0.08,\n      \"start\": 0,\n      \"end\": 5\n    }\n  ],\n  \"protect_regions\": [\n    {}\n  ],\n  \"source_file_id\": \"<string>\",\n  \"purify_func_type\": \"ffmpeg\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_purify","description":"<p>创建视频去水印任务\n去除视频中的水印、Logo、字幕等不需要的元素。</p>\n<p>operationId: <code>createVideoPurifyTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_purify"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"c8d26224-5060-428b-a2f7-705a25258891"},{"name":"查询视频去水印任务结果","id":"6d3770de-eda4-4051-b79e-1f10ea227270","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_purify/537489015178247","description":"<p>查询视频去水印任务结果</p>\n<p>operationId: <code>getVideoPurifyTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_purify","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"6d3770de-eda4-4051-b79e-1f10ea227270"},{"name":"创建视频机械分镜任务","id":"9a72593e-89eb-4797-a849-a33c9f6b68bc","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"detector\": \"content\",\n  \"threshold\": 45,\n  \"only_struct\": true,\n  \"need_audio\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_segment","description":"<p>创建视频机械分镜任务\n基于画面变动率识别镜头边界，输出分镜区间；可选生成对应切片文件。</p>\n<p>operationId: <code>createVideoSegmentTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_segment"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9a72593e-89eb-4797-a849-a33c9f6b68bc"},{"name":"查询视频机械分镜任务结果","id":"37a78830-c000-45d2-92f0-772fabc6dfa1","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_segment/537489015178247","description":"<p>查询视频机械分镜任务结果</p>\n<p>operationId: <code>getVideoSegmentTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_segment","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"37a78830-c000-45d2-92f0-772fabc6dfa1"},{"name":"创建音视频说话人检测任务","id":"5d789fd2-81a2-44ed-9fdd-16f44ea62e0a","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"language\": \"zh-CN\",\n  \"max_faces_per_frame\": 5,\n  \"detect_body\": false,\n  \"track_sample_fps\": 5\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_speaker_detect","description":"<p>创建音视频说话人检测任务\n检测视频中的可见说话人，内部自动执行 ASR，\n并融合转写句子、视觉人物轨迹和说话片段。</p>\n<p>operationId: <code>createVideoSpeakerDetectTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 请求参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_speaker_detect"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5d789fd2-81a2-44ed-9fdd-16f44ea62e0a"},{"name":"查询音视频说话人检测任务","id":"03940198-4426-4d06-8cd4-ad76d6c03036","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_speaker_detect/537489015178247","description":"<p>查询音视频说话人检测任务</p>\n<p>operationId: <code>getVideoSpeakerDetectTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_speaker_detect","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"03940198-4426-4d06-8cd4-ad76d6c03036"},{"name":"创建智能分屏布局生成任务","id":"d030149d-6c10-43a8-bbf5-8d885e0ca24d","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"clips\": [\n    {\n      \"file_id\": \"537489015178246\",\n      \"begin_time_ms\": 0,\n      \"end_time_ms\": 0,\n      \"crop\": {}\n    }\n  ],\n  \"layout_mode\": \"auto\",\n  \"layout_id\": 0,\n  \"random_seed\": 0,\n  \"output_ratio\": \"9:16\",\n  \"quality\": \"1080p\",\n  \"fit_mode\": \"cover\",\n  \"duration_mode\": \"shortest\",\n  \"audio_mode\": \"first\",\n  \"gap_ratio\": 0.008,\n  \"background_color\": \"#000000\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_split_screen","description":"<p>创建智能分屏布局生成任务\n将 2-16 个视频片段按共享拼图模板合成为一个分屏视频。该功能独立于人脸追踪和说话人检测。</p>\n<p>operationId: <code>createVideoSplitScreenTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 请求参数错误</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_split_screen"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d030149d-6c10-43a8-bbf5-8d885e0ca24d"},{"name":"查询智能分屏布局生成任务结果","id":"87dd6663-4fa5-48e1-afbb-74ead374c864","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_split_screen/537489015178247","description":"<p>查询智能分屏布局生成任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getVideoSplitScreenTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_split_screen","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"87dd6663-4fa5-48e1-afbb-74ead374c864"},{"name":"创建视频稳像任务","id":"7ffc1874-2b2e-4a72-bec5-52892db07a04","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"method\": \"turbo\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_stabilizer","description":"<p>创建视频稳像任务\n使用算法对视频进行防抖处理，使画面更加稳定。\n支持三种不同的稳像实现方式，可通过 method 参数选择。</p>\n<p>operationId: <code>createVideoStabilizerTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["video_stabilizer"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7ffc1874-2b2e-4a72-bec5-52892db07a04"},{"name":"查询视频稳像任务结果","id":"898c71f3-ba80-4f00-b2a8-266ff21422cc","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_stabilizer/537489015178247","description":"<p>查询视频稳像任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getVideoStabilizerTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_stabilizer","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"898c71f3-ba80-4f00-b2a8-266ff21422cc"},{"name":"创建视频时间线渲染任务","id":"2b2fa437-acb4-4fac-8ecb-6b6ff2128367","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"version\": \"v1\",\n  \"video_size\": [\n    1920,\n    1080\n  ],\n  \"video_rate\": 30,\n  \"materials\": [\n    {}\n  ],\n  \"video_track\": [\n    {}\n  ],\n  \"audio_track\": [\n    {}\n  ],\n  \"duration\": 0.0,\n  \"beat_track\": [\n    {}\n  ],\n  \"struct_meta\": {},\n  \"render\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_timeline_render","description":"<p>创建视频时间线渲染任务\n将 gtrk v1 通用契约（timeline 形态的中枢 JSON）渲染为成片 mp4。与视频工程文件生成\n共用 gtrk v1 模型；素材以 materials[].id（云端=平台文件ID）引用平台已有文件。\n时间线渲染对 gtrk v1 收窄为恰好 1 条 video_track（main 底轨），beat_track 忽略。\n按分钟计费（gtrk duration 或轨末端推算）。</p>\n<p>operationId: <code>createVideoTimelineRenderTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n</ul>\n","urlObject":{"path":["video_timeline_render"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"2b2fa437-acb4-4fac-8ecb-6b6ff2128367"},{"name":"查询视频时间线渲染任务结果","id":"fa3e9df0-7176-47b6-aade-09396de94236","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_timeline_render/537489015178247","description":"<p>查询视频时间线渲染任务结果</p>\n<p>operationId: <code>getVideoTimelineRenderTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_timeline_render","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa3e9df0-7176-47b6-aade-09396de94236"},{"name":"创建视频译制配音任务","id":"894d4e95-ba3b-4d64-8df3-412d0dfde4b3","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"source_lang\": \"zh-CN\",\n  \"target_lang\": \"en-US\",\n  \"speaker\": \"clone\",\n  \"ref_file_id\": \"537489015178247\",\n  \"ref_lang\": \"zh-CN\",\n  \"keep_bgm\": true,\n  \"fit_policy\": \"natural\",\n  \"speed_band\": [\n    0.95,\n    1.15\n  ],\n  \"subtitle\": \"soft\",\n  \"subtitle_type\": \"default\",\n  \"project_formats\": [\n    \"gtrk\"\n  ],\n  \"source_path\": \"D:/clips/talk.mp4\",\n  \"local_output_dir\": \"D:/clips/talk-video_translate_dub\",\n  \"struct_meta\": {\n    \"nle_draft_dir\": \"C:/Users/me/AppData/Local/JianyingPro/User Data/Projects/com.lveditor.draft/talk\"\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_translate_dub","description":"<p>创建视频译制配音任务\n上传一段源语种视频或音频，指定目标语种与音色，服务端把其中的话翻译成目标语种、用所选音色逐句重新配音，\n并把配音按原片的说话位置铺回去：全片统一语速，逐句只在窄带内微调，差额优先由译文长度控制吸收，\n残差按「借时、邻句让位、改写、上浮、冻结帧或截尾」顺序兜底，每一步都如实记入 report。\n本能力只替换音轨，不改画面（不做口型同步、不改镜头）。\n视频产物：目标语种配音成片、纯配音轨、伴奏轨（保留伴奏且源片确有伴奏时）、与配音卡点一致的字幕、\n逐句对齐记录，以及可精修的工程文件（缺省 gtrk：改一句译文即可单句重合成）。\n音频产物：目标语种配音音频（mp3，保留伴奏时已混入原伴奏）、纯配音轨、伴奏轨、字幕文件与逐句对齐记录；\n音频不支持烧录字幕、不产出工程文件。\n按源文件分钟数计费（measure=分钟，服务端探测的时长为准）；音色档位不改单价；参考媒体的时长不参与计费。</p>\n<p>operationId: <code>createVideoTranslateDubTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>400: 参数错误（含语种越界、源文件过长、参考媒体过短或过长、拟合参数越界、音频要求烧录字幕）</li>\n<li>401: 鉴权失败</li>\n<li>402: 额度或余额不足</li>\n<li>404: 源文件或参考媒体不存在</li>\n</ul>\n","urlObject":{"path":["video_translate_dub"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"894d4e95-ba3b-4d64-8df3-412d0dfde4b3"},{"name":"查询视频译制配音任务结果","id":"6d86ca42-2dac-44b5-bae5-7256d42d4dd6","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_translate_dub/537489015178247","description":"<p>查询视频译制配音任务结果\n产物形状：成片与纯配音轨为核心产物；伴奏轨、字幕、逐句对齐记录、工程文件为衍生产物，\n单项失败不影响任务完成，原因见 errors 对应键。逐句明细只以 transcript_file_id 文件引用出现。</p>\n<p>operationId: <code>getVideoTranslateDubTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n</ul>\n","urlObject":{"path":["video_translate_dub","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"6d86ca42-2dac-44b5-bae5-7256d42d4dd6"},{"name":"创建视频超分任务","id":"db9a25a7-a96b-49d3-a292-406f279bc159","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"times\": 2,\n  \"upscale_type\": \"Reality\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_upscale","description":"<p>创建视频超分任务\n使用AI算法对视频进行超分辨率放大，提升视频清晰度。</p>\n<p>operationId: <code>createVideoUpscaleTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["video_upscale"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"db9a25a7-a96b-49d3-a292-406f279bc159"},{"name":"查询视频超分任务结果","id":"c2dd46f5-4869-4826-b0ea-c3c136b61b87","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_upscale/537489015178247","description":"<p>查询视频超分任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getVideoUpscaleTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_upscale","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"c2dd46f5-4869-4826-b0ea-c3c136b61b87"},{"name":"创建蒸汽波滤镜任务","id":"a3778043-82a8-4d1d-bdfa-494fa31926cc","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"file_id\": \"537489015178246\",\n  \"filter\": \"愈漸升溫\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/video_vaporwave","description":"<p>创建蒸汽波滤镜任务\n为视频添加蒸汽波(Vaporwave)风格滤镜效果。</p>\n<p>operationId: <code>createVideoVaporwaveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功</li>\n<li>401: 鉴权失败</li>\n<li>400: 参数错误</li>\n</ul>\n","urlObject":{"path":["video_vaporwave"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"a3778043-82a8-4d1d-bdfa-494fa31926cc"},{"name":"查询蒸汽波滤镜任务结果","id":"6d0dceaf-ff6c-4c6e-a8ca-0e9384e5906d","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/video_vaporwave/537489015178247","description":"<p>查询蒸汽波滤镜任务结果\n查询任务的执行状态和结果。</p>\n<p>operationId: <code>getVideoVaporwaveTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在</li>\n</ul>\n","urlObject":{"path":["video_vaporwave","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"6d0dceaf-ff6c-4c6e-a8ca-0e9384e5906d"}],"id":"b5bf7ea7-6304-483c-8c45-3e50c548ada8","_postman_id":"b5bf7ea7-6304-483c-8c45-3e50c548ada8","description":""},{"name":"文本处理","item":[{"name":"字体清单（公开只读，免鉴权）","id":"43033d87-22f2-4f81-b33a-1c9a2b2e27df","request":{"method":"GET","header":[],"url":"https://api.ai-mcn.tv:10000/font/families?query=","description":"<p>字体清单（公开只读，免鉴权）\n返回同合云字体库中<strong>可商用可分发</strong>且简体常用字全覆盖的字体族，按族聚合：\n中英族名、授权依据、各字重的文件名与字节数。族名可直接用作其他接口的字体入参。\n不可分发字体（商业字库 / 系统随附 / 来源不明）不在本清单内，也不提供任何参数将其列出。\n带 <code>If-None-Match</code> 且内容未变时回 304 空体，消费端复用本地缓存。</p>\n<p>operationId: <code>listFontFamilies</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 字体族清单，形如 {\"families\": [{\"family\": \"思源黑体 CN\", \"family_en\": \"Source Han Sans CN\", \"license\": \"SIL OFL 1.1 — 明确允许再分发\", \"face_count\": 2, \"faces\": [{\"file\": \"sourcehansanscn-bold.otf\", \"weight\": \"Bold\", \"bytes\": 8200000}]}], \"total\": 59}</li>\n<li>304: 内容未变（命中 If-None-Match），空体</li>\n</ul>\n","urlObject":{"path":["font","families"],"host":["https://api.ai-mcn.tv:10000"],"query":[{"description":{"content":"<p>按族名模糊筛（中英族名任一命中，大小写不敏感）。不传则全返回</p>\n","type":"text/plain"},"key":"query","value":""}],"variable":[]}},"response":[],"_postman_id":"43033d87-22f2-4f81-b33a-1c9a2b2e27df"}],"id":"03d0514d-c20f-47d9-868d-2c9f40b8ee0d","_postman_id":"03d0514d-c20f-47d9-868d-2c9f40b8ee0d","description":""},{"name":"枚举清单","item":[{"name":"对外物料枚举清单（公开只读，免鉴权）","id":"19b5a814-9a0d-49e4-a39f-6964bde4c439","request":{"method":"GET","header":[],"url":"https://api.ai-mcn.tv:10000/catalog","description":"<p>对外物料枚举清单（公开只读，免鉴权）\n一次返回全部对外枚举的版本化集合，按域分节：TTS（音色 / 输出格式 / 切分方式）、\n音乐可视化模板、字幕（语种 / 各任务类型的识别源语种 / 样式 / 颜色）、语音识别语种、\n任务可用性（临时下架集合）、抠像、人声分离、口播节奏预设、工程文件格式、智能分镜模式、插帧倍数。\n字幕语种分两层读：<code>subtitle.languages</code> 是字幕类任务共同的语种范围，翻译目标语按它取值；\n识别源语种（<code>language</code> 参数）各任务类型可用面不同，以 <code>subtitle.source_languages</code>\n里对应任务类型的列表为准。<code>asr.languages</code> 是语音识别（<code>/asr</code>）的识别语种。\n每个分节都从<strong>服务端校验所用的同一个常量</strong>取数，不存在第二份手抄清单 ——\n也就是说：服务端接受什么，这里就是什么。\n<code>catalog_version</code> 由内容派生（任一枚举变化则必变，无人工维护）；HTTP <code>ETag</code> 同源。\n带 <code>If-None-Match</code> 且内容未变时回 304 空体，消费端复用本地快照。\n消费方契约：拉取成功即落地本地快照；<strong>拉不到用最后一次成功的快照，不要直接失败</strong>；\n完全无快照时放行到服务端校验兜底 —— 服务端白名单恒为唯一真相源。</p>\n<p>operationId: <code>getEnumCatalog</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 枚举清单。<code>schema</code> 是载荷结构版本（字段怎么排，人工 bump）； <code>catalog_version</code> 是内容摘要（内容变即变）。两者含义不同，消费方先看 <code>schema</code>。</li>\n<li>304: 内容未变（命中 If-None-Match），空体</li>\n</ul>\n","urlObject":{"path":["catalog"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"19b5a814-9a0d-49e4-a39f-6964bde4c439"}],"id":"30d6b481-4fa8-4f58-b562-5bc9aa4e1e7e","_postman_id":"30d6b481-4fa8-4f58-b562-5bc9aa4e1e7e","description":""},{"name":"素材向量化","item":[{"name":"通用素材向量化（对外接口，同步返回，按张计费）","id":"06a01195-2075-4bc3-bc6a-e8f49acd339f","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"input\": [\n    {}\n  ],\n  \"normalized\": true,\n  \"task\": \"<string>\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/material_embed","description":"<p>通用素材向量化（对外接口，同步返回，按张计费）\n对文本 / base64 图像 / 已上传文件 file_id（可混批）做 jina-clip-v2 向量化，同步返回满\n1024 维 normalized 向量（float 数组），与云端素材矩阵同语义空间。<strong>每请求同步计费\n（无会话机制）</strong>：图像 0.1 积分/张（base64 与 file_id 形态同等按张计费）、按请求整体\n四舍五入取整且有图最低 1 积分（16 张→2 积分、4 张→1 积分）；纯文本请求免费；同合云内部\n成员豁免零计费；余额/配额不足返回 402（前置拒绝，不触上游不扣费）；响应携 task_id 计费\n留痕可查。批量索引场景请改用 CLI 条（/task/cli/embed，会话计量计费）。注意：模型懒加载 +\n空闲逐出，<strong>逐出后的首个请求可能慢（分钟级冷启动）</strong>，客户端超时请 ≥180s。限制：单请求\n≤16 图或 ≤64 文本（file_id 图像计入图数上限）、base64 单图解码后 ≤1MB、file_id 单图\n≤10MB（两形态分开限制）、按 key 60 请求/分钟（值可配置）；超限整单拒绝、明示上限，\n不部分处理。鉴权：Authorization 头直传 API Key。</p>\n<p>operationId: <code>createMaterialEmbed</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 向量化成功（响应携 task_id 计费留痕）</li>\n<li>400: 参数错误 / 超批（错误码 6030，错误信息明示上限）；file_id 指向非图片类型文件报 6014</li>\n<li>401: 鉴权失败</li>\n<li>402: 余额/配额不足（错误码 6201/6202，前置拒绝，不触上游不扣费）</li>\n<li>404: file_id 文件不存在或不属于当前用户（错误码 6004，两情形同码不泄露存在性）</li>\n<li>413: 单张图片超过字节上限（错误码 6031，文案区分形态：base64 形态解码后 ≤1MB、 file_id 形态 ≤10MB）</li>\n<li>429: 触发按 key 频率限流（错误码 6032），请稍后重试</li>\n<li>6401: 上游 model-rpc 不可用（不扣费）</li>\n<li>6402: 上游 model-rpc 超时（含冷启动超限，不扣费）</li>\n</ul>\n","urlObject":{"path":["task","material_embed"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"06a01195-2075-4bc3-bc6a-e8f49acd339f"}],"id":"345a4e2d-7275-4546-b95d-97f330ab76db","_postman_id":"345a4e2d-7275-4546-b95d-97f330ab76db","description":""},{"name":"素材检索","item":[{"name":"原片直链重签（对外客户接口，同步返回，免费无限次）","id":"6856791e-98c1-4021-89e7-f98315863b88","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"clip_ids\": [\n    \"537489015178247\",\n    \"537489015178248\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/material_resign","description":"<p>原片直链重签（对外客户接口，同步返回，免费无限次）\n对<strong>付费检索过</strong>(授予账本命中)且仍在库可见的素材, 批量重签原片下载直链(nginx secure_link 新鲜签名)。\n授予门对所有档位统一: 只要该素材出现在你任一次计费检索(含 0 元 custom 域双口)的返回中即持久授予、\n无限重签; 未购/下架素材逐条进 missing 报因、不连坐其余。免费、非计费任务(不产生任务记录)。\n鉴权: Authorization 头传 API Key。</p>\n<p>operationId: <code>materialResign</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 重签成功(逐条结果)</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>6401: 上游重签服务不可用</li>\n</ul>\n","urlObject":{"path":["task","material_resign"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"6856791e-98c1-4021-89e7-f98315863b88"},{"name":"普通素材搜索（对外客户接口，同步返回，按次计费）","id":"270a36a5-ce48-415d-b5ae-6112d4b41771","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"scope\": \"clip\",\n  \"query\": \"城市夜景航拍\",\n  \"top_k\": 20,\n  \"diversity\": false,\n  \"request_id\": \"<string>\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/material_search","description":"<p>普通素材搜索（对外客户接口，同步返回，按次计费）\n按自然语言/关键词检索素材(视频/图片/音频三态),返回下载向结果:每条含带签名的原始素材下载直链\ndownload_url、预览(cover/thumb/preview)、规格、note、tags;固定只检索有版权素材。<strong>同步返回(非异步任务)<strong>。\n计费: 每次成功查询按 task_type <code>material_search</code> 计费一次(与条数无关), 响应携 task_id 留痕可查;\n成功检索的素材获</strong>持久授予</strong>(可经 /task/material_resign 免费无限重签原片直链); 检索失败不扣费。\n余额/配额不足返回 402。鉴权:Authorization 头传 API Key。</p>\n<p>operationId: <code>publicMaterialSearch</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 检索成功(响应携 task_id)</li>\n<li>400: 参数错误</li>\n<li>401: 鉴权失败</li>\n<li>402: 余额/配额不足(前置拒绝, 不触上游不扣费)</li>\n<li>6401: 上游检索服务不可用(不扣费)</li>\n</ul>\n","urlObject":{"path":["task","material_search"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"270a36a5-ce48-415d-b5ae-6112d4b41771"}],"id":"da7e1702-4ea6-4d04-9cbe-d04d8e8e4fab","_postman_id":"da7e1702-4ea6-4d04-9cbe-d04d8e8e4fab","description":""},{"name":"素材理解","item":[{"name":"通用素材理解（异步任务提交，按张计费）","id":"9572a89a-452f-4114-aba7-ad51cb007f9c","request":{"method":"POST","header":[{"key":"Authorization","value":"<your-api-key>"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"input\": [\n    {}\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ai-mcn.tv:10000/task/material_describe","description":"<p>通用素材理解（异步任务提交，按张计费）\n对 base64 图像 / 已上传文件 file_id（可混批）创建豆包 VLM 理解<strong>异步任务</strong>：提交立即\n返回 task_id（状态 queued），随后轮询 GET /task/material_describe/ 至\nstatus=completed，从 output_result 取逐图对位结果——desc（简体中文 ≤200 字）、\ntags（3-8 个检索向标签）、mark（0-100 质量分）与 usable_flags 可用性信号（watermark\n水印 / text_overlay 烧录字幕 / black_border 黑边 / blurry 模糊——「像但不能用」检测，\n缺失按 false 兜底；信号供调用方结合 desc 复核，非硬门禁），以及镜头卡片四维\n（2026-08-28 宽松超集扩展，旧字段语义不变零回归）：subject 主体 / action 动作 /\nshot_size 景别（特写|中景|全景|远景）/ highlight 看点度（0-100，衡量画面对短视频观众的\n吸引力：视觉显著性、信息密度、情绪强度、稀缺性）。与「通用素材向量化」\n(/task/material_embed) 配套：向量化管「找相似」，理解管「看清楚能不能用」。帧图经\n同合云基础设施临时中转供理解模型访问，<strong>即传即弃</strong>（任务完成即清理，不留存）。\n限制：单请求 ≤32 张（仅收图像，text 形态拒绝）、base64 单图解码后 ≤1MB、file_id 单图\n≤10MB（两形态分开限制，提交时校验）、按 key 30 请求/分钟（独立配额，值可配置）；\n超限整单拒绝、明示上限，不部分处理。计费：<strong>1 积分/张</strong>（base64 与 file_id 形态同等\n按张计费），提交时预扣、任务完成结算；任一图理解失败则整任务失败并全额退款（重试\n耗尽后，不留半账）；同合云内部成员豁免零计费；余额/配额不足返回 402（前置拒绝，\n不建任务不扣费）。鉴权：Authorization 头直传 API Key。</p>\n<p>operationId: <code>createMaterialDescribe</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 任务创建成功（data.task_id 为任务 ID 字符串，状态 queued；轮询 GET /task/material_describe/ 取结果）</li>\n<li>400: 参数错误 / text 形态（本接口仅收图像）/ 超批（错误码 6030，错误信息明示 32 张上限）； file_id 指向非图片类型文件报 6014</li>\n<li>401: 鉴权失败</li>\n<li>402: 余额/配额不足（错误码 6201，前置拒绝，不建任务不扣费）</li>\n<li>404: file_id 文件不存在或不属于当前用户（错误码 6004，两情形同码不泄露存在性）</li>\n<li>413: 单张图片超过字节上限（错误码 6031，文案区分形态：base64 形态解码后 ≤1MB、 file_id 形态 ≤10MB）</li>\n<li>429: 触发按 key 频率限流（错误码 6032，独立配额默认 30 请求/分钟），请稍后重试</li>\n</ul>\n","urlObject":{"path":["task","material_describe"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9572a89a-452f-4114-aba7-ad51cb007f9c"},{"name":"查询通用素材理解任务结果","id":"efa6344b-8724-4c34-a442-0a4c5d4a7aac","request":{"method":"GET","header":[{"key":"Authorization","value":"<your-api-key>"}],"url":"https://api.ai-mcn.tv:10000/task/material_describe/537489015178247","description":"<p>查询通用素材理解任务结果\n轮询本接口至 status=completed 后从 output_result 取逐图对位结果；status=failed 表示\n任务失败（预扣积分已全额退款），output_result 记错误信息。</p>\n<p>operationId: <code>getMaterialDescribeTask</code></p>\n<p>响应说明:</p>\n<ul>\n<li>200: 查询成功</li>\n<li>401: 鉴权失败</li>\n<li>404: 任务不存在或不属于当前用户</li>\n</ul>\n","urlObject":{"path":["task","material_describe","537489015178247"],"host":["https://api.ai-mcn.tv:10000"],"query":[],"variable":[]}},"response":[],"_postman_id":"efa6344b-8724-4c34-a442-0a4c5d4a7aac"}],"id":"d49b33e0-1874-4c5a-bf78-47378c93ab75","_postman_id":"d49b33e0-1874-4c5a-bf78-47378c93ab75","description":""}],"variable":[{"key":"baseUrl","value":"https://api.ai-mcn.tv:10000","type":"string"},{"key":"authorization","value":"<your-api-key>","type":"string"},{"key":"file_id","value":"537489015178246","type":"string"},{"key":"file_id_2","value":"537489015178247","type":"string"},{"key":"task_id","value":"537489015178247","type":"string"}]}