[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-en":3,"docs-en-models\u002Fvideo\u002Fminimax":202},[4,26,43,105,177,194,198],{"title":5,"path":6,"stem":7,"children":8,"page":25},"Getting Started","\u002Fgetting-started","1.getting-started",[9,13,17,21],{"title":10,"path":11,"stem":12},"Your First SilvaMux API Call","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F1.quick-start",{"title":14,"path":15,"stem":16},"Model Selection","\u002Fgetting-started\u002Fmodel-selection","1.getting-started\u002F2.model-selection",{"title":18,"path":19,"stem":20},"Rate Limits","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F3.rate-limits",{"title":22,"path":23,"stem":24},"FAQ","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq",false,{"title":27,"path":28,"stem":29,"children":30,"page":25},"Billing","\u002Fbilling","2.billing",[31,35,39],{"title":32,"path":33,"stem":34},"Billing Overview","\u002Fbilling\u002Foverview","2.billing\u002F1.overview",{"title":36,"path":37,"stem":38},"Online Top-up","\u002Fbilling\u002Frecharge","2.billing\u002F2.recharge",{"title":40,"path":41,"stem":42},"Bills, Usage & Exports","\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 Overview","\u002Fcoding-plan\u002Foverview","3.coding-plan\u002F1.overview",{"title":53,"path":54,"stem":55},"Quick Start","\u002Fcoding-plan\u002Fquick-start","3.coding-plan\u002F2.quick-start",{"title":57,"path":58,"stem":59},"Usage Notes","\u002Fcoding-plan\u002Fusage-notes","3.coding-plan\u002F3.usage-notes",{"title":61,"path":62,"stem":63,"children":64},"Personal","\u002Fcoding-plan\u002Fpersonal","3.coding-plan\u002F4.personal\u002Findex",[65],{"title":66,"path":62,"stem":63},"Pricing & Benefits",{"title":68,"path":69,"stem":70,"children":71,"page":-1},"Developer Guide","\u002Fcoding-plan\u002Fguide","3.coding-plan\u002F5.guide\u002Findex",[72,74,78,82,86,90,94,98],{"title":73,"path":69,"stem":70},"Endpoints & Protocols",{"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},"Model APIs","\u002Fmodels","4.models",[110,135,147],{"title":111,"path":112,"stem":113,"children":114,"page":25},"Text Generation Model API","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[115,119,123,127,131],{"title":116,"path":117,"stem":118},"Overview","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":120,"path":121,"stem":122},"OpenAI Compatible API","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":124,"path":125,"stem":126},"Anthropic Compatible","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":128,"path":129,"stem":130},"Volcengine Compatible","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":132,"path":133,"stem":134},"Multimodal Input","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F5.multimodal",{"title":136,"path":137,"stem":138,"children":139,"page":25},"Image Generation Model 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},"Image Generation API","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":148,"path":149,"stem":150,"children":151,"page":-1},"Video Generation Models","\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},"Video Generation API","\u002Fmodels\u002Fvideo\u002Foverview","4.models\u002F3.video\u002F1.overview",{"title":158,"path":159,"stem":160},"Asset Management","\u002Fmodels\u002Fvideo\u002Fassets","4.models\u002F3.video\u002F2.assets",{"title":162,"path":163,"stem":164},"Asset Selection Guide","\u002Fmodels\u002Fvideo\u002Fmaterial-guide","4.models\u002F3.video\u002F3.material-guide",{"title":166,"path":167,"stem":168},"Liveness Verification","\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 Video Generation","\u002Fmodels\u002Fvideo\u002Fminimax","4.models\u002F3.video\u002F6.minimax",{"title":178,"path":179,"stem":180,"children":181,"page":25},"Usage & Balance","\u002Fusage-and-balance","5.usage-and-balance",[182,186,190],{"title":183,"path":184,"stem":185},"Query Balance","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":187,"path":188,"stem":189},"Query Usage","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":191,"path":192,"stem":193},"Query Request Usage","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":195,"path":196,"stem":197},"Error Codes","\u002Ferrors","6.errors",{"title":199,"path":200,"stem":201},"Getting Started with SilvaMux","\u002F","index",{"id":203,"title":174,"body":204,"description":1527,"extension":1528,"meta":1529,"navigation":855,"path":175,"rawbody":1530,"requiredFlags":1531,"seo":1532,"stem":176,"__hash__":1533},"docs_en\u002F4.models\u002F3.video\u002F6.minimax.md",{"type":205,"value":206,"toc":1512},"minimark",[207,211,229,239,244,247,315,322,326,496,503,592,611,615,691,710,714,955,958,981,985,1014,1021,1154,1171,1175,1319,1329,1333,1362,1370,1374,1384,1393,1399,1402,1405,1413,1416,1420,1502,1508],[208,209,174],"h1",{"id":210},"minimax-h3-video-generation",[212,213,214,215,219,220,224,225,228],"p",{},"The MiniMax H3 series uses the ",[216,217,218],"strong",{},"MiniMax native async API"," (",[221,222,223],"code",{},"\u002Fapi\u002Fv2","), alongside the Volcengine Seedance shape (",[221,226,227],{},"\u002Fapi\u002Fv3","). Both follow \"create task → poll status → read result\", but differ in paths, field names, and billing.",[230,231,232],"blockquote",{},[212,233,234,235,238],{},"MiniMax video is billed ",[216,236,237],{},"per second"," (per-second price depends on resolution), not per token.",[240,241,243],"h2",{"id":242},"models-and-resolutions","Models and resolutions",[212,245,246],{},"Each H3 variant supports different resolutions. The available tiers are determined by the pricing configured for the model:",[248,249,250,266],"table",{},[251,252,253],"thead",{},[254,255,256,260,263],"tr",{},[257,258,259],"th",{},"Model",[257,261,262],{},"Supported resolutions",[257,264,265],{},"Notes",[267,268,269,281,292,302],"tbody",{},[254,270,271,275,278],{},[272,273,274],"td",{},"MiniMax-H3",[272,276,277],{},"768P \u002F 2K",[272,279,280],{},"Standard, supports 2K",[254,282,283,286,289],{},[272,284,285],{},"H3-Highspeed",[272,287,288],{},"480P \u002F 768P",[272,290,291],{},"Speed first",[254,293,294,297,299],{},[272,295,296],{},"H3-Lite",[272,298,288],{},[272,300,301],{},"Cost first",[254,303,304,307,309],{},[272,305,306],{},"H3-Max",[272,308,288],{},[272,310,311,312],{},"Quality first, ",[216,313,314],{},"minimum 5 seconds",[212,316,317,318,321],{},"Passing an unsupported ",[221,319,320],{},"resolution"," returns 400 immediately without submitting to the upstream.",[240,323,325],{"id":324},"key-parameters","Key parameters",[248,327,328,344],{},[251,329,330],{},[254,331,332,335,338,341],{},[257,333,334],{},"Parameter",[257,336,337],{},"Type",[257,339,340],{},"Required",[257,342,343],{},"Description",[267,345,346,362,384,410,425,463,478],{},[254,347,348,353,356,359],{},[272,349,350],{},[221,351,352],{},"model",[272,354,355],{},"string",[272,357,358],{},"Yes",[272,360,361],{},"Model call name from the Model Plaza or model list",[254,363,364,369,372,374],{},[272,365,366],{},[221,367,368],{},"content",[272,370,371],{},"array",[272,373,358],{},[272,375,376,377],{},"Input content; ",[216,378,379,380,383],{},"must contain at least one non-empty ",[221,381,382],{},"text"," item",[254,385,386,390,392,394],{},[272,387,388],{},[221,389,320],{},[272,391,355],{},[272,393,358],{},[272,395,396,399,400,403,404,399,407,409],{},[221,397,398],{},"768P"," \u002F ",[221,401,402],{},"2K"," or ",[221,405,406],{},"480P",[221,408,398],{}," depending on the model",[254,411,412,417,420,422],{},[272,413,414],{},[221,415,416],{},"duration",[272,418,419],{},"integer",[272,421,358],{},[272,423,424],{},"Output duration in seconds, 4–15 (H3-Max minimum 5)",[254,426,427,432,434,437],{},[272,428,429],{},[221,430,431],{},"ratio",[272,433,355],{},[272,435,436],{},"Conditional",[272,438,439,399,442,399,445,399,448,399,451,399,454,399,457,460,461],{},[221,440,441],{},"adaptive",[221,443,444],{},"21:9",[221,446,447],{},"16:9",[221,449,450],{},"4:3",[221,452,453],{},"1:1",[221,455,456],{},"3:4",[221,458,459],{},"9:16","; required for text-to-video and cannot be ",[221,462,441],{},[254,464,465,470,472,475],{},[272,466,467],{},[221,468,469],{},"callback_url",[272,471,355],{},[272,473,474],{},"No",[272,476,477],{},"Terminal-state callback URL (platform POSTs the result when the task finishes)",[254,479,480,485,488,490],{},[272,481,482],{},[221,483,484],{},"aigc_watermark",[272,486,487],{},"boolean",[272,489,474],{},[272,491,492,493],{},"Whether to add a watermark, default ",[221,494,495],{},"false",[497,498,500,502],"h3",{"id":499},"content-items",[221,501,368],{}," items",[248,504,505,516],{},[251,506,507],{},[254,508,509,512,514],{},[257,510,511],{},"Field",[257,513,337],{},[257,515,343],{},[267,517,518,540,554,566],{},[254,519,520,525,527],{},[272,521,522],{},[221,523,524],{},"type",[272,526,355],{},[272,528,529,399,531,399,534,399,537],{},[221,530,382],{},[221,532,533],{},"image_url",[221,535,536],{},"video_url",[221,538,539],{},"audio_url",[254,541,542,546,548],{},[272,543,544],{},[221,545,382],{},[272,547,355],{},[272,549,550,551],{},"Required when ",[221,552,553],{},"type=text",[254,555,556,561,563],{},[272,557,558],{},[221,559,560],{},"image_url.url",[272,562,355],{},[272,564,565],{},"Public URL",[254,567,568,573,575],{},[272,569,570],{},[221,571,572],{},"role",[272,574,355],{},[272,576,577,399,580,399,583,399,586,399,589],{},[221,578,579],{},"first_frame",[221,581,582],{},"last_frame",[221,584,585],{},"reference_image",[221,587,588],{},"reference_video",[221,590,591],{},"reference_audio",[230,593,594],{},[212,595,596,597,599,600,602,603,606,607,610],{},"First\u002Flast frame (",[221,598,579],{}," + ",[221,601,582],{},") and reference generation (",[221,604,605],{},"reference_*",") ",[216,608,609],{},"cannot be mixed",".",[240,612,614],{"id":613},"endpoints","Endpoints",[248,616,617,630],{},[251,618,619],{},[254,620,621,624,627],{},[257,622,623],{},"Operation",[257,625,626],{},"Method",[257,628,629],{},"Path",[267,631,632,647,662,676],{},[254,633,634,637,642],{},[272,635,636],{},"Create task",[272,638,639],{},[221,640,641],{},"POST",[272,643,644],{},[221,645,646],{},"\u002Fapi\u002Fv2\u002Fvideo_generation",[254,648,649,652,657],{},[272,650,651],{},"Query task",[272,653,654],{},[221,655,656],{},"GET",[272,658,659],{},[221,660,661],{},"\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F{task_id}",[254,663,664,667,671],{},[272,665,666],{},"List tasks",[272,668,669],{},[221,670,656],{},[272,672,673],{},[221,674,675],{},"\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation",[254,677,678,681,686],{},[272,679,680],{},"Cancel\u002Fdelete",[272,682,683],{},[221,684,685],{},"DELETE",[272,687,688],{},[221,689,690],{},"\u002Fapi\u002Fv2\u002Fvideo_generation\u002F{task_id}",[212,692,693,694,697,698,697,701,399,704,399,707,610],{},"Task status: ",[221,695,696],{},"queued"," → ",[221,699,700],{},"running",[221,702,703],{},"succeeded",[221,705,706],{},"failed",[221,708,709],{},"cancelled",[240,711,713],{"id":712},"text-to-video","Text to video",[715,716,717,826],"code-tabs",{},[718,719,721],"code-tab",{"label":720},"cURL",[722,723,728],"pre",{"className":724,"code":725,"language":726,"meta":727,"style":727},"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\": \"A golden retriever running on the beach, cinematic\"}],\n    \"resolution\": \"768P\",\n    \"duration\": 5,\n    \"ratio\": \"16:9\"\n  }'\n","bash","",[221,729,730,753,771,781,790,796,802,808,814,820],{"__ignoreMap":727},[731,732,735,739,743,747,750],"span",{"class":733,"line":734},"line",1,[731,736,738],{"class":737},"sScJk","curl",[731,740,742],{"class":741},"sj4cs"," -X",[731,744,746],{"class":745},"sZZnC"," POST",[731,748,749],{"class":745}," https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation",[731,751,752],{"class":741}," \\\n",[731,754,756,759,762,766,769],{"class":733,"line":755},2,[731,757,758],{"class":741},"  -H",[731,760,761],{"class":745}," \"Authorization: Bearer ",[731,763,765],{"class":764},"sVt8B","$SILVAMUX_API_KEY",[731,767,768],{"class":745},"\"",[731,770,752],{"class":741},[731,772,774,776,779],{"class":733,"line":773},3,[731,775,758],{"class":741},[731,777,778],{"class":745}," \"Content-Type: application\u002Fjson\"",[731,780,752],{"class":741},[731,782,784,787],{"class":733,"line":783},4,[731,785,786],{"class":741},"  -d",[731,788,789],{"class":745}," '{\n",[731,791,793],{"class":733,"line":792},5,[731,794,795],{"class":745},"    \"model\": \"\u003CMODEL_CALL_NAME>\",\n",[731,797,799],{"class":733,"line":798},6,[731,800,801],{"class":745},"    \"content\": [{\"type\": \"text\", \"text\": \"A golden retriever running on the beach, cinematic\"}],\n",[731,803,805],{"class":733,"line":804},7,[731,806,807],{"class":745},"    \"resolution\": \"768P\",\n",[731,809,811],{"class":733,"line":810},8,[731,812,813],{"class":745},"    \"duration\": 5,\n",[731,815,817],{"class":733,"line":816},9,[731,818,819],{"class":745},"    \"ratio\": \"16:9\"\n",[731,821,823],{"class":733,"line":822},10,[731,824,825],{"class":745},"  }'\n",[718,827,829],{"label":828},"Python",[722,830,834],{"className":831,"code":832,"language":833,"meta":727,"style":727},"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\": \"A golden retriever running on the beach, cinematic\"}],\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,835,836,841,846,851,857,862,866,870,874,878,883,889,895,901,907,913,919,925,931,937,943,949],{"__ignoreMap":727},[731,837,838],{"class":733,"line":734},[731,839,840],{},"import json\n",[731,842,843],{"class":733,"line":755},[731,844,845],{},"import os\n",[731,847,848],{"class":733,"line":773},[731,849,850],{},"import urllib.request\n",[731,852,853],{"class":733,"line":783},[731,854,856],{"emptyLinePlaceholder":855},true,"\n",[731,858,859],{"class":733,"line":792},[731,860,861],{},"payload = {\n",[731,863,864],{"class":733,"line":798},[731,865,795],{},[731,867,868],{"class":733,"line":804},[731,869,801],{},[731,871,872],{"class":733,"line":810},[731,873,807],{},[731,875,876],{"class":733,"line":816},[731,877,813],{},[731,879,880],{"class":733,"line":822},[731,881,882],{},"    \"ratio\": \"16:9\",\n",[731,884,886],{"class":733,"line":885},11,[731,887,888],{},"}\n",[731,890,892],{"class":733,"line":891},12,[731,893,894],{},"request = urllib.request.Request(\n",[731,896,898],{"class":733,"line":897},13,[731,899,900],{},"    \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\",\n",[731,902,904],{"class":733,"line":903},14,[731,905,906],{},"    data=json.dumps(payload).encode(\"utf-8\"),\n",[731,908,910],{"class":733,"line":909},15,[731,911,912],{},"    headers={\n",[731,914,916],{"class":733,"line":915},16,[731,917,918],{},"        \"Authorization\": \"Bearer \" + os.environ[\"SILVAMUX_API_KEY\"],\n",[731,920,922],{"class":733,"line":921},17,[731,923,924],{},"        \"Content-Type\": \"application\u002Fjson\",\n",[731,926,928],{"class":733,"line":927},18,[731,929,930],{},"    },\n",[731,932,934],{"class":733,"line":933},19,[731,935,936],{},"    method=\"POST\",\n",[731,938,940],{"class":733,"line":939},20,[731,941,942],{},")\n",[731,944,946],{"class":733,"line":945},21,[731,947,948],{},"with urllib.request.urlopen(request) as response:\n",[731,950,952],{"class":733,"line":951},22,[731,953,954],{},"    print(response.read().decode(\"utf-8\"))\n",[212,956,957],{},"Successful creation responds:",[722,959,963],{"className":960,"code":961,"language":962,"meta":727,"style":727},"language-json shiki shiki-themes github-light github-dark","{\"task_id\": \"462160194171102\"}\n","json",[221,964,965],{"__ignoreMap":727},[731,966,967,970,973,976,979],{"class":733,"line":734},[731,968,969],{"class":764},"{",[731,971,972],{"class":741},"\"task_id\"",[731,974,975],{"class":764},": ",[731,977,978],{"class":745},"\"462160194171102\"",[731,980,888],{"class":764},[240,982,984],{"id":983},"query-a-task","Query a task",[715,986,987],{},[718,988,989],{"label":720},[722,990,992],{"className":724,"code":991,"language":726,"meta":727,"style":727},"curl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F\u003CTASK_ID>\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n",[221,993,994,1003],{"__ignoreMap":727},[731,995,996,998,1001],{"class":733,"line":734},[731,997,738],{"class":737},[731,999,1000],{"class":745}," \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F\u003CTASK_ID>\"",[731,1002,752],{"class":741},[731,1004,1005,1007,1009,1011],{"class":733,"line":755},[731,1006,758],{"class":741},[731,1008,761],{"class":745},[731,1010,765],{"class":764},[731,1012,1013],{"class":745},"\"\n",[212,1015,1016,1017,1020],{},"A successful response wraps the payload in ",[221,1018,1019],{},"task",":",[722,1022,1024],{"className":960,"code":1023,"language":962,"meta":727,"style":727},"{\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,1025,1026,1031,1039,1051,1063,1075,1087,1099,1118,1145,1150],{"__ignoreMap":727},[731,1027,1028],{"class":733,"line":734},[731,1029,1030],{"class":764},"{\n",[731,1032,1033,1036],{"class":733,"line":755},[731,1034,1035],{"class":741},"  \"task\"",[731,1037,1038],{"class":764},": {\n",[731,1040,1041,1044,1046,1048],{"class":733,"line":773},[731,1042,1043],{"class":741},"    \"id\"",[731,1045,975],{"class":764},[731,1047,978],{"class":745},[731,1049,1050],{"class":764},",\n",[731,1052,1053,1056,1058,1061],{"class":733,"line":783},[731,1054,1055],{"class":741},"    \"model\"",[731,1057,975],{"class":764},[731,1059,1060],{"class":745},"\"\u003CMODEL_CALL_NAME>\"",[731,1062,1050],{"class":764},[731,1064,1065,1068,1070,1073],{"class":733,"line":792},[731,1066,1067],{"class":741},"    \"status\"",[731,1069,975],{"class":764},[731,1071,1072],{"class":745},"\"succeeded\"",[731,1074,1050],{"class":764},[731,1076,1077,1080,1082,1085],{"class":733,"line":798},[731,1078,1079],{"class":741},"    \"resolution\"",[731,1081,975],{"class":764},[731,1083,1084],{"class":745},"\"768P\"",[731,1086,1050],{"class":764},[731,1088,1089,1092,1094,1097],{"class":733,"line":804},[731,1090,1091],{"class":741},"    \"duration\"",[731,1093,975],{"class":764},[731,1095,1096],{"class":741},"5",[731,1098,1050],{"class":764},[731,1100,1101,1104,1107,1110,1112,1115],{"class":733,"line":810},[731,1102,1103],{"class":741},"    \"content\"",[731,1105,1106],{"class":764},": { ",[731,1108,1109],{"class":741},"\"url\"",[731,1111,975],{"class":764},[731,1113,1114],{"class":745},"\"https:\u002F\u002F...\"",[731,1116,1117],{"class":764}," },\n",[731,1119,1120,1123,1125,1128,1130,1132,1135,1138,1140,1142],{"class":733,"line":816},[731,1121,1122],{"class":741},"    \"usage\"",[731,1124,1106],{"class":764},[731,1126,1127],{"class":741},"\"total_seconds\"",[731,1129,975],{"class":764},[731,1131,1096],{"class":741},[731,1133,1134],{"class":764},", ",[731,1136,1137],{"class":741},"\"output_seconds\"",[731,1139,975],{"class":764},[731,1141,1096],{"class":741},[731,1143,1144],{"class":764}," }\n",[731,1146,1147],{"class":733,"line":822},[731,1148,1149],{"class":764},"  }\n",[731,1151,1152],{"class":733,"line":885},[731,1153,888],{"class":764},[1155,1156,1157,1165],"ul",{},[1158,1159,1160,1161,1164],"li",{},"The artifact URL lives at ",[221,1162,1163],{},"task.content.url",", expires, so download it promptly.",[1158,1166,1167,1168,610],{},"Billed seconds are in ",[221,1169,1170],{},"task.usage.total_seconds",[240,1172,1174],{"id":1173},"first-frame-and-reference-generation","First-frame and reference generation",[722,1176,1178],{"className":960,"code":1177,"language":962,"meta":727,"style":727},"{\n  \"model\": \"\u003CMODEL_CALL_NAME>\",\n  \"content\": [\n    {\"type\": \"text\", \"text\": \"The camera pulls back slowly as steam rises\"},\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,1179,1180,1184,1195,1203,1228,1233,1245,1262,1272,1277,1282,1294,1305,1315],{"__ignoreMap":727},[731,1181,1182],{"class":733,"line":734},[731,1183,1030],{"class":764},[731,1185,1186,1189,1191,1193],{"class":733,"line":755},[731,1187,1188],{"class":741},"  \"model\"",[731,1190,975],{"class":764},[731,1192,1060],{"class":745},[731,1194,1050],{"class":764},[731,1196,1197,1200],{"class":733,"line":773},[731,1198,1199],{"class":741},"  \"content\"",[731,1201,1202],{"class":764},": [\n",[731,1204,1205,1208,1211,1213,1216,1218,1220,1222,1225],{"class":733,"line":783},[731,1206,1207],{"class":764},"    {",[731,1209,1210],{"class":741},"\"type\"",[731,1212,975],{"class":764},[731,1214,1215],{"class":745},"\"text\"",[731,1217,1134],{"class":764},[731,1219,1215],{"class":741},[731,1221,975],{"class":764},[731,1223,1224],{"class":745},"\"The camera pulls back slowly as steam rises\"",[731,1226,1227],{"class":764},"},\n",[731,1229,1230],{"class":733,"line":792},[731,1231,1232],{"class":764},"    {\n",[731,1234,1235,1238,1240,1243],{"class":733,"line":798},[731,1236,1237],{"class":741},"      \"type\"",[731,1239,975],{"class":764},[731,1241,1242],{"class":745},"\"image_url\"",[731,1244,1050],{"class":764},[731,1246,1247,1250,1253,1255,1257,1260],{"class":733,"line":804},[731,1248,1249],{"class":741},"      \"image_url\"",[731,1251,1252],{"class":764},": {",[731,1254,1109],{"class":741},[731,1256,975],{"class":764},[731,1258,1259],{"class":745},"\"https:\u002F\u002Fexample.com\u002Ffirst.png\"",[731,1261,1227],{"class":764},[731,1263,1264,1267,1269],{"class":733,"line":810},[731,1265,1266],{"class":741},"      \"role\"",[731,1268,975],{"class":764},[731,1270,1271],{"class":745},"\"first_frame\"\n",[731,1273,1274],{"class":733,"line":816},[731,1275,1276],{"class":764},"    }\n",[731,1278,1279],{"class":733,"line":822},[731,1280,1281],{"class":764},"  ],\n",[731,1283,1284,1287,1289,1292],{"class":733,"line":885},[731,1285,1286],{"class":741},"  \"resolution\"",[731,1288,975],{"class":764},[731,1290,1291],{"class":745},"\"2K\"",[731,1293,1050],{"class":764},[731,1295,1296,1299,1301,1303],{"class":733,"line":891},[731,1297,1298],{"class":741},"  \"duration\"",[731,1300,975],{"class":764},[731,1302,1096],{"class":741},[731,1304,1050],{"class":764},[731,1306,1307,1310,1312],{"class":733,"line":897},[731,1308,1309],{"class":741},"  \"ratio\"",[731,1311,975],{"class":764},[731,1313,1314],{"class":745},"\"adaptive\"\n",[731,1316,1317],{"class":733,"line":903},[731,1318,888],{"class":764},[212,1320,1321,1322,399,1324,399,1326,1328],{},"Reference generation (",[221,1323,585],{},[221,1325,588],{},[221,1327,591],{},") supports up to 9 images, 3 videos, and 3 audio clips; audio cannot appear alone.",[240,1330,1332],{"id":1331},"cancel-a-task","Cancel a task",[722,1334,1336],{"className":724,"code":1335,"language":726,"meta":727,"style":727},"curl -X DELETE \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\u002F\u003CTASK_ID>\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n",[221,1337,1338,1352],{"__ignoreMap":727},[731,1339,1340,1342,1344,1347,1350],{"class":733,"line":734},[731,1341,738],{"class":737},[731,1343,742],{"class":741},[731,1345,1346],{"class":745}," DELETE",[731,1348,1349],{"class":745}," \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv2\u002Fvideo_generation\u002F\u003CTASK_ID>\"",[731,1351,752],{"class":741},[731,1353,1354,1356,1358,1360],{"class":733,"line":755},[731,1355,758],{"class":741},[731,1357,761],{"class":745},[731,1359,765],{"class":764},[731,1361,1013],{"class":745},[212,1363,1364,1365,1367,1368,610],{},"Cancelling a ",[221,1366,696],{}," task is free (the pre-authorised amount is fully refunded). The upstream does not allow cancellation once a task is ",[221,1369,700],{},[240,1371,1373],{"id":1372},"result-callback","Result callback",[212,1375,1376,1377,1379,1380,1383],{},"When ",[221,1378,469],{}," is provided, the platform POSTs the result to that address on terminal state; the body matches the query API (",[221,1381,1382],{},"{\"task\": {...}}",").",[230,1385,1386],{},[212,1387,1388,1389,1392],{},"Your callback URL is proxied by the platform, so you ",[216,1390,1391],{},"do not"," need to implement MiniMax's official challenge handshake.",[212,1394,1395,1396,1398],{},"Without ",[221,1397,469],{}," you can poll the query API yourself; the platform also runs an internal polling fallback.",[240,1400,27],{"id":1401},"billing",[212,1403,1404],{},"Billed by output video seconds, with a per-second price that varies by resolution tier. For example:",[1155,1406,1407,1410],{},[1158,1408,1409],{},"768P 5 seconds × unit price",[1158,1411,1412],{},"2K 5 seconds × unit price (higher tier)",[212,1414,1415],{},"See the pricing table on the model detail page or the console pricing page for actual unit prices.",[240,1417,1419],{"id":1418},"differences-from-volcengine-seedance","Differences from Volcengine Seedance",[248,1421,1422,1435],{},[251,1423,1424],{},[254,1425,1426,1429,1432],{},[257,1427,1428],{},"Item",[257,1430,1431],{},"MiniMax H3",[257,1433,1434],{},"Volcengine Seedance",[267,1436,1437,1451,1466,1478,1492],{},[254,1438,1439,1442,1446],{},[272,1440,1441],{},"Create path",[272,1443,1444],{},[221,1445,646],{},[272,1447,1448],{},[221,1449,1450],{},"\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks",[254,1452,1453,1456,1461],{},[272,1454,1455],{},"Create response",[272,1457,1458],{},[221,1459,1460],{},"{\"task_id\": ...}",[272,1462,1463],{},[221,1464,1465],{},"{\"id\": ...}",[254,1467,1468,1471,1475],{},[272,1469,1470],{},"Query response",[272,1472,1473],{},[221,1474,1382],{},[272,1476,1477],{},"Bare task object",[254,1479,1480,1483,1487],{},[272,1481,1482],{},"Artifact field",[272,1484,1485],{},[221,1486,1163],{},[272,1488,1489],{},[221,1490,1491],{},"content.video_url",[254,1493,1494,1496,1499],{},[272,1495,27],{},[272,1497,1498],{},"Per second (by resolution)",[272,1500,1501],{},"Per token",[212,1503,1504,1505,1507],{},"The two APIs coexist and their tasks are isolated: the ",[221,1506,227],{}," task list excludes MiniMax tasks and vice versa.",[1509,1510,1511],"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":727,"searchDepth":755,"depth":755,"links":1513},[1514,1515,1519,1520,1521,1522,1523,1524,1525,1526],{"id":242,"depth":755,"text":243},{"id":324,"depth":755,"text":325,"children":1516},[1517],{"id":499,"depth":773,"text":1518},"content items",{"id":613,"depth":755,"text":614},{"id":712,"depth":755,"text":713},{"id":983,"depth":755,"text":984},{"id":1173,"depth":755,"text":1174},{"id":1331,"depth":755,"text":1332},{"id":1372,"depth":755,"text":1373},{"id":1401,"depth":755,"text":27},{"id":1418,"depth":755,"text":1419},"Generate videos with MiniMax H3 series models: create tasks, query results, resolution and billing.","md",{},"---\ntitle: MiniMax H3 Video Generation\ndescription: \"Generate videos with MiniMax H3 series models: create tasks, query results, resolution and billing.\"\n---\n\n# MiniMax H3 Video Generation\n\nThe MiniMax H3 series uses the **MiniMax native async API** (`\u002Fapi\u002Fv2`), alongside the Volcengine Seedance shape (`\u002Fapi\u002Fv3`). Both follow \"create task → poll status → read result\", but differ in paths, field names, and billing.\n\n> MiniMax video is billed **per second** (per-second price depends on resolution), not per token.\n\n## Models and resolutions\n\nEach H3 variant supports different resolutions. The available tiers are determined by the pricing configured for the model:\n\n| Model | Supported resolutions | Notes |\n| --- | --- | --- |\n| MiniMax-H3 | 768P \u002F 2K | Standard, supports 2K |\n| H3-Highspeed | 480P \u002F 768P | Speed first |\n| H3-Lite | 480P \u002F 768P | Cost first |\n| H3-Max | 480P \u002F 768P | Quality first, **minimum 5 seconds** |\n\nPassing an unsupported `resolution` returns 400 immediately without submitting to the upstream.\n\n## Key parameters\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `model` | string | Yes | Model call name from the Model Plaza or model list |\n| `content` | array | Yes | Input content; **must contain at least one non-empty `text` item** |\n| `resolution` | string | Yes | `768P` \u002F `2K` or `480P` \u002F `768P` depending on the model |\n| `duration` | integer | Yes | Output duration in seconds, 4–15 (H3-Max minimum 5) |\n| `ratio` | string | Conditional | `adaptive` \u002F `21:9` \u002F `16:9` \u002F `4:3` \u002F `1:1` \u002F `3:4` \u002F `9:16`; required for text-to-video and cannot be `adaptive` |\n| `callback_url` | string | No | Terminal-state callback URL (platform POSTs the result when the task finishes) |\n| `aigc_watermark` | boolean | No | Whether to add a watermark, default `false` |\n\n### `content` items\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `type` | string | `text` \u002F `image_url` \u002F `video_url` \u002F `audio_url` |\n| `text` | string | Required when `type=text` |\n| `image_url.url` | string | Public URL |\n| `role` | string | `first_frame` \u002F `last_frame` \u002F `reference_image` \u002F `reference_video` \u002F `reference_audio` |\n\n> First\u002Flast frame (`first_frame` + `last_frame`) and reference generation (`reference_*`) **cannot be mixed**.\n\n## Endpoints\n\n| Operation | Method | Path |\n| --- | --- | --- |\n| Create task | `POST` | `\u002Fapi\u002Fv2\u002Fvideo_generation` |\n| Query task | `GET` | `\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation\u002F{task_id}` |\n| List tasks | `GET` | `\u002Fapi\u002Fv2\u002Fquery\u002Fvideo_generation` |\n| Cancel\u002Fdelete | `DELETE` | `\u002Fapi\u002Fv2\u002Fvideo_generation\u002F{task_id}` |\n\nTask status: `queued` → `running` → `succeeded` \u002F `failed` \u002F `cancelled`.\n\n## Text to video\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\": \"A golden retriever running on the beach, cinematic\"}],\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\": \"A golden retriever running on the beach, cinematic\"}],\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\nSuccessful creation responds:\n\n```json\n{\"task_id\": \"462160194171102\"}\n```\n\n## Query a task\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\nA successful response wraps the payload in `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- The artifact URL lives at `task.content.url`, expires, so download it promptly.\n- Billed seconds are in `task.usage.total_seconds`.\n\n## First-frame and reference generation\n\n```json\n{\n  \"model\": \"\u003CMODEL_CALL_NAME>\",\n  \"content\": [\n    {\"type\": \"text\", \"text\": \"The camera pulls back slowly as steam rises\"},\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\nReference generation (`reference_image` \u002F `reference_video` \u002F `reference_audio`) supports up to 9 images, 3 videos, and 3 audio clips; audio cannot appear alone.\n\n## Cancel a task\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\nCancelling a `queued` task is free (the pre-authorised amount is fully refunded). The upstream does not allow cancellation once a task is `running`.\n\n## Result callback\n\nWhen `callback_url` is provided, the platform POSTs the result to that address on terminal state; the body matches the query API (`{\"task\": {...}}`).\n\n> Your callback URL is proxied by the platform, so you **do not** need to implement MiniMax's official challenge handshake.\n\nWithout `callback_url` you can poll the query API yourself; the platform also runs an internal polling fallback.\n\n## Billing\n\nBilled by output video seconds, with a per-second price that varies by resolution tier. For example:\n\n- 768P 5 seconds × unit price\n- 2K 5 seconds × unit price (higher tier)\n\nSee the pricing table on the model detail page or the console pricing page for actual unit prices.\n\n## Differences from Volcengine Seedance\n\n| Item | MiniMax H3 | Volcengine Seedance |\n| --- | --- | --- |\n| Create path | `\u002Fapi\u002Fv2\u002Fvideo_generation` | `\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks` |\n| Create response | `{\"task_id\": ...}` | `{\"id\": ...}` |\n| Query response | `{\"task\": {...}}` | Bare task object |\n| Artifact field | `task.content.url` | `content.video_url` |\n| Billing | Per second (by resolution) | Per token |\n\nThe two APIs coexist and their tasks are isolated: the `\u002Fapi\u002Fv3` task list excludes MiniMax tasks and vice versa.\n",[],{"title":174,"description":1527},"de-GqFAR4itw1q1a6-NTD1GaoYSR_2dGJDGlTD_PpQc"]