[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-models\u002Fvideo\u002Fassets":180,"$fLd884H3iL251ZaQScKG6w-Fdmoq4dmVWoc21f0zJ_GQ":1546},[4,26,43,105,155,172,176],{"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,143],{"title":111,"path":112,"stem":113,"children":114,"page":25},"文本生成API","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[115,119,123,127,131,135,139],{"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\u002Fzhipu","4.models\u002F1.chat\u002F5.zhipu",{"title":136,"path":137,"stem":138},"SilvaMux 统一入口","\u002Fmodels\u002Fchat\u002Funified","4.models\u002F1.chat\u002F6.unified",{"title":140,"path":141,"stem":142},"多模态输入","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F7.multimodal",{"title":144,"path":145,"stem":146,"children":147,"page":25},"图片生成API","\u002Fmodels\u002Fimages","4.models\u002F2.images",[148,151],{"title":116,"path":149,"stem":150},"\u002Fmodels\u002Fimages\u002Foverview","4.models\u002F2.images\u002F1.overview",{"title":152,"path":153,"stem":154},"图片生成接口","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":156,"path":157,"stem":158,"children":159,"page":25},"用量与余额API","\u002Fusage-and-balance","5.usage-and-balance",[160,164,168],{"title":161,"path":162,"stem":163},"查询余额","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":165,"path":166,"stem":167},"查询用量","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":169,"path":170,"stem":171},"查询单次请求消耗","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":173,"path":174,"stem":175},"错误码参考","\u002Ferrors","6.errors",{"title":177,"path":178,"stem":179},"开始使用 SilvaMux","\u002F","index",{"id":181,"title":182,"body":183,"description":1537,"extension":1538,"meta":1539,"navigation":25,"path":1540,"rawbody":1541,"requiredFlags":1542,"seo":1543,"stem":1544,"__hash__":1545},"docs\u002F4.models\u002F3.video\u002F2.assets.md","素材管理",{"type":184,"value":185,"toc":1517},"minimark",[186,189,198,257,267,270,292,295,306,311,428,538,541,599,602,680,735,759,762,787,820,822,846,854,857,890,905,907,913,916,977,980,996,1000,1003,1048,1055,1058,1061,1105,1150,1171,1180,1183,1210,1213,1305,1307,1323,1408,1412,1488,1513],[187,188,182],"h1",{"id":182},[190,191,192,193,197],"p",{},"素材管理用于在视频生成等场景中引用图片\u002F视频\u002F音频素材。平台提供",[194,195,196],"strong",{},"两套","素材接口：",[199,200,201,220],"table",{},[202,203,204],"thead",{},[205,206,207,211,214,217],"tr",{},[208,209,210],"th",{},"接口",[208,212,213],{},"路径",[208,215,216],{},"鉴权",[208,218,219],{},"适用",[221,222,223,241],"tbody",{},[205,224,225,229,235,238],{},[226,227,228],"td",{},"自有素材库",[226,230,231],{},[232,233,234],"code",{},"\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets",[226,236,237],{},"API Key 或 JWT",[226,239,240],{},"当前未进入公开 OpenAPI，不作为独立接入入口",[205,242,243,246,251,254],{},[226,244,245],{},"火山兼容素材",[226,247,248],{},[232,249,250],{},"\u002Fapi\u002Fark\u002F*",[226,252,253],{},"火山 V4 签名",[226,255,256],{},"火山引擎 SDK 迁移",[258,259,260],"blockquote",{},[190,261,262,263,266],{},"自有素材库尚未收录到本次公开 OpenAPI，下方内容仅用于说明已有业务流程，不能作为只依据当前公开文档即可完成的独立接入示例。需要新接入时请先联系 SilvaMux 确认权限与契约。火山兼容素材接口可依据公开 ",[232,264,265],{},"\u002Fapi\u002Fark"," OpenAPI 契约接入。",[190,268,269],{},"本页内容：",[271,272,273,280,286],"ul",{},[274,275,276],"li",{},[277,278,228],"a",{"href":279},"#%E8%87%AA%E6%9C%89%E7%B4%A0%E6%9D%90%E5%BA%93",[274,281,282],{},[277,283,285],{"href":284},"#%E7%81%AB%E5%B1%B1%E5%85%BC%E5%AE%B9%E6%8E%A5%E5%8F%A3","火山兼容接口",[274,287,288],{},[277,289,291],{"href":290},"#%E5%9C%A8%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%B8%AD%E5%BC%95%E7%94%A8%E7%B4%A0%E6%9D%90","在视频生成中引用素材",[293,294,228],"h2",{"id":228},[190,296,297,298,301,302,305],{},"基础路径 ",[232,299,300],{},"\u002Fapi\u002Fbusiness\u002Fv1","，认证 ",[232,303,304],{},"Authorization: Bearer sk_live_..."," 或 JWT。",[307,308,310],"h3",{"id":309},"数据模型assetview","数据模型（AssetView）",[312,313,318],"pre",{"className":314,"code":315,"language":316,"meta":317,"style":317},"language-json shiki shiki-themes github-light github-dark","{\n  \"id\": \"AST-01JQ8Y7P8R6L7S9T0U1V2W3X4Y\",\n  \"url\": \"https:\u002F\u002Fexample.com\u002Fimage.png\",\n  \"asset_type\": \"Image\",\n  \"name\": \"cover-image\",\n  \"asset_url\": \"asset:\u002F\u002Fasset-123456\",\n  \"status\": \"processing\",\n  \"created_at\": \"2026-03-27T10:00:00Z\"\n}\n","json","",[232,319,320,329,346,359,372,385,398,411,422],{"__ignoreMap":317},[321,322,325],"span",{"class":323,"line":324},"line",1,[321,326,328],{"class":327},"sVt8B","{\n",[321,330,332,336,339,343],{"class":323,"line":331},2,[321,333,335],{"class":334},"sj4cs","  \"id\"",[321,337,338],{"class":327},": ",[321,340,342],{"class":341},"sZZnC","\"AST-01JQ8Y7P8R6L7S9T0U1V2W3X4Y\"",[321,344,345],{"class":327},",\n",[321,347,349,352,354,357],{"class":323,"line":348},3,[321,350,351],{"class":334},"  \"url\"",[321,353,338],{"class":327},[321,355,356],{"class":341},"\"https:\u002F\u002Fexample.com\u002Fimage.png\"",[321,358,345],{"class":327},[321,360,362,365,367,370],{"class":323,"line":361},4,[321,363,364],{"class":334},"  \"asset_type\"",[321,366,338],{"class":327},[321,368,369],{"class":341},"\"Image\"",[321,371,345],{"class":327},[321,373,375,378,380,383],{"class":323,"line":374},5,[321,376,377],{"class":334},"  \"name\"",[321,379,338],{"class":327},[321,381,382],{"class":341},"\"cover-image\"",[321,384,345],{"class":327},[321,386,388,391,393,396],{"class":323,"line":387},6,[321,389,390],{"class":334},"  \"asset_url\"",[321,392,338],{"class":327},[321,394,395],{"class":341},"\"asset:\u002F\u002Fasset-123456\"",[321,397,345],{"class":327},[321,399,401,404,406,409],{"class":323,"line":400},7,[321,402,403],{"class":334},"  \"status\"",[321,405,338],{"class":327},[321,407,408],{"class":341},"\"processing\"",[321,410,345],{"class":327},[321,412,414,417,419],{"class":323,"line":413},8,[321,415,416],{"class":334},"  \"created_at\"",[321,418,338],{"class":327},[321,420,421],{"class":341},"\"2026-03-27T10:00:00Z\"\n",[321,423,425],{"class":323,"line":424},9,[321,426,427],{"class":327},"}\n",[199,429,430,440],{},[202,431,432],{},[205,433,434,437],{},[208,435,436],{},"字段",[208,438,439],{},"说明",[221,441,442,452,470,490,500,514],{},[205,443,444,449],{},[226,445,446],{},[232,447,448],{},"id",[226,450,451],{},"素材 ID",[205,453,454,459],{},[226,455,456],{},[232,457,458],{},"url",[226,460,461,462,465,466,469],{},"素材下载 URL。素材 ",[232,463,464],{},"active"," 后返回火山引擎带签名的下载地址（有时效，过期后平台会自动刷新并返回新地址）；",[232,467,468],{},"processing"," 期间返回原始素材 URL",[205,471,472,477],{},[226,473,474],{},[232,475,476],{},"asset_type",[226,478,479,480,178,483,178,486,489],{},"素材类型（",[232,481,482],{},"Image",[232,484,485],{},"Video",[232,487,488],{},"Audio","）",[205,491,492,497],{},[226,493,494],{},[232,495,496],{},"name",[226,498,499],{},"素材名称",[205,501,502,507],{},[226,503,504],{},[232,505,506],{},"asset_url",[226,508,509,510,513],{},"素材引用地址，格式 ",[232,511,512],{},"asset:\u002F\u002F\u003C素材ID>","，用于视频生成引用",[205,515,516,521],{},[226,517,518],{},[232,519,520],{},"status",[226,522,523,525,526,525,528,525,531,534,535,537],{},[232,524,468],{},"、",[232,527,464],{},[232,529,530],{},"failed",[232,532,533],{},"timeout","；仅 ",[232,536,464],{}," 可用",[307,539,540],{"id":540},"端点",[199,542,543,554],{},[202,544,545],{},[205,546,547,550,552],{},[208,548,549],{},"方法",[208,551,213],{},[208,553,439],{},[221,555,556,571,585],{},[205,557,558,563,568],{},[226,559,560],{},[232,561,562],{},"POST",[226,564,565],{},[232,566,567],{},"\u002Fassets",[226,569,570],{},"创建素材（注册公网 URL）",[205,572,573,578,582],{},[226,574,575],{},[232,576,577],{},"GET",[226,579,580],{},[232,581,567],{},[226,583,584],{},"列出素材（分页）",[205,586,587,591,596],{},[226,588,589],{},[232,590,577],{},[226,592,593],{},[232,594,595],{},"\u002Fassets\u002F{asset_id}",[226,597,598],{},"获取单个素材",[307,600,601],{"id":601},"创建素材",[312,603,607],{"className":604,"code":605,"language":606,"meta":317,"style":317},"language-bash shiki shiki-themes github-light github-dark","curl -X POST https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fimage.png\",\n    \"asset_type\": \"Image\",\n    \"name\": \"cover-image\"\n  }'\n","bash",[232,608,609,627,643,652,660,665,670,675],{"__ignoreMap":317},[321,610,611,615,618,621,624],{"class":323,"line":324},[321,612,614],{"class":613},"sScJk","curl",[321,616,617],{"class":334}," -X",[321,619,620],{"class":341}," POST",[321,622,623],{"class":341}," https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets",[321,625,626],{"class":334}," \\\n",[321,628,629,632,635,638,641],{"class":323,"line":331},[321,630,631],{"class":334},"  -H",[321,633,634],{"class":341}," \"Authorization: Bearer ",[321,636,637],{"class":327},"$SILVAMUX_API_KEY",[321,639,640],{"class":341},"\"",[321,642,626],{"class":334},[321,644,645,647,650],{"class":323,"line":348},[321,646,631],{"class":334},[321,648,649],{"class":341}," \"Content-Type: application\u002Fjson\"",[321,651,626],{"class":334},[321,653,654,657],{"class":323,"line":361},[321,655,656],{"class":334},"  -d",[321,658,659],{"class":341}," '{\n",[321,661,662],{"class":323,"line":374},[321,663,664],{"class":341},"    \"url\": \"https:\u002F\u002Fexample.com\u002Fimage.png\",\n",[321,666,667],{"class":323,"line":387},[321,668,669],{"class":341},"    \"asset_type\": \"Image\",\n",[321,671,672],{"class":323,"line":400},[321,673,674],{"class":341},"    \"name\": \"cover-image\"\n",[321,676,677],{"class":323,"line":413},[321,678,679],{"class":341},"  }'\n",[199,681,682,693],{},[202,683,684],{},[205,685,686,688,691],{},[208,687,436],{},[208,689,690],{},"必填",[208,692,439],{},[221,694,695,707,723],{},[205,696,697,701,704],{},[226,698,699],{},[232,700,458],{},[226,702,703],{},"是",[226,705,706],{},"素材的公开 URL",[205,708,709,713,715],{},[226,710,711],{},[232,712,476],{},[226,714,703],{},[226,716,717,525,719,525,721],{},[232,718,482],{},[232,720,485],{},[232,722,488],{},[205,724,725,729,732],{},[226,726,727],{},[232,728,496],{},[226,730,731],{},"否",[226,733,734],{},"素材名称；省略时由素材 URL 推导",[190,736,737,738,741,742,744,745,525,747,749,750,752,753,755,756,758],{},"成功返回 ",[232,739,740],{},"201","，响应体为 AssetView。新建后通常先 ",[232,743,468],{},"，后续变为 ",[232,746,464],{},[232,748,530],{}," 或 ",[232,751,533],{},"。后台每 5 秒轮询 ",[232,754,468],{}," 状态的素材，创建超过 24 小时仍未就绪的素材会被标记为 ",[232,757,533],{},"。",[307,760,761],{"id":761},"列出素材",[312,763,765],{"className":604,"code":764,"language":606,"meta":317,"style":317},"curl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets?limit=20\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n",[232,766,767,776],{"__ignoreMap":317},[321,768,769,771,774],{"class":323,"line":324},[321,770,614],{"class":613},[321,772,773],{"class":341}," \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets?limit=20\"",[321,775,626],{"class":334},[321,777,778,780,782,784],{"class":323,"line":331},[321,779,631],{"class":334},[321,781,634],{"class":341},[321,783,637],{"class":327},[321,785,786],{"class":341},"\"\n",[199,788,789,798],{},[202,790,791],{},[205,792,793,796],{},[208,794,795],{},"参数",[208,797,439],{},[221,799,800,810],{},[205,801,802,807],{},[226,803,804],{},[232,805,806],{},"limit",[226,808,809],{},"每页数量，1-100，默认 20",[205,811,812,817],{},[226,813,814],{},[232,815,816],{},"cursor",[226,818,819],{},"分页游标，首次不传",[307,821,598],{"id":598},[312,823,825],{"className":604,"code":824,"language":606,"meta":317,"style":317},"curl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets\u002FAST-01JQ8Y7P8R6L7S9T0U1V2W3X4Y\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n",[232,826,827,836],{"__ignoreMap":317},[321,828,829,831,834],{"class":323,"line":324},[321,830,614],{"class":613},[321,832,833],{"class":341}," \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets\u002FAST-01JQ8Y7P8R6L7S9T0U1V2W3X4Y\"",[321,835,626],{"class":334},[321,837,838,840,842,844],{"class":323,"line":331},[321,839,631],{"class":334},[321,841,634],{"class":341},[321,843,637],{"class":327},[321,845,786],{"class":341},[190,847,848,849,851,852,758],{},"常用于轮询素材状态，直到 ",[232,850,520],{}," 变为 ",[232,853,464],{},[307,855,856],{"id":856},"最小调用流程",[858,859,860,863,873,884],"ol",{},[274,861,862],{},"准备一个外网可访问的素材 URL",[274,864,865,868,869,525,871],{},[232,866,867],{},"POST \u002Fassets"," 创建，拿到 ",[232,870,448],{},[232,872,506],{},[274,874,875,876,879,880,851,882],{},"轮询 ",[232,877,878],{},"GET \u002Fassets\u002F{id}","，直到 ",[232,881,520],{},[232,883,464],{},[274,885,886,887,889],{},"用 ",[232,888,506],{}," 在视频生成中引用",[258,891,892],{},[190,893,894,895,897,898,901,902,904],{},"引用非 ",[232,896,464],{}," 状态的素材会返回 ",[232,899,900],{},"InvalidParameter.asset_status"," 错误。请确保素材状态为 ",[232,903,464],{}," 后再在视频生成中引用。",[293,906,285],{"id":285},[190,908,909,910],{},"兼容本页列出的火山引擎素材管理操作。",[194,911,912],{},"从火山引擎迁移的客户可以继续使用对应的火山引擎官方 SDK，将接入地址指向本平台，并将凭证换成平台签发的 AK\u002FSK。",[914,915],"api-endpoint",{"method":562,"path":265},[199,917,918,928],{},[202,919,920],{},[205,921,922,925],{},[208,923,924],{},"项",[208,926,927],{},"值",[221,929,930,940,950,960,967],{},[205,931,932,935],{},[226,933,934],{},"Endpoint",[226,936,937],{},[232,938,939],{},"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fark",[205,941,942,945],{},[226,943,944],{},"Region",[226,946,947],{},[232,948,949],{},"cn-beijing",[205,951,952,955],{},[226,953,954],{},"Service",[226,956,957],{},[232,958,959],{},"ark",[205,961,962,964],{},[226,963,216],{},[226,965,966],{},"火山 V4 签名，使用平台签发的 AK\u002FSK",[205,968,969,972],{},[226,970,971],{},"调用方式",[226,973,974],{},[232,975,976],{},"POST \u002Fapi\u002Fark?Action=\u003CAction>&Version=2024-01-01",[307,978,979],{"id":979},"接入准备",[858,981,982,989],{},[274,983,984,985,988],{},"控制台 → 凭据管理 → 创建 ",[194,986,987],{},"Volcengine 兼容 (AK\u002FSK)"," 凭据，一次性返回 AK 与 SK（SK 仅此时可见）。",[274,990,991,992,995],{},"AK\u002FSK 绑定组织，项目通过 ",[232,993,994],{},"ProjectName"," 字段指定。",[307,997,999],{"id":998},"配置-sdk","配置 SDK",[190,1001,1002],{},"在火山引擎官方 SDK 对应的素材客户端中修改以下配置：",[199,1004,1005,1014],{},[202,1006,1007],{},[205,1008,1009,1012],{},[208,1010,1011],{},"配置",[208,1013,927],{},[221,1015,1016,1024,1032,1040],{},[205,1017,1018,1020],{},[226,1019,934],{},[226,1021,1022],{},[232,1023,939],{},[205,1025,1026,1028],{},[226,1027,944],{},[226,1029,1030],{},[232,1031,949],{},[205,1033,1034,1037],{},[226,1035,1036],{},"Access Key",[226,1038,1039],{},"平台签发的 AK",[205,1041,1042,1045],{},[226,1043,1044],{},"Secret Key",[226,1046,1047],{},"平台签发的 SK",[190,1049,1050,1051,1054],{},"具体客户端类名和初始化方式以所使用的火山引擎 SDK 版本为准。本仓库不提供名为 ",[232,1052,1053],{},"ArkAssetClient"," 的独立客户端。",[307,1056,1057],{"id":1057},"支持的操作",[190,1059,1060],{},"请求体字段名与火山引擎一致（驼峰、首字母大写）。",[190,1062,1063,1064,1067,1068,525,1071,525,1074,525,1077,758,1080,1082,1083,1086,1087,1090,1091,1094,1095,758,1098,1100,1101,1104],{},"素材组（AssetGroup）：",[232,1065,1066],{},"CreateAssetGroup","（仅 AIGC，创建时回填组织级共享火山组 id）、",[232,1069,1070],{},"GetAssetGroup",[232,1072,1073],{},"ListAssetGroups",[232,1075,1076],{},"UpdateAssetGroup",[232,1078,1079],{},"DeleteAssetGroup",[232,1081,1073],{}," 的 ",[232,1084,1085],{},"Filter.GroupType"," 可选，默认 ",[232,1088,1089],{},"AIGC","（仅列 AIGC 组）；传 ",[232,1092,1093],{},"LivenessFace"," 列真人组，取其它值返回 ",[232,1096,1097],{},"InvalidParameter.GroupType",[232,1099,1079],{}," 对真人组同步删除上游真人火山组（",[232,1102,1103],{},"provider_group_id"," 缺失直接报错），AIGC 组仅清本地（共享组不删）。",[190,1106,1107,1108,1111,1112,1115,1116,1115,1119,1115,1122,1125,1126,489,1129,525,1132,525,1135,525,1138,758,1141,1143,1144,178,1146,178,1148,758],{},"素材（Asset）：",[232,1109,1110],{},"CreateAsset","（",[232,1113,1114],{},"GroupId","+",[232,1117,1118],{},"URL",[232,1120,1121],{},"AssetType",[232,1123,1124],{},"Name","，可选 ",[232,1127,1128],{},"GroupType",[232,1130,1131],{},"GetAsset",[232,1133,1134],{},"ListAssets",[232,1136,1137],{},"UpdateAsset",[232,1139,1140],{},"DeleteAsset",[232,1142,1121],{}," 可选 ",[232,1145,482],{},[232,1147,485],{},[232,1149,488],{},[190,1151,1152,1154,1155,1158,1159,1162,1163,1166,1167,758],{},[232,1153,1110],{}," 的上游组按",[194,1156,1157],{},"目标组的类型","自动路由：指向 AIGC 组走普通 AIGC 素材入库（上传到组织级 AIGC 火山组）；指向 ",[232,1160,1161],{},"CreateVisualValidateSession"," + ",[232,1164,1165],{},"GetVisualValidateResult"," 流程返回的 LivenessFace 组即走真人素材入库，上游真人火山组 id 由平台内部解析，客户端无需知晓。完整流程见",[277,1168,1170],{"href":1169},"\u002Fzh-cn\u002Fdocs\u002Fmodels\u002Fvideo\u002Fliveness-verification","人像认证（真人活体认证）",[190,1172,1173,1175,1176,1179],{},[232,1174,994],{}," 为空或填 ",[232,1177,1178],{},"default"," 用默认项目，填其它值按项目名精确匹配。",[307,1181,1182],{"id":1182},"重要限制",[271,1184,1185,1191,1205],{},[274,1186,1187,1190],{},[194,1188,1189],{},"历史素材不可见","：之前通过火山引擎控制台或其它账号上传的素材无法通过本接口访问，需重新上传。",[274,1192,1193,1194,1196,1197,1162,1199,1201,1202,1204],{},"素材类型区分：",[232,1195,1110],{}," 指向 AIGC 组走普通 AIGC 素材（图片\u002F视频\u002F音频）；真人素材（LivenessFace）需先走 ",[232,1198,1161],{},[232,1200,1165],{}," 完成活体校验，再把素材上传到返回的 LivenessFace 组，平台按组类型自动路由到真人上游组（见",[277,1203,1170],{"href":1169},"）。",[274,1206,1207,1209],{},[232,1208,1110],{}," 需提供公网可访问的素材 URL，平台拉取入库。",[307,1211,1212],{"id":1212},"错误码",[199,1214,1215,1225],{},[202,1216,1217],{},[205,1218,1219,1222],{},[208,1220,1221],{},"Code",[208,1223,1224],{},"含义",[221,1226,1227,1237,1247,1257,1267,1281,1291],{},[205,1228,1229,1234],{},[226,1230,1231],{},[232,1232,1233],{},"InvalidSignature",[226,1235,1236],{},"签名校验失败（AK\u002FSK 错、请求被篡改、时钟偏移过大）",[205,1238,1239,1244],{},[226,1240,1241],{},[232,1242,1243],{},"InvalidAction",[226,1245,1246],{},"不支持的 Action",[205,1248,1249,1254],{},[226,1250,1251],{},[232,1252,1253],{},"MissingParameter.*",[226,1255,1256],{},"缺少必填字段",[205,1258,1259,1264],{},[226,1260,1261],{},[232,1262,1263],{},"InvalidParameter.*",[226,1265,1266],{},"字段值非法",[205,1268,1269,1278],{},[226,1270,1271,1274,1275],{},[232,1272,1273],{},"NotFound.asset_id"," \u002F ",[232,1276,1277],{},"NotFound.project",[226,1279,1280],{},"素材 \u002F 项目不存在",[205,1282,1283,1288],{},[226,1284,1285],{},[232,1286,1287],{},"SubscriptionRequired",[226,1289,1290],{},"组织未开通相应能力",[205,1292,1293,1298],{},[226,1294,1295],{},[232,1296,1297],{},"InternalError",[226,1299,1300,1301,1304],{},"服务内部错误，记录 ",[232,1302,1303],{},"RequestId"," 联系支持",[293,1306,291],{"id":291},[190,1308,1309,1310,1312,1313,1111,1315,1318,1319,1322],{},"素材 ",[232,1311,464],{}," 后，用 ",[232,1314,506],{},[232,1316,1317],{},"asset:\u002F\u002F...","）在视频生成的 ",[232,1320,1321],{},"content"," 中引用：",[312,1324,1326],{"className":314,"code":1325,"language":316,"meta":317,"style":317},"{\n  \"model\": \"\u003CMODEL_CALL_NAME>\",\n  \"content\": [\n    {\"type\": \"video_url\", \"video_url\": \"asset:\u002F\u002Fasset-123456\"},\n    {\"type\": \"text\", \"text\": \"让画面中的角色跳舞\"}\n  ]\n}\n",[232,1327,1328,1332,1344,1352,1377,1399,1404],{"__ignoreMap":317},[321,1329,1330],{"class":323,"line":324},[321,1331,328],{"class":327},[321,1333,1334,1337,1339,1342],{"class":323,"line":331},[321,1335,1336],{"class":334},"  \"model\"",[321,1338,338],{"class":327},[321,1340,1341],{"class":341},"\"\u003CMODEL_CALL_NAME>\"",[321,1343,345],{"class":327},[321,1345,1346,1349],{"class":323,"line":348},[321,1347,1348],{"class":334},"  \"content\"",[321,1350,1351],{"class":327},": [\n",[321,1353,1354,1357,1360,1362,1365,1368,1370,1372,1374],{"class":323,"line":361},[321,1355,1356],{"class":327},"    {",[321,1358,1359],{"class":334},"\"type\"",[321,1361,338],{"class":327},[321,1363,1364],{"class":341},"\"video_url\"",[321,1366,1367],{"class":327},", ",[321,1369,1364],{"class":334},[321,1371,338],{"class":327},[321,1373,395],{"class":341},[321,1375,1376],{"class":327},"},\n",[321,1378,1379,1381,1383,1385,1388,1390,1392,1394,1397],{"class":323,"line":374},[321,1380,1356],{"class":327},[321,1382,1359],{"class":334},[321,1384,338],{"class":327},[321,1386,1387],{"class":341},"\"text\"",[321,1389,1367],{"class":327},[321,1391,1387],{"class":334},[321,1393,338],{"class":327},[321,1395,1396],{"class":341},"\"让画面中的角色跳舞\"",[321,1398,427],{"class":327},[321,1400,1401],{"class":323,"line":387},[321,1402,1403],{"class":327},"  ]\n",[321,1405,1406],{"class":323,"line":400},[321,1407,427],{"class":327},[307,1409,1411],{"id":1410},"迁移要点火山引擎-silvamux","迁移要点（火山引擎 → SilvaMux）",[199,1413,1414,1429],{},[202,1415,1416],{},[205,1417,1418,1421,1424,1427],{},[208,1419,1420],{},"能力",[208,1422,1423],{},"火山引擎",[208,1425,1426],{},"SilvaMux",[208,1428,439],{},[221,1430,1431,1449,1470],{},[205,1432,1433,1436,1441,1446],{},[226,1434,1435],{},"对话（豆包）",[226,1437,1438],{},[232,1439,1440],{},"\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions",[226,1442,1443],{},[232,1444,1445],{},"POST \u002Fapi\u002Fv3\u002Fchat\u002Fcompletions",[226,1447,1448],{},"协议兼容，改 Base URL + Key，model 用平台调用名",[205,1450,1451,1454,1459,1464],{},[226,1452,1453],{},"视频生成",[226,1455,1456],{},[232,1457,1458],{},"\u002Fcontents\u002Fgenerations\u002Ftasks",[226,1460,1461],{},[232,1462,1463],{},"POST \u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks",[226,1465,1466,1469],{},[194,1467,1468],{},"自有接口 + API Key","，不走 V4 签名",[205,1471,1472,1474,1477,1485],{},[226,1473,182],{},[226,1475,1476],{},"火山官方接口",[226,1478,1479,1482,1483],{},[232,1480,1481],{},"POST \u002Fapi\u002Fark\u002F*","（本页）或 ",[232,1484,234],{},[226,1486,1487],{},"两套可选",[271,1489,1490,1493,1500,1506],{},[274,1491,1492],{},"视频生成走 API Key，不走 V4 签名。V4 签名仅用于本页素材接口。",[274,1494,1495,1496,1499],{},"API Key（",[232,1497,1498],{},"sk_live_","）与 AK\u002FSK 在控制台分别创建，不同。",[274,1501,1502,1505],{},[232,1503,1504],{},"model"," 使用模型广场或模型列表展示的真实调用名，不是火山 endpoint ID。",[274,1507,1508,1509,1512],{},"视频与 3D 任务支持任务列表、单任务查询和创建时传入 ",[232,1510,1511],{},"callback_url","；字段与鉴权以公开 OpenAPI 契约为准。",[1514,1515,1516],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}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 .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);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}",{"title":317,"searchDepth":331,"depth":331,"links":1518},[1519,1527,1534],{"id":228,"depth":331,"text":228,"children":1520},[1521,1522,1523,1524,1525,1526],{"id":309,"depth":348,"text":310},{"id":540,"depth":348,"text":540},{"id":601,"depth":348,"text":601},{"id":761,"depth":348,"text":761},{"id":598,"depth":348,"text":598},{"id":856,"depth":348,"text":856},{"id":285,"depth":331,"text":285,"children":1528},[1529,1530,1531,1532,1533],{"id":979,"depth":348,"text":979},{"id":998,"depth":348,"text":999},{"id":1057,"depth":348,"text":1057},{"id":1182,"depth":348,"text":1182},{"id":1212,"depth":348,"text":1212},{"id":291,"depth":331,"text":291,"children":1535},[1536],{"id":1410,"depth":348,"text":1411},"使用自有素材接口或火山兼容接口管理生成素材。","md",{},"\u002Fmodels\u002Fvideo\u002Fassets","---\ntitle: 素材管理\ndescription: 使用自有素材接口或火山兼容接口管理生成素材。\nnavigation: false\n---\n\n# 素材管理\n\n素材管理用于在视频生成等场景中引用图片\u002F视频\u002F音频素材。平台提供**两套**素材接口：\n\n| 接口 | 路径 | 鉴权 | 适用 |\n| --- | --- | --- | --- |\n| 自有素材库 | `\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets` | API Key 或 JWT | 当前未进入公开 OpenAPI，不作为独立接入入口 |\n| 火山兼容素材 | `\u002Fapi\u002Fark\u002F*` | 火山 V4 签名 | 火山引擎 SDK 迁移 |\n\n> 自有素材库尚未收录到本次公开 OpenAPI，下方内容仅用于说明已有业务流程，不能作为只依据当前公开文档即可完成的独立接入示例。需要新接入时请先联系 SilvaMux 确认权限与契约。火山兼容素材接口可依据公开 `\u002Fapi\u002Fark` OpenAPI 契约接入。\n\n本页内容：\n- [自有素材库](#自有素材库)\n- [火山兼容接口](#火山兼容接口)\n- [在视频生成中引用素材](#在视频生成中引用素材)\n\n## 自有素材库\n\n基础路径 `\u002Fapi\u002Fbusiness\u002Fv1`，认证 `Authorization: Bearer sk_live_...` 或 JWT。\n\n### 数据模型（AssetView）\n\n```json\n{\n  \"id\": \"AST-01JQ8Y7P8R6L7S9T0U1V2W3X4Y\",\n  \"url\": \"https:\u002F\u002Fexample.com\u002Fimage.png\",\n  \"asset_type\": \"Image\",\n  \"name\": \"cover-image\",\n  \"asset_url\": \"asset:\u002F\u002Fasset-123456\",\n  \"status\": \"processing\",\n  \"created_at\": \"2026-03-27T10:00:00Z\"\n}\n```\n\n| 字段 | 说明 |\n| --- | --- |\n| `id` | 素材 ID |\n| `url` | 素材下载 URL。素材 `active` 后返回火山引擎带签名的下载地址（有时效，过期后平台会自动刷新并返回新地址）；`processing` 期间返回原始素材 URL |\n| `asset_type` | 素材类型（`Image`\u002F`Video`\u002F`Audio`） |\n| `name` | 素材名称 |\n| `asset_url` | 素材引用地址，格式 `asset:\u002F\u002F\u003C素材ID>`，用于视频生成引用 |\n| `status` | `processing`、`active`、`failed`、`timeout`；仅 `active` 可用 |\n\n### 端点\n\n| 方法 | 路径 | 说明 |\n| --- | --- | --- |\n| `POST` | `\u002Fassets` | 创建素材（注册公网 URL） |\n| `GET` | `\u002Fassets` | 列出素材（分页） |\n| `GET` | `\u002Fassets\u002F{asset_id}` | 获取单个素材 |\n\n### 创建素材\n\n```bash\ncurl -X POST https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fimage.png\",\n    \"asset_type\": \"Image\",\n    \"name\": \"cover-image\"\n  }'\n```\n\n| 字段 | 必填 | 说明 |\n| --- | --- | --- |\n| `url` | 是 | 素材的公开 URL |\n| `asset_type` | 是 | `Image`、`Video`、`Audio` |\n| `name` | 否 | 素材名称；省略时由素材 URL 推导 |\n\n成功返回 `201`，响应体为 AssetView。新建后通常先 `processing`，后续变为 `active`、`failed` 或 `timeout`。后台每 5 秒轮询 `processing` 状态的素材，创建超过 24 小时仍未就绪的素材会被标记为 `timeout`。\n\n### 列出素材\n\n```bash\ncurl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets?limit=20\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n```\n\n| 参数 | 说明 |\n| --- | --- |\n| `limit` | 每页数量，1-100，默认 20 |\n| `cursor` | 分页游标，首次不传 |\n\n### 获取单个素材\n\n```bash\ncurl \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets\u002FAST-01JQ8Y7P8R6L7S9T0U1V2W3X4Y\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n```\n\n常用于轮询素材状态，直到 `status` 变为 `active`。\n\n### 最小调用流程\n\n1. 准备一个外网可访问的素材 URL\n2. `POST \u002Fassets` 创建，拿到 `id`、`asset_url`\n3. 轮询 `GET \u002Fassets\u002F{id}`，直到 `status` 变为 `active`\n4. 用 `asset_url` 在视频生成中引用\n\n> 引用非 `active` 状态的素材会返回 `InvalidParameter.asset_status` 错误。请确保素材状态为 `active` 后再在视频生成中引用。\n\n## 火山兼容接口\n\n兼容本页列出的火山引擎素材管理操作。**从火山引擎迁移的客户可以继续使用对应的火山引擎官方 SDK，将接入地址指向本平台，并将凭证换成平台签发的 AK\u002FSK。**\n\n::api-endpoint{path=\"\u002Fapi\u002Fark\" method=\"POST\"}\n::\n\n| 项 | 值 |\n| --- | --- |\n| Endpoint | `https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fark` |\n| Region | `cn-beijing` |\n| Service | `ark` |\n| 鉴权 | 火山 V4 签名，使用平台签发的 AK\u002FSK |\n| 调用方式 | `POST \u002Fapi\u002Fark?Action=\u003CAction>&Version=2024-01-01` |\n\n### 接入准备\n\n1. 控制台 → 凭据管理 → 创建 **Volcengine 兼容 (AK\u002FSK)** 凭据，一次性返回 AK 与 SK（SK 仅此时可见）。\n2. AK\u002FSK 绑定组织，项目通过 `ProjectName` 字段指定。\n\n### 配置 SDK\n\n在火山引擎官方 SDK 对应的素材客户端中修改以下配置：\n\n| 配置 | 值 |\n| --- | --- |\n| Endpoint | `https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fark` |\n| Region | `cn-beijing` |\n| Access Key | 平台签发的 AK |\n| Secret Key | 平台签发的 SK |\n\n具体客户端类名和初始化方式以所使用的火山引擎 SDK 版本为准。本仓库不提供名为 `ArkAssetClient` 的独立客户端。\n\n### 支持的操作\n\n请求体字段名与火山引擎一致（驼峰、首字母大写）。\n\n素材组（AssetGroup）：`CreateAssetGroup`（仅 AIGC，创建时回填组织级共享火山组 id）、`GetAssetGroup`、`ListAssetGroups`、`UpdateAssetGroup`、`DeleteAssetGroup`。`ListAssetGroups` 的 `Filter.GroupType` 可选，默认 `AIGC`（仅列 AIGC 组）；传 `LivenessFace` 列真人组，取其它值返回 `InvalidParameter.GroupType`。`DeleteAssetGroup` 对真人组同步删除上游真人火山组（`provider_group_id` 缺失直接报错），AIGC 组仅清本地（共享组不删）。\n\n素材（Asset）：`CreateAsset`（`GroupId`+`URL`+`AssetType`+`Name`，可选 `GroupType`）`GetAsset`、`ListAssets`、`UpdateAsset`、`DeleteAsset`。`AssetType` 可选 `Image`\u002F`Video`\u002F`Audio`。\n\n`CreateAsset` 的上游组按**目标组的类型**自动路由：指向 AIGC 组走普通 AIGC 素材入库（上传到组织级 AIGC 火山组）；指向 `CreateVisualValidateSession` + `GetVisualValidateResult` 流程返回的 LivenessFace 组即走真人素材入库，上游真人火山组 id 由平台内部解析，客户端无需知晓。完整流程见[人像认证（真人活体认证）](\u002Fzh-cn\u002Fdocs\u002Fmodels\u002Fvideo\u002Fliveness-verification)。\n\n`ProjectName` 为空或填 `default` 用默认项目，填其它值按项目名精确匹配。\n\n### 重要限制\n\n- **历史素材不可见**：之前通过火山引擎控制台或其它账号上传的素材无法通过本接口访问，需重新上传。\n- 素材类型区分：`CreateAsset` 指向 AIGC 组走普通 AIGC 素材（图片\u002F视频\u002F音频）；真人素材（LivenessFace）需先走 `CreateVisualValidateSession` + `GetVisualValidateResult` 完成活体校验，再把素材上传到返回的 LivenessFace 组，平台按组类型自动路由到真人上游组（见[人像认证（真人活体认证）](\u002Fzh-cn\u002Fdocs\u002Fmodels\u002Fvideo\u002Fliveness-verification)）。\n- `CreateAsset` 需提供公网可访问的素材 URL，平台拉取入库。\n\n### 错误码\n\n| Code | 含义 |\n| --- | --- |\n| `InvalidSignature` | 签名校验失败（AK\u002FSK 错、请求被篡改、时钟偏移过大） |\n| `InvalidAction` | 不支持的 Action |\n| `MissingParameter.*` | 缺少必填字段 |\n| `InvalidParameter.*` | 字段值非法 |\n| `NotFound.asset_id` \u002F `NotFound.project` | 素材 \u002F 项目不存在 |\n| `SubscriptionRequired` | 组织未开通相应能力 |\n| `InternalError` | 服务内部错误，记录 `RequestId` 联系支持 |\n\n## 在视频生成中引用素材\n\n素材 `active` 后，用 `asset_url`（`asset:\u002F\u002F...`）在视频生成的 `content` 中引用：\n\n```json\n{\n  \"model\": \"\u003CMODEL_CALL_NAME>\",\n  \"content\": [\n    {\"type\": \"video_url\", \"video_url\": \"asset:\u002F\u002Fasset-123456\"},\n    {\"type\": \"text\", \"text\": \"让画面中的角色跳舞\"}\n  ]\n}\n```\n\n### 迁移要点（火山引擎 → SilvaMux）\n\n| 能力 | 火山引擎 | SilvaMux | 说明 |\n| --- | --- | --- | --- |\n| 对话（豆包） | `\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions` | `POST \u002Fapi\u002Fv3\u002Fchat\u002Fcompletions` | 协议兼容，改 Base URL + Key，model 用平台调用名 |\n| 视频生成 | `\u002Fcontents\u002Fgenerations\u002Ftasks` | `POST \u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks` | **自有接口 + API Key**，不走 V4 签名 |\n| 素材管理 | 火山官方接口 | `POST \u002Fapi\u002Fark\u002F*`（本页）或 `\u002Fapi\u002Fbusiness\u002Fv1\u002Fassets` | 两套可选 |\n\n- 视频生成走 API Key，不走 V4 签名。V4 签名仅用于本页素材接口。\n- API Key（`sk_live_`）与 AK\u002FSK 在控制台分别创建，不同。\n- `model` 使用模型广场或模型列表展示的真实调用名，不是火山 endpoint ID。\n- 视频与 3D 任务支持任务列表、单任务查询和创建时传入 `callback_url`；字段与鉴权以公开 OpenAPI 契约为准。\n",[],{"title":182,"description":1537},"4.models\u002F3.video\u002F2.assets","_kLyR0j8tiVX0_S7Vn5DUZN6MFxnMOR9IHPBrpzdSYg",{"found":1547,"operationId":1548,"summary":1549,"description":1550,"method":562,"path":265,"publiclyDiscoverable":1547,"security":1551,"parameters":1554,"requestBody":1562,"responses":1647},true,"callArkCompatibleAction","火山兼容 API","多个素材和 CV Action 共用该路径，请求体结构由 Action 和 Version 决定。",{"schemes":1552,"optional":25},[1553],"VolcengineV4",[1555,1558],{"name":1556,"type":1557,"required":1547,"description":317},"Action","string (CreateAssetGroup | GetAssetGroup | ListAssetGroups | UpdateAssetGroup | DeleteAssetGroup | CreateAsset | GetAsset | ListAssets | UpdateAsset | DeleteAsset | CVProcess | CVSubmitTask | CVGetResult) · query",{"name":1559,"type":1560,"required":25,"description":1561},"Version","string (2024-01-01 | 2022-08-31) · query","火山协议版本。素材操作使用 2024-01-01，CV 操作使用 2022-08-31；当前 handler 不强制校验该参数。",{"present":1547,"required":1547,"description":317,"contentType":1563,"type":1564,"fields":1565,"variants":1566},"application\u002Fjson","CreateAssetGroup | GetAssetGroup \u002F DeleteAssetGroup | ListAssetGroups | UpdateAssetGroup | CreateAsset | GetAsset \u002F DeleteAsset | ListAssets | UpdateAsset | CVSubmitTask \u002F CVProcess \u002F CVGetResult",[],[1567,1575,1580,1600,1605,1613,1617,1629,1633],{"name":1066,"index":324,"fields":1568},[1569,1572,1574],{"name":1570,"type":1571,"required":25,"description":317},"Description","string",{"name":1128,"type":1573,"required":25,"description":317},"string (AIGC)",{"name":1124,"type":1571,"required":1547,"description":317},{"name":1576,"index":331,"fields":1577},"GetAssetGroup \u002F DeleteAssetGroup",[1578],{"name":1579,"type":1571,"required":1547,"description":317},"Id",{"name":1073,"index":348,"fields":1581},[1582,1585,1588,1589,1591,1594,1596,1598],{"name":1583,"type":1584,"required":25,"description":317},"Filter","object",{"name":1586,"type":1587,"required":25,"description":317},"Filter.GroupIds","array\u003Cstring>",{"name":1085,"type":1571,"required":25,"description":317},{"name":1590,"type":1571,"required":25,"description":317},"Filter.Name",{"name":1592,"type":1593,"required":25,"description":317},"PageNumber","integer (int64)",{"name":1595,"type":1593,"required":25,"description":317},"PageSize",{"name":1597,"type":1571,"required":25,"description":317},"SortBy",{"name":1599,"type":1571,"required":25,"description":317},"SortOrder",{"name":1076,"index":361,"fields":1601},[1602,1603,1604],{"name":1570,"type":1571,"required":25,"description":317},{"name":1579,"type":1571,"required":1547,"description":317},{"name":1124,"type":1571,"required":25,"description":317},{"name":1110,"index":374,"fields":1606},[1607,1609,1610,1611],{"name":1121,"type":1608,"required":1547,"description":317},"string (Image | Video | Audio)",{"name":1114,"type":1571,"required":1547,"description":317},{"name":1124,"type":1571,"required":25,"description":317},{"name":1118,"type":1612,"required":1547,"description":317},"string (uri)",{"name":1614,"index":387,"fields":1615},"GetAsset \u002F DeleteAsset",[1616],{"name":1579,"type":1571,"required":1547,"description":317},{"name":1134,"index":400,"fields":1618},[1619,1620,1621,1622,1623,1625,1626,1627,1628],{"name":1583,"type":1584,"required":25,"description":317},{"name":1586,"type":1587,"required":25,"description":317},{"name":1085,"type":1571,"required":25,"description":317},{"name":1590,"type":1571,"required":25,"description":317},{"name":1624,"type":1587,"required":25,"description":317},"Filter.Statuses",{"name":1592,"type":1593,"required":25,"description":317},{"name":1595,"type":1593,"required":25,"description":317},{"name":1597,"type":1571,"required":25,"description":317},{"name":1599,"type":1571,"required":25,"description":317},{"name":1137,"index":413,"fields":1630},[1631,1632],{"name":1579,"type":1571,"required":1547,"description":317},{"name":1124,"type":1571,"required":25,"description":317},{"name":1634,"index":424,"fields":1635},"CVSubmitTask \u002F CVProcess \u002F CVGetResult",[1636,1638,1640,1643,1645],{"name":1637,"type":1612,"required":25,"description":317},"audio_url",{"name":1639,"type":1612,"required":25,"description":317},"image_url",{"name":1641,"type":1642,"required":25,"description":317},"mask_url","string (uri) | array\u003Cstring (uri)>",{"name":1644,"type":1571,"required":1547,"description":317},"req_key",{"name":1646,"type":1571,"required":25,"description":317},"task_id",[1648,1658],{"status":1649,"description":1650,"contentType":1563,"type":1651,"fields":1652},"200","火山兼容响应 envelope。","ArkResponse",[1653,1656],{"name":1654,"type":1655,"required":25,"description":317},"ResponseMetadata","FreeFormObject",{"name":1657,"type":1655,"required":25,"description":317},"Result",{"status":1178,"description":1659,"contentType":1563,"type":1651,"fields":1660},"火山兼容错误 envelope。",[1661,1662],{"name":1654,"type":1655,"required":25,"description":317},{"name":1657,"type":1655,"required":25,"description":317}]