[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-models\u002Fvideo\u002Fminimax":202},[4,26,43,105,177,194,198],{"title":5,"path":6,"stem":7,"children":8,"page":25},"快速开始","\u002Fgetting-started","1.getting-started",[9,13,17,21],{"title":10,"path":11,"stem":12},"首次调用千木 API","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F1.quick-start",{"title":14,"path":15,"stem":16},"模型选择","\u002Fgetting-started\u002Fmodel-selection","1.getting-started\u002F2.model-selection",{"title":18,"path":19,"stem":20},"限流","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F3.rate-limits",{"title":22,"path":23,"stem":24},"常见问题","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq",false,{"title":27,"path":28,"stem":29,"children":30,"page":25},"产品计费","\u002Fbilling","2.billing",[31,35,39],{"title":32,"path":33,"stem":34},"计费说明","\u002Fbilling\u002Foverview","2.billing\u002F1.overview",{"title":36,"path":37,"stem":38},"在线充值","\u002Fbilling\u002Frecharge","2.billing\u002F2.recharge",{"title":40,"path":41,"stem":42},"账单、用量与导出","\u002Fbilling\u002Fusage-export","2.billing\u002F3.usage-export",{"title":44,"path":45,"stem":46,"children":47,"page":25},"Coding Plan","\u002Fcoding-plan","3.coding-plan",[48,52,56,60,67,102],{"title":49,"path":50,"stem":51},"Coding Plan 概述","\u002Fcoding-plan\u002Foverview","3.coding-plan\u002F1.overview",{"title":53,"path":54,"stem":55},"快速接入","\u002Fcoding-plan\u002Fquick-start","3.coding-plan\u002F2.quick-start",{"title":57,"path":58,"stem":59},"使用须知","\u002Fcoding-plan\u002Fusage-notes","3.coding-plan\u002F3.usage-notes",{"title":61,"path":62,"stem":63,"children":64},"个人版","\u002Fcoding-plan\u002Fpersonal","3.coding-plan\u002F4.personal\u002Findex",[65],{"title":66,"path":62,"stem":63},"价格和权益",{"title":68,"path":69,"stem":70,"children":71,"page":-1},"开发指南","\u002Fcoding-plan\u002Fguide","3.coding-plan\u002F5.guide\u002Findex",[72,74,78,82,86,90,94,98],{"title":73,"path":69,"stem":70},"端点与协议",{"title":75,"path":76,"stem":77},"Claude Code","\u002Fcoding-plan\u002Fguide\u002Fclaude-code","3.coding-plan\u002F5.guide\u002F1.claude-code",{"title":79,"path":80,"stem":81},"OpenCode","\u002Fcoding-plan\u002Fguide\u002Fopencode","3.coding-plan\u002F5.guide\u002F2.opencode",{"title":83,"path":84,"stem":85},"Cursor","\u002Fcoding-plan\u002Fguide\u002Fcursor","3.coding-plan\u002F5.guide\u002F3.cursor",{"title":87,"path":88,"stem":89},"Codex","\u002Fcoding-plan\u002Fguide\u002Fcodex","3.coding-plan\u002F5.guide\u002F4.codex",{"title":91,"path":92,"stem":93},"ZCode","\u002Fcoding-plan\u002Fguide\u002Fzcode","3.coding-plan\u002F5.guide\u002F5.zcode",{"title":95,"path":96,"stem":97},"TRAE","\u002Fcoding-plan\u002Fguide\u002Ftrae","3.coding-plan\u002F5.guide\u002F6.trae",{"title":99,"path":100,"stem":101},"CodeBuddy","\u002Fcoding-plan\u002Fguide\u002Fcodebuddy","3.coding-plan\u002F5.guide\u002F7.codebuddy",{"title":22,"path":103,"stem":104},"\u002Fcoding-plan\u002Ffaq","3.coding-plan\u002F6.faq",{"title":106,"path":107,"stem":108,"children":109,"page":25},"模型接口","\u002Fmodels","4.models",[110,135,147],{"title":111,"path":112,"stem":113,"children":114,"page":25},"文本生成API","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[115,119,123,127,131],{"title":116,"path":117,"stem":118},"概述","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":120,"path":121,"stem":122},"OpenAI 兼容接口","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":124,"path":125,"stem":126},"Anthropic 兼容","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":128,"path":129,"stem":130},"Volcengine 兼容","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":132,"path":133,"stem":134},"多模态输入","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F5.multimodal",{"title":136,"path":137,"stem":138,"children":139,"page":25},"图片生成API","\u002Fmodels\u002Fimages","4.models\u002F2.images",[140,143],{"title":116,"path":141,"stem":142},"\u002Fmodels\u002Fimages\u002Foverview","4.models\u002F2.images\u002F1.overview",{"title":144,"path":145,"stem":146},"图片生成接口","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":148,"path":149,"stem":150,"children":151,"page":-1},"视频生成模型","\u002Fmodels\u002Fvideo","4.models\u002F3.video\u002Findex",[152,153,157,161,165,169,173],{"title":148,"path":149,"stem":150},{"title":154,"path":155,"stem":156},"视频生成 API","\u002Fmodels\u002Fvideo\u002Foverview","4.models\u002F3.video\u002F1.overview",{"title":158,"path":159,"stem":160},"素材管理","\u002Fmodels\u002Fvideo\u002Fassets","4.models\u002F3.video\u002F2.assets",{"title":162,"path":163,"stem":164},"素材选用指南","\u002Fmodels\u002Fvideo\u002Fmaterial-guide","4.models\u002F3.video\u002F3.material-guide",{"title":166,"path":167,"stem":168},"人像认证（真人活体认证）","\u002Fmodels\u002Fvideo\u002Fliveness-verification","4.models\u002F3.video\u002F4.liveness-verification",{"title":170,"path":171,"stem":172},"OmniHuman 1.5","\u002Fmodels\u002Fvideo\u002Fomni-human","4.models\u002F3.video\u002F5.omni-human",{"title":174,"path":175,"stem":176},"MiniMax H3 视频生成","\u002Fmodels\u002Fvideo\u002Fminimax","4.models\u002F3.video\u002F6.minimax",{"title":178,"path":179,"stem":180,"children":181,"page":25},"用量与余额API","\u002Fusage-and-balance","5.usage-and-balance",[182,186,190],{"title":183,"path":184,"stem":185},"查询余额","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":187,"path":188,"stem":189},"查询用量","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":191,"path":192,"stem":193},"查询单次请求消耗","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":195,"path":196,"stem":197},"错误码参考","\u002Ferrors","6.errors",{"title":199,"path":200,"stem":201},"开始使用 SilvaMux","\u002F","index",{"id":203,"title":174,"body":204,"description":1518,"extension":1519,"meta":1520,"navigation":850,"path":175,"rawbody":1521,"requiredFlags":1522,"seo":1523,"stem":176,"__hash__":1524},"docs\u002F4.models\u002F3.video\u002F6.minimax.md",{"type":205,"value":206,"toc":1503},"minimark",[207,211,229,239,243,246,314,321,324,493,500,589,608,611,687,706,709,950,953,976,978,1007,1014,1147,1164,1168,1312,1322,1325,1354,1362,1365,1375,1384,1390,1393,1396,1404,1407,1411,1493,1499],[208,209,174],"h1",{"id":210},"minimax-h3-视频生成",[212,213,214,215,219,220,224,225,228],"p",{},"MiniMax H3 系列走 ",[216,217,218],"strong",{},"MiniMax 原生异步接口","（",[221,222,223],"code",{},"\u002Fapi\u002Fv2","），与火山 Seedance 形态（",[221,226,227],{},"\u002Fapi\u002Fv3","）并存。两者都是「创建任务 → 轮询状态 → 取结果」，区别在路径、字段名和计费方式。",[230,231,232],"blockquote",{},[212,233,234,235,238],{},"MiniMax 视频按",[216,236,237],{},"秒","计费（不同分辨率每秒单价不同），不是按 token。",[240,241,242],"h2",{"id":242},"模型与分辨率",[212,244,245],{},"H3 系列各变体支持的分辨率不同，实际可用档位以模型详情页定价为准：",[247,248,249,265],"table",{},[250,251,252],"thead",{},[253,254,255,259,262],"tr",{},[256,257,258],"th",{},"模型",[256,260,261],{},"支持分辨率",[256,263,264],{},"说明",[266,267,268,280,291,301],"tbody",{},[253,269,270,274,277],{},[271,272,273],"td",{},"MiniMax-H3",[271,275,276],{},"768P \u002F 2K",[271,278,279],{},"标准档，支持 2K",[253,281,282,285,288],{},[271,283,284],{},"H3-Highspeed",[271,286,287],{},"480P \u002F 768P",[271,289,290],{},"速度优先",[253,292,293,296,298],{},[271,294,295],{},"H3-Lite",[271,297,287],{},[271,299,300],{},"成本优先",[253,302,303,306,308],{},[271,304,305],{},"H3-Max",[271,307,287],{},[271,309,310,311],{},"质量优先，",[216,312,313],{},"最短 5 秒",[212,315,316,317,320],{},"传入模型不支持的 ",[221,318,319],{},"resolution"," 会直接返回 400，不会提交到上游。",[240,322,323],{"id":323},"关键参数",[247,325,326,341],{},[250,327,328],{},[253,329,330,333,336,339],{},[256,331,332],{},"参数",[256,334,335],{},"类型",[256,337,338],{},"必填",[256,340,264],{},[266,342,343,359,381,407,422,460,475],{},[253,344,345,350,353,356],{},[271,346,347],{},[221,348,349],{},"model",[271,351,352],{},"string",[271,354,355],{},"是",[271,357,358],{},"模型调用名，从模型广场或模型列表获取",[253,360,361,366,369,371],{},[271,362,363],{},[221,364,365],{},"content",[271,367,368],{},"array",[271,370,355],{},[271,372,373,374],{},"输入内容，",[216,375,376,377,380],{},"必须含至少一个非空 ",[221,378,379],{},"text"," 项",[253,382,383,387,389,391],{},[271,384,385],{},[221,386,319],{},[271,388,352],{},[271,390,355],{},[271,392,393,396,397,400,401,396,404,406],{},[221,394,395],{},"768P"," \u002F ",[221,398,399],{},"2K"," 或 ",[221,402,403],{},"480P",[221,405,395],{},"，取决于模型",[253,408,409,414,417,419],{},[271,410,411],{},[221,412,413],{},"duration",[271,415,416],{},"integer",[271,418,355],{},[271,420,421],{},"输出时长（秒），4～15（H3-Max 最短 5）",[253,423,424,429,431,434],{},[271,425,426],{},[221,427,428],{},"ratio",[271,430,352],{},[271,432,433],{},"条件",[271,435,436,396,439,396,442,396,445,396,448,396,451,396,454,457,458],{},[221,437,438],{},"adaptive",[221,440,441],{},"21:9",[221,443,444],{},"16:9",[221,446,447],{},"4:3",[221,449,450],{},"1:1",[221,452,453],{},"3:4",[221,455,456],{},"9:16","；文生视频必填且不能 ",[221,459,438],{},[253,461,462,467,469,472],{},[271,463,464],{},[221,465,466],{},"callback_url",[271,468,352],{},[271,470,471],{},"否",[271,473,474],{},"任务终态回调地址（平台在任务完成时 POST 结果到该地址）",[253,476,477,482,485,487],{},[271,478,479],{},[221,480,481],{},"aigc_watermark",[271,483,484],{},"boolean",[271,486,471],{},[271,488,489,490],{},"是否加水印，默认 ",[221,491,492],{},"false",[494,495,497,499],"h3",{"id":496},"content-元素",[221,498,365],{}," 元素",[247,501,502,513],{},[250,503,504],{},[253,505,506,509,511],{},[256,507,508],{},"字段",[256,510,335],{},[256,512,264],{},[266,514,515,537,551,563],{},[253,516,517,522,524],{},[271,518,519],{},[221,520,521],{},"type",[271,523,352],{},[271,525,526,396,528,396,531,396,534],{},[221,527,379],{},[221,529,530],{},"image_url",[221,532,533],{},"video_url",[221,535,536],{},"audio_url",[253,538,539,543,545],{},[271,540,541],{},[221,542,379],{},[271,544,352],{},[271,546,547,550],{},[221,548,549],{},"type=text"," 时必填",[253,552,553,558,560],{},[271,554,555],{},[221,556,557],{},"image_url.url",[271,559,352],{},[271,561,562],{},"公网 URL",[253,564,565,570,572],{},[271,566,567],{},[221,568,569],{},"role",[271,571,352],{},[271,573,574,396,577,396,580,396,583,396,586],{},[221,575,576],{},"first_frame",[221,578,579],{},"last_frame",[221,581,582],{},"reference_image",[221,584,585],{},"reference_video",[221,587,588],{},"reference_audio",[230,590,591],{},[212,592,593,594,596,597,599,600,603,604,607],{},"首尾帧（",[221,595,576],{}," + ",[221,598,579],{},"）与参考生（",[221,601,602],{},"reference_*","）",[216,605,606],{},"不能混用","。",[240,609,610],{"id":610},"接口一览",[247,612,613,626],{},[250,614,615],{},[253,616,617,620,623],{},[256,618,619],{},"操作",[256,621,622],{},"方法",[256,624,625],{},"路径",[266,627,628,643,658,672],{},[253,629,630,633,638],{},[271,631,632],{},"创建任务",[271,634,635],{},[221,636,637],{},"POST",[271,639,640],{},[221,641,642],{},"\u002Fapi\u002Fv2\u002Fvideo_generation",[253,644,645,648,653],{},[271,646,647],{},"查询任务",[271,649,650],{},[221,651,652],{},"GET",[271,654,655],{},[221,656,657],{},"\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F{task_id}",[253,659,660,663,667],{},[271,661,662],{},"任务列表",[271,664,665],{},[221,666,652],{},[271,668,669],{},[221,670,671],{},"\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation",[253,673,674,677,682],{},[271,675,676],{},"取消\u002F删除",[271,678,679],{},[221,680,681],{},"DELETE",[271,683,684],{},[221,685,686],{},"\u002Fapi\u002Fv2\u002Fvideo_generation\u002F{task_id}",[212,688,689,690,693,694,693,697,396,700,396,703,607],{},"任务状态：",[221,691,692],{},"queued"," → ",[221,695,696],{},"running",[221,698,699],{},"succeeded",[221,701,702],{},"failed",[221,704,705],{},"cancelled",[240,707,708],{"id":708},"文生视频",[710,711,712,821],"code-tabs",{},[713,714,716],"code-tab",{"label":715},"cURL",[717,718,723],"pre",{"className":719,"code":720,"language":721,"meta":722,"style":722},"language-bash shiki shiki-themes github-light github-dark","curl -X POST https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"\u003CMODEL_CALL_NAME>\",\n    \"content\": [{\"type\": \"text\", \"text\": \"一只金毛犬在海滩上奔跑，电影感\"}],\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"ratio\": \"16:9\"\n  }'\n","bash","",[221,724,725,748,766,776,785,791,797,803,809,815],{"__ignoreMap":722},[726,727,730,734,738,742,745],"span",{"class":728,"line":729},"line",1,[726,731,733],{"class":732},"sScJk","curl",[726,735,737],{"class":736},"sj4cs"," -X",[726,739,741],{"class":740},"sZZnC"," POST",[726,743,744],{"class":740}," https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation",[726,746,747],{"class":736}," \\\n",[726,749,751,754,757,761,764],{"class":728,"line":750},2,[726,752,753],{"class":736},"  -H",[726,755,756],{"class":740}," \"Authorization: Bearer ",[726,758,760],{"class":759},"sVt8B","$SILVAMUX_API_KEY",[726,762,763],{"class":740},"\"",[726,765,747],{"class":736},[726,767,769,771,774],{"class":728,"line":768},3,[726,770,753],{"class":736},[726,772,773],{"class":740}," \"Content-Type: application\u002Fjson\"",[726,775,747],{"class":736},[726,777,779,782],{"class":728,"line":778},4,[726,780,781],{"class":736},"  -d",[726,783,784],{"class":740}," '{\n",[726,786,788],{"class":728,"line":787},5,[726,789,790],{"class":740},"    \"model\": \"\u003CMODEL_CALL_NAME>\",\n",[726,792,794],{"class":728,"line":793},6,[726,795,796],{"class":740},"    \"content\": [{\"type\": \"text\", \"text\": \"一只金毛犬在海滩上奔跑，电影感\"}],\n",[726,798,800],{"class":728,"line":799},7,[726,801,802],{"class":740},"    \"resolution\": \"768P\",\n",[726,804,806],{"class":728,"line":805},8,[726,807,808],{"class":740},"    \"duration\": 5,\n",[726,810,812],{"class":728,"line":811},9,[726,813,814],{"class":740},"    \"ratio\": \"16:9\"\n",[726,816,818],{"class":728,"line":817},10,[726,819,820],{"class":740},"  }'\n",[713,822,824],{"label":823},"Python",[717,825,829],{"className":826,"code":827,"language":828,"meta":722,"style":722},"language-python shiki shiki-themes github-light github-dark","import json\nimport os\nimport urllib.request\n\npayload = {\n    \"model\": \"\u003CMODEL_CALL_NAME>\",\n    \"content\": [{\"type\": \"text\", \"text\": \"一只金毛犬在海滩上奔跑，电影感\"}],\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"ratio\": \"16:9\",\n}\nrequest = urllib.request.Request(\n    \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\",\n    data=json.dumps(payload).encode(\"utf-8\"),\n    headers={\n        \"Authorization\": \"Bearer \" + os.environ[\"SILVAMUX_API_KEY\"],\n        \"Content-Type\": \"application\u002Fjson\",\n    },\n    method=\"POST\",\n)\nwith urllib.request.urlopen(request) as response:\n    print(response.read().decode(\"utf-8\"))\n","python",[221,830,831,836,841,846,852,857,861,865,869,873,878,884,890,896,902,908,914,920,926,932,938,944],{"__ignoreMap":722},[726,832,833],{"class":728,"line":729},[726,834,835],{},"import json\n",[726,837,838],{"class":728,"line":750},[726,839,840],{},"import os\n",[726,842,843],{"class":728,"line":768},[726,844,845],{},"import urllib.request\n",[726,847,848],{"class":728,"line":778},[726,849,851],{"emptyLinePlaceholder":850},true,"\n",[726,853,854],{"class":728,"line":787},[726,855,856],{},"payload = {\n",[726,858,859],{"class":728,"line":793},[726,860,790],{},[726,862,863],{"class":728,"line":799},[726,864,796],{},[726,866,867],{"class":728,"line":805},[726,868,802],{},[726,870,871],{"class":728,"line":811},[726,872,808],{},[726,874,875],{"class":728,"line":817},[726,876,877],{},"    \"ratio\": \"16:9\",\n",[726,879,881],{"class":728,"line":880},11,[726,882,883],{},"}\n",[726,885,887],{"class":728,"line":886},12,[726,888,889],{},"request = urllib.request.Request(\n",[726,891,893],{"class":728,"line":892},13,[726,894,895],{},"    \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\",\n",[726,897,899],{"class":728,"line":898},14,[726,900,901],{},"    data=json.dumps(payload).encode(\"utf-8\"),\n",[726,903,905],{"class":728,"line":904},15,[726,906,907],{},"    headers={\n",[726,909,911],{"class":728,"line":910},16,[726,912,913],{},"        \"Authorization\": \"Bearer \" + os.environ[\"SILVAMUX_API_KEY\"],\n",[726,915,917],{"class":728,"line":916},17,[726,918,919],{},"        \"Content-Type\": \"application\u002Fjson\",\n",[726,921,923],{"class":728,"line":922},18,[726,924,925],{},"    },\n",[726,927,929],{"class":728,"line":928},19,[726,930,931],{},"    method=\"POST\",\n",[726,933,935],{"class":728,"line":934},20,[726,936,937],{},")\n",[726,939,941],{"class":728,"line":940},21,[726,942,943],{},"with urllib.request.urlopen(request) as response:\n",[726,945,947],{"class":728,"line":946},22,[726,948,949],{},"    print(response.read().decode(\"utf-8\"))\n",[212,951,952],{},"创建成功返回：",[717,954,958],{"className":955,"code":956,"language":957,"meta":722,"style":722},"language-json shiki shiki-themes github-light github-dark","{\"task_id\": \"462160194171102\"}\n","json",[221,959,960],{"__ignoreMap":722},[726,961,962,965,968,971,974],{"class":728,"line":729},[726,963,964],{"class":759},"{",[726,966,967],{"class":736},"\"task_id\"",[726,969,970],{"class":759},": ",[726,972,973],{"class":740},"\"462160194171102\"",[726,975,883],{"class":759},[240,977,647],{"id":647},[710,979,980],{},[713,981,982],{"label":715},[717,983,985],{"className":719,"code":984,"language":721,"meta":722,"style":722},"curl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F\u003CTASK_ID>\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n",[221,986,987,996],{"__ignoreMap":722},[726,988,989,991,994],{"class":728,"line":729},[726,990,733],{"class":732},[726,992,993],{"class":740}," \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F\u003CTASK_ID>\"",[726,995,747],{"class":736},[726,997,998,1000,1002,1004],{"class":728,"line":750},[726,999,753],{"class":736},[726,1001,756],{"class":740},[726,1003,760],{"class":759},[726,1005,1006],{"class":740},"\"\n",[212,1008,1009,1010,1013],{},"成功时响应包一层 ",[221,1011,1012],{},"task","：",[717,1015,1017],{"className":955,"code":1016,"language":957,"meta":722,"style":722},"{\n  \"task\": {\n    \"id\": \"462160194171102\",\n    \"model\": \"\u003CMODEL_CALL_NAME>\",\n    \"status\": \"succeeded\",\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"content\": { \"url\": \"https:\u002F\u002F...\" },\n    \"usage\": { \"total_seconds\": 5, \"output_seconds\": 5 }\n  }\n}\n",[221,1018,1019,1024,1032,1044,1056,1068,1080,1092,1111,1138,1143],{"__ignoreMap":722},[726,1020,1021],{"class":728,"line":729},[726,1022,1023],{"class":759},"{\n",[726,1025,1026,1029],{"class":728,"line":750},[726,1027,1028],{"class":736},"  \"task\"",[726,1030,1031],{"class":759},": {\n",[726,1033,1034,1037,1039,1041],{"class":728,"line":768},[726,1035,1036],{"class":736},"    \"id\"",[726,1038,970],{"class":759},[726,1040,973],{"class":740},[726,1042,1043],{"class":759},",\n",[726,1045,1046,1049,1051,1054],{"class":728,"line":778},[726,1047,1048],{"class":736},"    \"model\"",[726,1050,970],{"class":759},[726,1052,1053],{"class":740},"\"\u003CMODEL_CALL_NAME>\"",[726,1055,1043],{"class":759},[726,1057,1058,1061,1063,1066],{"class":728,"line":787},[726,1059,1060],{"class":736},"    \"status\"",[726,1062,970],{"class":759},[726,1064,1065],{"class":740},"\"succeeded\"",[726,1067,1043],{"class":759},[726,1069,1070,1073,1075,1078],{"class":728,"line":793},[726,1071,1072],{"class":736},"    \"resolution\"",[726,1074,970],{"class":759},[726,1076,1077],{"class":740},"\"768P\"",[726,1079,1043],{"class":759},[726,1081,1082,1085,1087,1090],{"class":728,"line":799},[726,1083,1084],{"class":736},"    \"duration\"",[726,1086,970],{"class":759},[726,1088,1089],{"class":736},"5",[726,1091,1043],{"class":759},[726,1093,1094,1097,1100,1103,1105,1108],{"class":728,"line":805},[726,1095,1096],{"class":736},"    \"content\"",[726,1098,1099],{"class":759},": { ",[726,1101,1102],{"class":736},"\"url\"",[726,1104,970],{"class":759},[726,1106,1107],{"class":740},"\"https:\u002F\u002F...\"",[726,1109,1110],{"class":759}," },\n",[726,1112,1113,1116,1118,1121,1123,1125,1128,1131,1133,1135],{"class":728,"line":811},[726,1114,1115],{"class":736},"    \"usage\"",[726,1117,1099],{"class":759},[726,1119,1120],{"class":736},"\"total_seconds\"",[726,1122,970],{"class":759},[726,1124,1089],{"class":736},[726,1126,1127],{"class":759},", ",[726,1129,1130],{"class":736},"\"output_seconds\"",[726,1132,970],{"class":759},[726,1134,1089],{"class":736},[726,1136,1137],{"class":759}," }\n",[726,1139,1140],{"class":728,"line":817},[726,1141,1142],{"class":759},"  }\n",[726,1144,1145],{"class":728,"line":880},[726,1146,883],{"class":759},[1148,1149,1150,1158],"ul",{},[1151,1152,1153,1154,1157],"li",{},"产物地址在 ",[221,1155,1156],{},"task.content.url","，有时效，成功后请尽快下载。",[1151,1159,1160,1161,607],{},"计费秒数在 ",[221,1162,1163],{},"task.usage.total_seconds",[240,1165,1167],{"id":1166},"首帧图生-参考生","首帧图生 \u002F 参考生",[717,1169,1171],{"className":955,"code":1170,"language":957,"meta":722,"style":722},"{\n  \"model\": \"\u003CMODEL_CALL_NAME>\",\n  \"content\": [\n    {\"type\": \"text\", \"text\": \"镜头缓缓拉远，蒸汽增多\"},\n    {\n      \"type\": \"image_url\",\n      \"image_url\": {\"url\": \"https:\u002F\u002Fexample.com\u002Ffirst.png\"},\n      \"role\": \"first_frame\"\n    }\n  ],\n  \"resolution\": \"2K\",\n  \"duration\": 5,\n  \"ratio\": \"adaptive\"\n}\n",[221,1172,1173,1177,1188,1196,1221,1226,1238,1255,1265,1270,1275,1287,1298,1308],{"__ignoreMap":722},[726,1174,1175],{"class":728,"line":729},[726,1176,1023],{"class":759},[726,1178,1179,1182,1184,1186],{"class":728,"line":750},[726,1180,1181],{"class":736},"  \"model\"",[726,1183,970],{"class":759},[726,1185,1053],{"class":740},[726,1187,1043],{"class":759},[726,1189,1190,1193],{"class":728,"line":768},[726,1191,1192],{"class":736},"  \"content\"",[726,1194,1195],{"class":759},": [\n",[726,1197,1198,1201,1204,1206,1209,1211,1213,1215,1218],{"class":728,"line":778},[726,1199,1200],{"class":759},"    {",[726,1202,1203],{"class":736},"\"type\"",[726,1205,970],{"class":759},[726,1207,1208],{"class":740},"\"text\"",[726,1210,1127],{"class":759},[726,1212,1208],{"class":736},[726,1214,970],{"class":759},[726,1216,1217],{"class":740},"\"镜头缓缓拉远，蒸汽增多\"",[726,1219,1220],{"class":759},"},\n",[726,1222,1223],{"class":728,"line":787},[726,1224,1225],{"class":759},"    {\n",[726,1227,1228,1231,1233,1236],{"class":728,"line":793},[726,1229,1230],{"class":736},"      \"type\"",[726,1232,970],{"class":759},[726,1234,1235],{"class":740},"\"image_url\"",[726,1237,1043],{"class":759},[726,1239,1240,1243,1246,1248,1250,1253],{"class":728,"line":799},[726,1241,1242],{"class":736},"      \"image_url\"",[726,1244,1245],{"class":759},": {",[726,1247,1102],{"class":736},[726,1249,970],{"class":759},[726,1251,1252],{"class":740},"\"https:\u002F\u002Fexample.com\u002Ffirst.png\"",[726,1254,1220],{"class":759},[726,1256,1257,1260,1262],{"class":728,"line":805},[726,1258,1259],{"class":736},"      \"role\"",[726,1261,970],{"class":759},[726,1263,1264],{"class":740},"\"first_frame\"\n",[726,1266,1267],{"class":728,"line":811},[726,1268,1269],{"class":759},"    }\n",[726,1271,1272],{"class":728,"line":817},[726,1273,1274],{"class":759},"  ],\n",[726,1276,1277,1280,1282,1285],{"class":728,"line":880},[726,1278,1279],{"class":736},"  \"resolution\"",[726,1281,970],{"class":759},[726,1283,1284],{"class":740},"\"2K\"",[726,1286,1043],{"class":759},[726,1288,1289,1292,1294,1296],{"class":728,"line":886},[726,1290,1291],{"class":736},"  \"duration\"",[726,1293,970],{"class":759},[726,1295,1089],{"class":736},[726,1297,1043],{"class":759},[726,1299,1300,1303,1305],{"class":728,"line":892},[726,1301,1302],{"class":736},"  \"ratio\"",[726,1304,970],{"class":759},[726,1306,1307],{"class":740},"\"adaptive\"\n",[726,1309,1310],{"class":728,"line":898},[726,1311,883],{"class":759},[212,1313,1314,1315,396,1317,396,1319,1321],{},"参考生（",[221,1316,582],{},[221,1318,585],{},[221,1320,588],{},"）最多 9 图、3 视频、3 音频，音频不能单独出现。",[240,1323,1324],{"id":1324},"取消任务",[717,1326,1328],{"className":719,"code":1327,"language":721,"meta":722,"style":722},"curl -X DELETE \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\u002F\u003CTASK_ID>\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n",[221,1329,1330,1344],{"__ignoreMap":722},[726,1331,1332,1334,1336,1339,1342],{"class":728,"line":729},[726,1333,733],{"class":732},[726,1335,737],{"class":736},[726,1337,1338],{"class":740}," DELETE",[726,1340,1341],{"class":740}," \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\u002F\u003CTASK_ID>\"",[726,1343,747],{"class":736},[726,1345,1346,1348,1350,1352],{"class":728,"line":750},[726,1347,753],{"class":736},[726,1349,756],{"class":740},[726,1351,760],{"class":759},[726,1353,1006],{"class":740},[212,1355,1356,1358,1359,1361],{},[221,1357,692],{}," 状态的任务取消不收费用（预扣金额全额退回）。已进入 ",[221,1360,696],{}," 的任务上游不允许取消。",[240,1363,1364],{"id":1364},"结果回调",[212,1366,1367,1368,1370,1371,1374],{},"传入 ",[221,1369,466],{}," 后，任务进入终态时平台会向该地址 POST 结果，body 与查询接口同构（",[221,1372,1373],{},"{\"task\": {...}}","）。",[230,1376,1377],{},[212,1378,1379,1380,1383],{},"用户的回调地址由平台代理接收后再转发，",[216,1381,1382],{},"不需要","实现 MiniMax 官方的 challenge 握手。",[212,1385,1386,1387,1389],{},"未传 ",[221,1388,466],{}," 时可自行轮询查询接口，平台内部也有轮询兜底。",[240,1391,1392],{"id":1392},"计费",[212,1394,1395],{},"按输出视频秒数计费，每秒单价因分辨率档位而异。例：",[1148,1397,1398,1401],{},[1151,1399,1400],{},"768P 5 秒 × 单价",[1151,1402,1403],{},"2K 5 秒 × 单价（更高档位）",[212,1405,1406],{},"实际单价见模型详情页价格表或控制台定价页。",[240,1408,1410],{"id":1409},"与火山-seedance-的区别","与火山 Seedance 的区别",[247,1412,1413,1426],{},[250,1414,1415],{},[253,1416,1417,1420,1423],{},[256,1418,1419],{},"项",[256,1421,1422],{},"MiniMax H3",[256,1424,1425],{},"火山 Seedance",[266,1427,1428,1442,1457,1469,1483],{},[253,1429,1430,1433,1437],{},[271,1431,1432],{},"创建路径",[271,1434,1435],{},[221,1436,642],{},[271,1438,1439],{},[221,1440,1441],{},"\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks",[253,1443,1444,1447,1452],{},[271,1445,1446],{},"创建响应",[271,1448,1449],{},[221,1450,1451],{},"{\"task_id\": ...}",[271,1453,1454],{},[221,1455,1456],{},"{\"id\": ...}",[253,1458,1459,1462,1466],{},[271,1460,1461],{},"查询响应",[271,1463,1464],{},[221,1465,1373],{},[271,1467,1468],{},"裸任务对象",[253,1470,1471,1474,1478],{},[271,1472,1473],{},"产物字段",[271,1475,1476],{},[221,1477,1156],{},[271,1479,1480],{},[221,1481,1482],{},"content.video_url",[253,1484,1485,1487,1490],{},[271,1486,1392],{},[271,1488,1489],{},"按秒（分辨率分档）",[271,1491,1492],{},"按 token",[212,1494,1495,1496,1498],{},"两套接口并存，任务彼此隔离：",[221,1497,227],{}," 的任务列表不含 MiniMax 任务，反之亦然。",[1500,1501,1502],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":722,"searchDepth":750,"depth":750,"links":1504},[1505,1506,1510,1511,1512,1513,1514,1515,1516,1517],{"id":242,"depth":750,"text":242},{"id":323,"depth":750,"text":323,"children":1507},[1508],{"id":496,"depth":768,"text":1509},"content 元素",{"id":610,"depth":750,"text":610},{"id":708,"depth":750,"text":708},{"id":647,"depth":750,"text":647},{"id":1166,"depth":750,"text":1167},{"id":1324,"depth":750,"text":1324},{"id":1364,"depth":750,"text":1364},{"id":1392,"depth":750,"text":1392},{"id":1409,"depth":750,"text":1410},"使用 MiniMax H3 系列模型生成视频：创建任务、查询结果、分辨率与计费说明。","md",{},"---\ntitle: MiniMax H3 视频生成\ndescription: 使用 MiniMax H3 系列模型生成视频：创建任务、查询结果、分辨率与计费说明。\n---\n\n# MiniMax H3 视频生成\n\nMiniMax H3 系列走 **MiniMax 原生异步接口**（`\u002Fapi\u002Fv2`），与火山 Seedance 形态（`\u002Fapi\u002Fv3`）并存。两者都是「创建任务 → 轮询状态 → 取结果」，区别在路径、字段名和计费方式。\n\n> MiniMax 视频按**秒**计费（不同分辨率每秒单价不同），不是按 token。\n\n## 模型与分辨率\n\nH3 系列各变体支持的分辨率不同，实际可用档位以模型详情页定价为准：\n\n| 模型 | 支持分辨率 | 说明 |\n| --- | --- | --- |\n| MiniMax-H3 | 768P \u002F 2K | 标准档，支持 2K |\n| H3-Highspeed | 480P \u002F 768P | 速度优先 |\n| H3-Lite | 480P \u002F 768P | 成本优先 |\n| H3-Max | 480P \u002F 768P | 质量优先，**最短 5 秒** |\n\n传入模型不支持的 `resolution` 会直接返回 400，不会提交到上游。\n\n## 关键参数\n\n| 参数 | 类型 | 必填 | 说明 |\n| --- | --- | --- | --- |\n| `model` | string | 是 | 模型调用名，从模型广场或模型列表获取 |\n| `content` | array | 是 | 输入内容，**必须含至少一个非空 `text` 项** |\n| `resolution` | string | 是 | `768P` \u002F `2K` 或 `480P` \u002F `768P`，取决于模型 |\n| `duration` | integer | 是 | 输出时长（秒），4～15（H3-Max 最短 5） |\n| `ratio` | string | 条件 | `adaptive` \u002F `21:9` \u002F `16:9` \u002F `4:3` \u002F `1:1` \u002F `3:4` \u002F `9:16`；文生视频必填且不能 `adaptive` |\n| `callback_url` | string | 否 | 任务终态回调地址（平台在任务完成时 POST 结果到该地址） |\n| `aigc_watermark` | boolean | 否 | 是否加水印，默认 `false` |\n\n### `content` 元素\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `type` | string | `text` \u002F `image_url` \u002F `video_url` \u002F `audio_url` |\n| `text` | string | `type=text` 时必填 |\n| `image_url.url` | string | 公网 URL |\n| `role` | string | `first_frame` \u002F `last_frame` \u002F `reference_image` \u002F `reference_video` \u002F `reference_audio` |\n\n> 首尾帧（`first_frame` + `last_frame`）与参考生（`reference_*`）**不能混用**。\n\n## 接口一览\n\n| 操作 | 方法 | 路径 |\n| --- | --- | --- |\n| 创建任务 | `POST` | `\u002Fapi\u002Fv2\u002Fvideo_generation` |\n| 查询任务 | `GET` | `\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F{task_id}` |\n| 任务列表 | `GET` | `\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation` |\n| 取消\u002F删除 | `DELETE` | `\u002Fapi\u002Fv2\u002Fvideo_generation\u002F{task_id}` |\n\n任务状态：`queued` → `running` → `succeeded` \u002F `failed` \u002F `cancelled`。\n\n## 文生视频\n\n::code-tabs\n:::code-tab{label=\"cURL\"}\n```bash\ncurl -X POST https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"\u003CMODEL_CALL_NAME>\",\n    \"content\": [{\"type\": \"text\", \"text\": \"一只金毛犬在海滩上奔跑，电影感\"}],\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"ratio\": \"16:9\"\n  }'\n```\n:::\n:::code-tab{label=\"Python\"}\n```python\nimport json\nimport os\nimport urllib.request\n\npayload = {\n    \"model\": \"\u003CMODEL_CALL_NAME>\",\n    \"content\": [{\"type\": \"text\", \"text\": \"一只金毛犬在海滩上奔跑，电影感\"}],\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"ratio\": \"16:9\",\n}\nrequest = urllib.request.Request(\n    \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\",\n    data=json.dumps(payload).encode(\"utf-8\"),\n    headers={\n        \"Authorization\": \"Bearer \" + os.environ[\"SILVAMUX_API_KEY\"],\n        \"Content-Type\": \"application\u002Fjson\",\n    },\n    method=\"POST\",\n)\nwith urllib.request.urlopen(request) as response:\n    print(response.read().decode(\"utf-8\"))\n```\n:::\n::\n\n创建成功返回：\n\n```json\n{\"task_id\": \"462160194171102\"}\n```\n\n## 查询任务\n\n::code-tabs\n:::code-tab{label=\"cURL\"}\n```bash\ncurl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F\u003CTASK_ID>\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n```\n:::\n::\n\n成功时响应包一层 `task`：\n\n```json\n{\n  \"task\": {\n    \"id\": \"462160194171102\",\n    \"model\": \"\u003CMODEL_CALL_NAME>\",\n    \"status\": \"succeeded\",\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"content\": { \"url\": \"https:\u002F\u002F...\" },\n    \"usage\": { \"total_seconds\": 5, \"output_seconds\": 5 }\n  }\n}\n```\n\n- 产物地址在 `task.content.url`，有时效，成功后请尽快下载。\n- 计费秒数在 `task.usage.total_seconds`。\n\n## 首帧图生 \u002F 参考生\n\n```json\n{\n  \"model\": \"\u003CMODEL_CALL_NAME>\",\n  \"content\": [\n    {\"type\": \"text\", \"text\": \"镜头缓缓拉远，蒸汽增多\"},\n    {\n      \"type\": \"image_url\",\n      \"image_url\": {\"url\": \"https:\u002F\u002Fexample.com\u002Ffirst.png\"},\n      \"role\": \"first_frame\"\n    }\n  ],\n  \"resolution\": \"2K\",\n  \"duration\": 5,\n  \"ratio\": \"adaptive\"\n}\n```\n\n参考生（`reference_image` \u002F `reference_video` \u002F `reference_audio`）最多 9 图、3 视频、3 音频，音频不能单独出现。\n\n## 取消任务\n\n```bash\ncurl -X DELETE \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\u002F\u003CTASK_ID>\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n```\n\n`queued` 状态的任务取消不收费用（预扣金额全额退回）。已进入 `running` 的任务上游不允许取消。\n\n## 结果回调\n\n传入 `callback_url` 后，任务进入终态时平台会向该地址 POST 结果，body 与查询接口同构（`{\"task\": {...}}`）。\n\n> 用户的回调地址由平台代理接收后再转发，**不需要**实现 MiniMax 官方的 challenge 握手。\n\n未传 `callback_url` 时可自行轮询查询接口，平台内部也有轮询兜底。\n\n## 计费\n\n按输出视频秒数计费，每秒单价因分辨率档位而异。例：\n\n- 768P 5 秒 × 单价\n- 2K 5 秒 × 单价（更高档位）\n\n实际单价见模型详情页价格表或控制台定价页。\n\n## 与火山 Seedance 的区别\n\n| 项 | MiniMax H3 | 火山 Seedance |\n| --- | --- | --- |\n| 创建路径 | `\u002Fapi\u002Fv2\u002Fvideo_generation` | `\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks` |\n| 创建响应 | `{\"task_id\": ...}` | `{\"id\": ...}` |\n| 查询响应 | `{\"task\": {...}}` | 裸任务对象 |\n| 产物字段 | `task.content.url` | `content.video_url` |\n| 计费 | 按秒（分辨率分档） | 按 token |\n\n两套接口并存，任务彼此隔离：`\u002Fapi\u002Fv3` 的任务列表不含 MiniMax 任务，反之亦然。\n",[],{"title":174,"description":1518},"YtfWGRrW7XA_tIU73tgBCoQYElReR20gxeoI3WDq1AA"]