[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-models\u002Fimages\u002Fgeneration":163,"$fn4JeKmPd8Sepq-Kg0V7ERb4D67F9Ox-H0VJFkyTWoXI":1257,"$fsZhaBBTwy8wMBMUCs3aiA6GUVinNEI_xpFs7KcseEEI":1302},[4,52,69,92,142,155,159],{"title":5,"path":6,"stem":7,"children":8,"page":-1},"快速开始","\u002Fgetting-started","1.getting-started",[9,12,30,44,48],{"title":10,"path":6,"stem":11},"关于 SilvaMux","1.getting-started\u002Findex",{"title":13,"path":14,"stem":15,"children":16,"page":-1},"首次调用千木 API","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F1.quick-start\u002Findex",[17,18,22,26],{"title":13,"path":14,"stem":15},{"title":19,"path":20,"stem":21},"项目和账户设置","\u002Fgetting-started\u002Fquick-start\u002Fproject-and-account","1.getting-started\u002F1.quick-start\u002F2.project-and-account",{"title":23,"path":24,"stem":25},"获取 API Key","\u002Fgetting-started\u002Fquick-start\u002Fapi-key","1.getting-started\u002F1.quick-start\u002F3.api-key",{"title":27,"path":28,"stem":29},"第一个请求","\u002Fgetting-started\u002Fquick-start\u002Ffirst-request","1.getting-started\u002F1.quick-start\u002F4.first-request",{"title":31,"path":32,"stem":33,"children":34,"page":43},"模型与体验","\u002Fgetting-started\u002Fmodels-and-experience","1.getting-started\u002F2.models-and-experience",[35,39],{"title":36,"path":37,"stem":38},"模型选择","\u002Fgetting-started\u002Fmodels-and-experience\u002Fmodel-selection","1.getting-started\u002F2.models-and-experience\u002F1.model-selection",{"title":40,"path":41,"stem":42},"在线体验","\u002Fgetting-started\u002Fmodels-and-experience\u002Fplayground","1.getting-started\u002F2.models-and-experience\u002F2.playground",false,{"title":45,"path":46,"stem":47},"限流","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F3.rate-limits",{"title":49,"path":50,"stem":51},"常见问题","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq",{"title":53,"path":54,"stem":55,"children":56,"page":43},"产品计费","\u002Fbilling","2.billing",[57,61,65],{"title":58,"path":59,"stem":60},"计费说明","\u002Fbilling\u002Foverview","2.billing\u002F1.overview",{"title":62,"path":63,"stem":64},"在线充值","\u002Fbilling\u002Frecharge","2.billing\u002F2.recharge",{"title":66,"path":67,"stem":68},"账单、用量与导出","\u002Fbilling\u002Fusage-export","2.billing\u002F3.usage-export",{"title":70,"path":71,"stem":72,"children":73,"page":43},"Coding Plan","\u002Fcoding-plan","3.coding-plan",[74,78],{"title":75,"path":76,"stem":77},"Coding Plan 概述","\u002Fcoding-plan\u002Foverview","3.coding-plan\u002F1.overview",{"title":79,"path":80,"stem":81,"children":82,"page":-1},"个人版","\u002Fcoding-plan\u002Fpersonal","3.coding-plan\u002F2.personal\u002Findex",[83,85,89],{"title":84,"path":80,"stem":81},"价格和权益",{"title":86,"path":87,"stem":88},"快速接入","\u002Fcoding-plan\u002Fpersonal\u002Fquick-start","3.coding-plan\u002F2.personal\u002F2.quick-start",{"title":49,"path":90,"stem":91},"\u002Fcoding-plan\u002Fpersonal\u002Ffaq","3.coding-plan\u002F2.personal\u002F3.faq",{"title":93,"path":94,"stem":95,"children":96,"page":43},"模型接口","\u002Fmodels","4.models",[97,130],{"title":98,"path":99,"stem":100,"children":101,"page":43},"文本生成","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[102,106,110,114,118,122,126],{"title":103,"path":104,"stem":105},"概述","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":107,"path":108,"stem":109},"OpenAI 兼容接口","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":111,"path":112,"stem":113},"Anthropic 兼容","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":115,"path":116,"stem":117},"Volcengine 兼容","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":119,"path":120,"stem":121},"智谱兼容","\u002Fmodels\u002Fchat\u002Fzhipu","4.models\u002F1.chat\u002F5.zhipu",{"title":123,"path":124,"stem":125},"SilvaMux 统一入口","\u002Fmodels\u002Fchat\u002Funified","4.models\u002F1.chat\u002F6.unified",{"title":127,"path":128,"stem":129},"多模态输入","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F7.multimodal",{"title":131,"path":132,"stem":133,"children":134,"page":43},"图片生成","\u002Fmodels\u002Fimages","4.models\u002F2.images",[135,138],{"title":103,"path":136,"stem":137},"\u002Fmodels\u002Fimages\u002Foverview","4.models\u002F2.images\u002F1.overview",{"title":139,"path":140,"stem":141},"图片生成接口","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":143,"path":144,"stem":145,"children":146,"page":43},"用量与余额","\u002Fusage-and-balance","5.usage-and-balance",[147,151],{"title":148,"path":149,"stem":150},"查询余额","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":152,"path":153,"stem":154},"查询用量","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":156,"path":157,"stem":158},"错误码参考","\u002Ferrors","6.errors",{"title":160,"path":161,"stem":162},"文档首页","\u002F","index",{"id":164,"title":139,"body":165,"description":1250,"extension":1251,"meta":1252,"navigation":327,"path":140,"rawbody":1253,"requiredFlags":1254,"seo":1255,"stem":141,"__hash__":1256},"docs\u002F4.models\u002F2.images\u002F2.generation.md",{"type":166,"value":167,"toc":1236},"minimark",[168,171,184,189,194,198,693,696,763,779,783,789,800,808,822,916,923,927,933,936,939,1076,1080,1095,1113,1116,1123,1184,1193,1196,1207,1210,1223,1226,1232],[169,170,139],"h1",{"id":139},[172,173,174,175,179,180,183],"p",{},"文生图接口根据模型分为两种风格：OpenAI Images API 风格（豆包 Seedream）和 Gemini ",[176,177,178],"code",{},"generateContent"," 风格；图片编辑使用 ",[176,181,182],{},"multipart\u002Fform-data"," 上传原图。",[185,186,188],"h2",{"id":187},"文生图openai-风格seedream","文生图（OpenAI 风格，Seedream）",[190,191],"api-endpoint",{"method":192,"path":193},"POST","\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations",[195,196,197],"h3",{"id":197},"示例",[199,200,201,298,405,501],"code-tabs",{},[202,203,205],"code-tab",{"label":204},"cURL",[206,207,212],"pre",{"className":208,"code":209,"language":210,"meta":211,"style":211},"language-bash shiki shiki-themes github-light github-dark","curl https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"doubao-seedream-5-0-260128\",\n    \"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n    \"size\": \"2048x2048\",\n    \"n\": 1\n  }'\n","bash","",[176,213,214,231,249,259,268,274,280,286,292],{"__ignoreMap":211},[215,216,219,223,227],"span",{"class":217,"line":218},"line",1,[215,220,222],{"class":221},"sScJk","curl",[215,224,226],{"class":225},"sZZnC"," https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations",[215,228,230],{"class":229},"sj4cs"," \\\n",[215,232,234,237,240,244,247],{"class":217,"line":233},2,[215,235,236],{"class":229},"  -H",[215,238,239],{"class":225}," \"Authorization: Bearer ",[215,241,243],{"class":242},"sVt8B","$SILVAMUX_API_KEY",[215,245,246],{"class":225},"\"",[215,248,230],{"class":229},[215,250,252,254,257],{"class":217,"line":251},3,[215,253,236],{"class":229},[215,255,256],{"class":225}," \"Content-Type: application\u002Fjson\"",[215,258,230],{"class":229},[215,260,262,265],{"class":217,"line":261},4,[215,263,264],{"class":229},"  -d",[215,266,267],{"class":225}," '{\n",[215,269,271],{"class":217,"line":270},5,[215,272,273],{"class":225},"    \"model\": \"doubao-seedream-5-0-260128\",\n",[215,275,277],{"class":217,"line":276},6,[215,278,279],{"class":225},"    \"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n",[215,281,283],{"class":217,"line":282},7,[215,284,285],{"class":225},"    \"size\": \"2048x2048\",\n",[215,287,289],{"class":217,"line":288},8,[215,290,291],{"class":225},"    \"n\": 1\n",[215,293,295],{"class":217,"line":294},9,[215,296,297],{"class":225},"  }'\n",[202,299,301],{"label":300},"Python",[206,302,306],{"className":303,"code":304,"language":305,"meta":211,"style":211},"language-python shiki shiki-themes github-light github-dark","# pip install openai\nimport os\nfrom openai import OpenAI\n\nclient = OpenAI(\n    api_key=os.environ[\"SILVAMUX_API_KEY\"],\n    base_url=\"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\",\n)\n\nresult = client.images.generate(\n    model=\"doubao-seedream-5-0-260128\",\n    prompt=\"一只戴墨镜的柴犬坐在咖啡馆里\",\n    size=\"2048x2048\",\n    n=1,\n)\n\nfor item in result.data:\n    print(item.url)\n","python",[176,307,308,313,318,323,329,334,339,344,349,353,359,365,371,377,383,388,393,399],{"__ignoreMap":211},[215,309,310],{"class":217,"line":218},[215,311,312],{},"# pip install openai\n",[215,314,315],{"class":217,"line":233},[215,316,317],{},"import os\n",[215,319,320],{"class":217,"line":251},[215,321,322],{},"from openai import OpenAI\n",[215,324,325],{"class":217,"line":261},[215,326,328],{"emptyLinePlaceholder":327},true,"\n",[215,330,331],{"class":217,"line":270},[215,332,333],{},"client = OpenAI(\n",[215,335,336],{"class":217,"line":276},[215,337,338],{},"    api_key=os.environ[\"SILVAMUX_API_KEY\"],\n",[215,340,341],{"class":217,"line":282},[215,342,343],{},"    base_url=\"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\",\n",[215,345,346],{"class":217,"line":288},[215,347,348],{},")\n",[215,350,351],{"class":217,"line":294},[215,352,328],{"emptyLinePlaceholder":327},[215,354,356],{"class":217,"line":355},10,[215,357,358],{},"result = client.images.generate(\n",[215,360,362],{"class":217,"line":361},11,[215,363,364],{},"    model=\"doubao-seedream-5-0-260128\",\n",[215,366,368],{"class":217,"line":367},12,[215,369,370],{},"    prompt=\"一只戴墨镜的柴犬坐在咖啡馆里\",\n",[215,372,374],{"class":217,"line":373},13,[215,375,376],{},"    size=\"2048x2048\",\n",[215,378,380],{"class":217,"line":379},14,[215,381,382],{},"    n=1,\n",[215,384,386],{"class":217,"line":385},15,[215,387,348],{},[215,389,391],{"class":217,"line":390},16,[215,392,328],{"emptyLinePlaceholder":327},[215,394,396],{"class":217,"line":395},17,[215,397,398],{},"for item in result.data:\n",[215,400,402],{"class":217,"line":401},18,[215,403,404],{},"    print(item.url)\n",[202,406,408],{"label":407},"JavaScript",[206,409,413],{"className":410,"code":411,"language":412,"meta":211,"style":211},"language-javascript shiki shiki-themes github-light github-dark","\u002F\u002F npm install openai\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n  apiKey: process.env.SILVAMUX_API_KEY,\n  baseURL: \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\",\n});\n\nconst result = await client.images.generate({\n  model: \"doubao-seedream-5-0-260128\",\n  prompt: \"一只戴墨镜的柴犬坐在咖啡馆里\",\n  size: \"2048x2048\",\n  n: 1,\n});\n\nfor (const item of result.data) {\n  console.log(item.url);\n}\n","javascript",[176,414,415,420,425,429,434,439,444,449,453,458,463,468,473,478,482,486,491,496],{"__ignoreMap":211},[215,416,417],{"class":217,"line":218},[215,418,419],{},"\u002F\u002F npm install openai\n",[215,421,422],{"class":217,"line":233},[215,423,424],{},"import OpenAI from \"openai\";\n",[215,426,427],{"class":217,"line":251},[215,428,328],{"emptyLinePlaceholder":327},[215,430,431],{"class":217,"line":261},[215,432,433],{},"const client = new OpenAI({\n",[215,435,436],{"class":217,"line":270},[215,437,438],{},"  apiKey: process.env.SILVAMUX_API_KEY,\n",[215,440,441],{"class":217,"line":276},[215,442,443],{},"  baseURL: \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\",\n",[215,445,446],{"class":217,"line":282},[215,447,448],{},"});\n",[215,450,451],{"class":217,"line":288},[215,452,328],{"emptyLinePlaceholder":327},[215,454,455],{"class":217,"line":294},[215,456,457],{},"const result = await client.images.generate({\n",[215,459,460],{"class":217,"line":355},[215,461,462],{},"  model: \"doubao-seedream-5-0-260128\",\n",[215,464,465],{"class":217,"line":361},[215,466,467],{},"  prompt: \"一只戴墨镜的柴犬坐在咖啡馆里\",\n",[215,469,470],{"class":217,"line":367},[215,471,472],{},"  size: \"2048x2048\",\n",[215,474,475],{"class":217,"line":373},[215,476,477],{},"  n: 1,\n",[215,479,480],{"class":217,"line":379},[215,481,448],{},[215,483,484],{"class":217,"line":385},[215,485,328],{"emptyLinePlaceholder":327},[215,487,488],{"class":217,"line":390},[215,489,490],{},"for (const item of result.data) {\n",[215,492,493],{"class":217,"line":395},[215,494,495],{},"  console.log(item.url);\n",[215,497,498],{"class":217,"line":401},[215,499,500],{},"}\n",[202,502,504],{"label":503},"Go",[206,505,509],{"className":506,"code":507,"language":508,"meta":211,"style":211},"language-go shiki shiki-themes github-light github-dark","\u002F\u002F 仅依赖标准库\npackage main\n\nimport (\n    \"bytes\"\n    \"fmt\"\n    \"io\"\n    \"net\u002Fhttp\"\n    \"os\"\n)\n\nfunc main() {\n    payload := []byte(`{\n        \"model\": \"doubao-seedream-5-0-260128\",\n        \"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n        \"size\": \"2048x2048\",\n        \"n\": 1\n    }`)\n\n    req, err := http.NewRequest(\"POST\", \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations\", bytes.NewReader(payload))\n    if err != nil {\n        panic(err)\n    }\n    req.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"SILVAMUX_API_KEY\"))\n    req.Header.Set(\"Content-Type\", \"application\u002Fjson\")\n\n    resp, err := http.DefaultClient.Do(req)\n    if err != nil {\n        panic(err)\n    }\n    defer resp.Body.Close()\n\n    body, _ := io.ReadAll(resp.Body)\n    fmt.Println(string(body))\n}\n","go",[176,510,511,516,521,525,530,535,540,545,550,555,559,563,568,573,578,583,588,593,598,603,609,615,621,627,633,639,644,650,655,660,665,671,676,682,688],{"__ignoreMap":211},[215,512,513],{"class":217,"line":218},[215,514,515],{},"\u002F\u002F 仅依赖标准库\n",[215,517,518],{"class":217,"line":233},[215,519,520],{},"package main\n",[215,522,523],{"class":217,"line":251},[215,524,328],{"emptyLinePlaceholder":327},[215,526,527],{"class":217,"line":261},[215,528,529],{},"import (\n",[215,531,532],{"class":217,"line":270},[215,533,534],{},"    \"bytes\"\n",[215,536,537],{"class":217,"line":276},[215,538,539],{},"    \"fmt\"\n",[215,541,542],{"class":217,"line":282},[215,543,544],{},"    \"io\"\n",[215,546,547],{"class":217,"line":288},[215,548,549],{},"    \"net\u002Fhttp\"\n",[215,551,552],{"class":217,"line":294},[215,553,554],{},"    \"os\"\n",[215,556,557],{"class":217,"line":355},[215,558,348],{},[215,560,561],{"class":217,"line":361},[215,562,328],{"emptyLinePlaceholder":327},[215,564,565],{"class":217,"line":367},[215,566,567],{},"func main() {\n",[215,569,570],{"class":217,"line":373},[215,571,572],{},"    payload := []byte(`{\n",[215,574,575],{"class":217,"line":379},[215,576,577],{},"        \"model\": \"doubao-seedream-5-0-260128\",\n",[215,579,580],{"class":217,"line":385},[215,581,582],{},"        \"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n",[215,584,585],{"class":217,"line":390},[215,586,587],{},"        \"size\": \"2048x2048\",\n",[215,589,590],{"class":217,"line":395},[215,591,592],{},"        \"n\": 1\n",[215,594,595],{"class":217,"line":401},[215,596,597],{},"    }`)\n",[215,599,601],{"class":217,"line":600},19,[215,602,328],{"emptyLinePlaceholder":327},[215,604,606],{"class":217,"line":605},20,[215,607,608],{},"    req, err := http.NewRequest(\"POST\", \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations\", bytes.NewReader(payload))\n",[215,610,612],{"class":217,"line":611},21,[215,613,614],{},"    if err != nil {\n",[215,616,618],{"class":217,"line":617},22,[215,619,620],{},"        panic(err)\n",[215,622,624],{"class":217,"line":623},23,[215,625,626],{},"    }\n",[215,628,630],{"class":217,"line":629},24,[215,631,632],{},"    req.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"SILVAMUX_API_KEY\"))\n",[215,634,636],{"class":217,"line":635},25,[215,637,638],{},"    req.Header.Set(\"Content-Type\", \"application\u002Fjson\")\n",[215,640,642],{"class":217,"line":641},26,[215,643,328],{"emptyLinePlaceholder":327},[215,645,647],{"class":217,"line":646},27,[215,648,649],{},"    resp, err := http.DefaultClient.Do(req)\n",[215,651,653],{"class":217,"line":652},28,[215,654,614],{},[215,656,658],{"class":217,"line":657},29,[215,659,620],{},[215,661,663],{"class":217,"line":662},30,[215,664,626],{},[215,666,668],{"class":217,"line":667},31,[215,669,670],{},"    defer resp.Body.Close()\n",[215,672,674],{"class":217,"line":673},32,[215,675,328],{"emptyLinePlaceholder":327},[215,677,679],{"class":217,"line":678},33,[215,680,681],{},"    body, _ := io.ReadAll(resp.Body)\n",[215,683,685],{"class":217,"line":684},34,[215,686,687],{},"    fmt.Println(string(body))\n",[215,689,691],{"class":217,"line":690},35,[215,692,500],{},[172,694,695],{},"响应：",[206,697,701],{"className":698,"code":699,"language":700,"meta":211,"style":211},"language-json shiki shiki-themes github-light github-dark","{\n  \"created\": 1234567890,\n  \"data\": [{\"url\": \"https:\u002F\u002F...\"}],\n  \"usage\": {\"output_images\": 1}\n}\n","json",[176,702,703,708,722,741,759],{"__ignoreMap":211},[215,704,705],{"class":217,"line":218},[215,706,707],{"class":242},"{\n",[215,709,710,713,716,719],{"class":217,"line":233},[215,711,712],{"class":229},"  \"created\"",[215,714,715],{"class":242},": ",[215,717,718],{"class":229},"1234567890",[215,720,721],{"class":242},",\n",[215,723,724,727,730,733,735,738],{"class":217,"line":251},[215,725,726],{"class":229},"  \"data\"",[215,728,729],{"class":242},": [{",[215,731,732],{"class":229},"\"url\"",[215,734,715],{"class":242},[215,736,737],{"class":225},"\"https:\u002F\u002F...\"",[215,739,740],{"class":242},"}],\n",[215,742,743,746,749,752,754,757],{"class":217,"line":261},[215,744,745],{"class":229},"  \"usage\"",[215,747,748],{"class":242},": {",[215,750,751],{"class":229},"\"output_images\"",[215,753,715],{"class":242},[215,755,756],{"class":229},"1",[215,758,500],{"class":242},[215,760,761],{"class":217,"line":270},[215,762,500],{"class":242},[764,765,766],"blockquote",{},[172,767,768,771,772,775,776,778],{},[176,769,770],{},"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3"," 即接入域名下的 ",[176,773,774],{},"\u002Fapi\u002Fv3","，对应路由 ",[176,777,193],{},"。",[185,780,782],{"id":781},"文生图gemini-风格契约示例","文生图（Gemini 风格，契约示例）",[172,784,785,786,788],{},"Gemini ",[176,787,178],{}," 风格，适合 Gemini 图像模型。",[790,791,793],"alert",{"type":792},"warning",[172,794,795,796,799],{},"当前模型列表和模型广场暂无公开可发现的 Gemini 图像模型。以下内容仅用于展示请求结构，不能直接执行；",[176,797,798],{},"\u003CMODEL_CALL_NAME>"," 必须替换为模型广场后续发布的真实调用名，请勿猜测模型名称。",[206,801,806],{"className":802,"code":804,"language":805},[803],"language-text","POST \u002Fapi\u002Fv1beta\u002Fmodels\u002F{model}:generateContent\n","text",[176,807,804],{"__ignoreMap":211},[172,809,810,814,815,818,819],{},[811,812,813],"strong",{},"认证："," ",[176,816,817],{},"Authorization: Bearer \u003CAPI_KEY>"," 或 ",[176,820,821],{},"x-api-key: \u003CAPI_KEY>",[206,823,825],{"className":208,"code":824,"language":210,"meta":211,"style":211},"curl https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1beta\u002Fmodels\u002F\u003CMODEL_CALL_NAME>:generateContent \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"contents\": [\n      {\"role\": \"user\", \"parts\": [{\"text\": \"画一只坐在窗台上的猫\"}]}\n    ],\n    \"generationConfig\": {\n      \"responseModalities\": [\"TEXT\", \"IMAGE\"],\n      \"imageConfig\": {\"aspectRatio\": \"1:1\", \"imageSize\": \"1K\"}\n    }\n  }'\n",[176,826,827,852,864,872,878,883,888,893,898,903,908,912],{"__ignoreMap":211},[215,828,829,831,834,838,841,844,847,850],{"class":217,"line":218},[215,830,222],{"class":221},[215,832,833],{"class":225}," https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1beta\u002Fmodels\u002F",[215,835,837],{"class":836},"szBVR","\u003C",[215,839,840],{"class":225},"MODEL_CALL_NAM",[215,842,843],{"class":242},"E",[215,845,846],{"class":836},">",[215,848,849],{"class":225},":generateContent",[215,851,230],{"class":229},[215,853,854,856,858,860,862],{"class":217,"line":233},[215,855,236],{"class":229},[215,857,239],{"class":225},[215,859,243],{"class":242},[215,861,246],{"class":225},[215,863,230],{"class":229},[215,865,866,868,870],{"class":217,"line":251},[215,867,236],{"class":229},[215,869,256],{"class":225},[215,871,230],{"class":229},[215,873,874,876],{"class":217,"line":261},[215,875,264],{"class":229},[215,877,267],{"class":225},[215,879,880],{"class":217,"line":270},[215,881,882],{"class":225},"    \"contents\": [\n",[215,884,885],{"class":217,"line":276},[215,886,887],{"class":225},"      {\"role\": \"user\", \"parts\": [{\"text\": \"画一只坐在窗台上的猫\"}]}\n",[215,889,890],{"class":217,"line":282},[215,891,892],{"class":225},"    ],\n",[215,894,895],{"class":217,"line":288},[215,896,897],{"class":225},"    \"generationConfig\": {\n",[215,899,900],{"class":217,"line":294},[215,901,902],{"class":225},"      \"responseModalities\": [\"TEXT\", \"IMAGE\"],\n",[215,904,905],{"class":217,"line":355},[215,906,907],{"class":225},"      \"imageConfig\": {\"aspectRatio\": \"1:1\", \"imageSize\": \"1K\"}\n",[215,909,910],{"class":217,"line":361},[215,911,626],{"class":225},[215,913,914],{"class":217,"line":367},[215,915,297],{"class":225},[172,917,918,919,922],{},"响应保持 Gemini 格式，计费字段在 ",[176,920,921],{},"usageMetadata"," 中。",[185,924,926],{"id":925},"图片编辑图生图","图片编辑（图生图）",[172,928,929,930,932],{},"图生图（图片编辑）接口兼容 OpenAI Images Edits 风格，使用 ",[176,931,182],{}," 上传图片并按提示词编辑。",[190,934],{"method":192,"path":935},"\u002Fapi\u002Fv3\u002Fimages\u002Fedits",[195,937,938],{"id":938},"关键参数",[940,941,942,961],"table",{},[943,944,945],"thead",{},[946,947,948,952,955,958],"tr",{},[949,950,951],"th",{},"参数",[949,953,954],{},"类型",[949,956,957],{},"必填",[949,959,960],{},"说明",[962,963,964,981,1000,1014,1032,1046,1061],"tbody",{},[946,965,966,972,975,978],{},[967,968,969],"td",{},[176,970,971],{},"model",[967,973,974],{},"string",[967,976,977],{},"是",[967,979,980],{},"模型调用名；必须从模型广场或模型列表获取",[946,982,983,988,991,993],{},[967,984,985],{},[176,986,987],{},"image",[967,989,990],{},"file",[967,992,977],{},[967,994,995,996,999],{},"输入图片，最多 16 张（重复传入 ",[176,997,998],{},"image=@...","）",[946,1001,1002,1007,1009,1011],{},[967,1003,1004],{},[176,1005,1006],{},"prompt",[967,1008,974],{},[967,1010,977],{},[967,1012,1013],{},"编辑指令",[946,1015,1016,1021,1023,1026],{},[967,1017,1018],{},[176,1019,1020],{},"size",[967,1022,974],{},[967,1024,1025],{},"否",[967,1027,1028,1029],{},"尺寸，如 ",[176,1030,1031],{},"1024x1024",[946,1033,1034,1039,1041,1043],{},[967,1035,1036],{},[176,1037,1038],{},"mask",[967,1040,990],{},[967,1042,1025],{},[967,1044,1045],{},"蒙版图",[946,1047,1048,1053,1056,1058],{},[967,1049,1050],{},[176,1051,1052],{},"n",[967,1054,1055],{},"integer",[967,1057,1025],{},[967,1059,1060],{},"输出图片数量",[946,1062,1063,1068,1071,1073],{},[967,1064,1065],{},[176,1066,1067],{},"stream",[967,1069,1070],{},"boolean",[967,1072,1025],{},[967,1074,1075],{},"模型透传字段，当前不属于统一 OpenAPI 契约；是否支持以后续公开模型为准",[195,1077,1079],{"id":1078},"openapi-契约说明","OpenAPI 契约说明",[172,1081,1082,1083,1086,1087,1090,1091,1094],{},"图片编辑 v1 和 v3 在 OpenAPI 中共用 ",[176,1084,1085],{},"#\u002Fcomponents\u002FrequestBodies\u002FImageEdit"," 请求体，并继续引用 ",[176,1088,1089],{},"#\u002Fcomponents\u002Fschemas\u002FImageEditRequest"," 定义字段。读取或生成 SDK 时需要递归解析本地 ",[176,1092,1093],{},"$ref","；字段没有直接内联在接口节点下，不代表请求体缺失。",[172,1096,1097,1098,1100,1101,1103,1104,1106,1107,1109,1110,1112],{},"解析后的请求体为必填的 ",[176,1099,182],{},"，其中 ",[176,1102,971],{},"、",[176,1105,1006],{}," 和 ",[176,1108,987],{}," 必填，",[176,1111,987],{}," 为单个或多个二进制文件。",[195,1114,197],{"id":1115},"示例-1",[790,1117,1118],{"type":792},[172,1119,1120,1121,799],{},"当前模型列表和模型广场暂未公开可发现的图片编辑模型。以下内容是请求结构示例，不能直接执行；",[176,1122,798],{},[206,1124,1126],{"className":208,"code":1125,"language":210,"meta":211,"style":211},"curl https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fedits \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -F \"model=\u003CMODEL_CALL_NAME>\" \\\n  -F \"image=@photo.png\" \\\n  -F \"prompt=给图片加上一些装饰文字\" \\\n  -F \"size=1024x1024\"\n",[176,1127,1128,1137,1149,1159,1168,1177],{"__ignoreMap":211},[215,1129,1130,1132,1135],{"class":217,"line":218},[215,1131,222],{"class":221},[215,1133,1134],{"class":225}," https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fedits",[215,1136,230],{"class":229},[215,1138,1139,1141,1143,1145,1147],{"class":217,"line":233},[215,1140,236],{"class":229},[215,1142,239],{"class":225},[215,1144,243],{"class":242},[215,1146,246],{"class":225},[215,1148,230],{"class":229},[215,1150,1151,1154,1157],{"class":217,"line":251},[215,1152,1153],{"class":229},"  -F",[215,1155,1156],{"class":225}," \"model=\u003CMODEL_CALL_NAME>\"",[215,1158,230],{"class":229},[215,1160,1161,1163,1166],{"class":217,"line":261},[215,1162,1153],{"class":229},[215,1164,1165],{"class":225}," \"image=@photo.png\"",[215,1167,230],{"class":229},[215,1169,1170,1172,1175],{"class":217,"line":270},[215,1171,1153],{"class":229},[215,1173,1174],{"class":225}," \"prompt=给图片加上一些装饰文字\"",[215,1176,230],{"class":229},[215,1178,1179,1181],{"class":217,"line":276},[215,1180,1153],{"class":229},[215,1182,1183],{"class":225}," \"size=1024x1024\"\n",[172,1185,1186,1103,1189,1192],{},[176,1187,1188],{},"background",[176,1190,1191],{},"partial_images"," 等字段属于模型透传字段，当前不属于统一 OpenAPI 契约。是否支持以后续公开模型的详情为准。",[185,1194,1195],{"id":1195},"上传限制",[172,1197,1198,1199,1202,1203,1206],{},"请求体大小不超过 64 MB。超出返回 ",[176,1200,1201],{},"413","（",[176,1204,1205],{},"REQUEST_TOO_LARGE","）。",[185,1208,1209],{"id":1209},"可用模型",[172,1211,1212,1213,1216,1217,1222],{},"当前可直接使用的样例模型：",[176,1214,1215],{},"doubao-seedream-5-0-260128","（Seedream）。Gemini 图像模型与图片编辑模型暂无公开可发现的调用名，可用调用名必须以",[1218,1219,1221],"a",{"href":1220},"\u002Fzh-cn\u002Fmodels","模型广场","或模型列表接口为准。",[185,1224,1225],{"id":1225},"计费",[172,1227,1228,1229,1231],{},"文生图和图生图均按生成张数计费，当前单价请在",[1218,1230,1221],{"href":1220},"打开对应模型详情查看。",[1233,1234,1235],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}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);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}",{"title":211,"searchDepth":233,"depth":233,"links":1237},[1238,1241,1242,1247,1248,1249],{"id":187,"depth":233,"text":188,"children":1239},[1240],{"id":197,"depth":251,"text":197},{"id":781,"depth":233,"text":782},{"id":925,"depth":233,"text":926,"children":1243},[1244,1245,1246],{"id":938,"depth":251,"text":938},{"id":1078,"depth":251,"text":1079},{"id":1115,"depth":251,"text":197},{"id":1195,"depth":233,"text":1195},{"id":1209,"depth":233,"text":1209},{"id":1225,"depth":233,"text":1225},"使用 OpenAI Images 或 Gemini 兼容格式生成或编辑图片。","md",{},"---\ntitle: 图片生成接口\ndescription: 使用 OpenAI Images 或 Gemini 兼容格式生成或编辑图片。\n---\n\n# 图片生成接口\n\n文生图接口根据模型分为两种风格：OpenAI Images API 风格（豆包 Seedream）和 Gemini `generateContent` 风格；图片编辑使用 `multipart\u002Fform-data` 上传原图。\n\n## 文生图（OpenAI 风格，Seedream）\n\n::api-endpoint{path=\"\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations\" method=\"POST\"}\n::\n\n### 示例\n\n::code-tabs\n:::code-tab{label=\"cURL\"}\n```bash\ncurl https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"doubao-seedream-5-0-260128\",\n    \"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n    \"size\": \"2048x2048\",\n    \"n\": 1\n  }'\n```\n:::\n:::code-tab{label=\"Python\"}\n```python\n# pip install openai\nimport os\nfrom openai import OpenAI\n\nclient = OpenAI(\n    api_key=os.environ[\"SILVAMUX_API_KEY\"],\n    base_url=\"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\",\n)\n\nresult = client.images.generate(\n    model=\"doubao-seedream-5-0-260128\",\n    prompt=\"一只戴墨镜的柴犬坐在咖啡馆里\",\n    size=\"2048x2048\",\n    n=1,\n)\n\nfor item in result.data:\n    print(item.url)\n```\n:::\n:::code-tab{label=\"JavaScript\"}\n```javascript\n\u002F\u002F npm install openai\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n  apiKey: process.env.SILVAMUX_API_KEY,\n  baseURL: \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\",\n});\n\nconst result = await client.images.generate({\n  model: \"doubao-seedream-5-0-260128\",\n  prompt: \"一只戴墨镜的柴犬坐在咖啡馆里\",\n  size: \"2048x2048\",\n  n: 1,\n});\n\nfor (const item of result.data) {\n  console.log(item.url);\n}\n```\n:::\n:::code-tab{label=\"Go\"}\n```go\n\u002F\u002F 仅依赖标准库\npackage main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"net\u002Fhttp\"\n\t\"os\"\n)\n\nfunc main() {\n\tpayload := []byte(`{\n\t\t\"model\": \"doubao-seedream-5-0-260128\",\n\t\t\"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n\t\t\"size\": \"2048x2048\",\n\t\t\"n\": 1\n\t}`)\n\n\treq, err := http.NewRequest(\"POST\", \"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations\", bytes.NewReader(payload))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"SILVAMUX_API_KEY\"))\n\treq.Header.Set(\"Content-Type\", \"application\u002Fjson\")\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer resp.Body.Close()\n\n\tbody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(body))\n}\n```\n:::\n::\n\n响应：\n\n```json\n{\n  \"created\": 1234567890,\n  \"data\": [{\"url\": \"https:\u002F\u002F...\"}],\n  \"usage\": {\"output_images\": 1}\n}\n```\n\n> `https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3` 即接入域名下的 `\u002Fapi\u002Fv3`，对应路由 `\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations`。\n\n## 文生图（Gemini 风格，契约示例）\n\nGemini `generateContent` 风格，适合 Gemini 图像模型。\n\n::alert{type=\"warning\"}\n当前模型列表和模型广场暂无公开可发现的 Gemini 图像模型。以下内容仅用于展示请求结构，不能直接执行；`\u003CMODEL_CALL_NAME>` 必须替换为模型广场后续发布的真实调用名，请勿猜测模型名称。\n::\n\n```\nPOST \u002Fapi\u002Fv1beta\u002Fmodels\u002F{model}:generateContent\n```\n\n**认证：** `Authorization: Bearer \u003CAPI_KEY>` 或 `x-api-key: \u003CAPI_KEY>`\n\n```bash\ncurl https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1beta\u002Fmodels\u002F\u003CMODEL_CALL_NAME>:generateContent \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"contents\": [\n      {\"role\": \"user\", \"parts\": [{\"text\": \"画一只坐在窗台上的猫\"}]}\n    ],\n    \"generationConfig\": {\n      \"responseModalities\": [\"TEXT\", \"IMAGE\"],\n      \"imageConfig\": {\"aspectRatio\": \"1:1\", \"imageSize\": \"1K\"}\n    }\n  }'\n```\n\n响应保持 Gemini 格式，计费字段在 `usageMetadata` 中。\n\n## 图片编辑（图生图）\n\n图生图（图片编辑）接口兼容 OpenAI Images Edits 风格，使用 `multipart\u002Fform-data` 上传图片并按提示词编辑。\n\n::api-endpoint{path=\"\u002Fapi\u002Fv3\u002Fimages\u002Fedits\" method=\"POST\"}\n::\n\n### 关键参数\n\n| 参数 | 类型 | 必填 | 说明 |\n| --- | --- | --- | --- |\n| `model` | string | 是 | 模型调用名；必须从模型广场或模型列表获取 |\n| `image` | file | 是 | 输入图片，最多 16 张（重复传入 `image=@...`） |\n| `prompt` | string | 是 | 编辑指令 |\n| `size` | string | 否 | 尺寸，如 `1024x1024` |\n| `mask` | file | 否 | 蒙版图 |\n| `n` | integer | 否 | 输出图片数量 |\n| `stream` | boolean | 否 | 模型透传字段，当前不属于统一 OpenAPI 契约；是否支持以后续公开模型为准 |\n\n### OpenAPI 契约说明\n\n图片编辑 v1 和 v3 在 OpenAPI 中共用 `#\u002Fcomponents\u002FrequestBodies\u002FImageEdit` 请求体，并继续引用 `#\u002Fcomponents\u002Fschemas\u002FImageEditRequest` 定义字段。读取或生成 SDK 时需要递归解析本地 `$ref`；字段没有直接内联在接口节点下，不代表请求体缺失。\n\n解析后的请求体为必填的 `multipart\u002Fform-data`，其中 `model`、`prompt` 和 `image` 必填，`image` 为单个或多个二进制文件。\n\n### 示例\n\n::alert{type=\"warning\"}\n当前模型列表和模型广场暂未公开可发现的图片编辑模型。以下内容是请求结构示例，不能直接执行；`\u003CMODEL_CALL_NAME>` 必须替换为模型广场后续发布的真实调用名，请勿猜测模型名称。\n::\n\n```bash\ncurl https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002Fimages\u002Fedits \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -F \"model=\u003CMODEL_CALL_NAME>\" \\\n  -F \"image=@photo.png\" \\\n  -F \"prompt=给图片加上一些装饰文字\" \\\n  -F \"size=1024x1024\"\n```\n\n`background`、`partial_images` 等字段属于模型透传字段，当前不属于统一 OpenAPI 契约。是否支持以后续公开模型的详情为准。\n\n## 上传限制\n\n请求体大小不超过 64 MB。超出返回 `413`（`REQUEST_TOO_LARGE`）。\n\n## 可用模型\n\n当前可直接使用的样例模型：`doubao-seedream-5-0-260128`（Seedream）。Gemini 图像模型与图片编辑模型暂无公开可发现的调用名，可用调用名必须以[模型广场](\u002Fzh-cn\u002Fmodels)或模型列表接口为准。\n\n## 计费\n\n文生图和图生图均按生成张数计费，当前单价请在[模型广场](\u002Fzh-cn\u002Fmodels)打开对应模型详情查看。\n",[],{"title":139,"description":1250},"1wzcNZ0dqTv52JA3ehUFLkFQ7zDHylIGleqB0X1Zr1Y",{"found":327,"operationId":1258,"summary":131,"description":211,"method":192,"path":193,"publiclyDiscoverable":327,"security":1259,"parameters":1263,"requestBody":1264,"responses":1277},"createImageV3",{"schemes":1260,"optional":43},[1261,1262],"BearerAuth","ApiKeyAuth",[],{"present":327,"required":327,"description":211,"contentType":1265,"type":1266,"fields":1267,"variants":1276},"application\u002Fjson","ImageGenerationRequest",[1268,1270,1271,1272,1274],{"name":971,"type":974,"required":327,"description":1269},"从模型广场选择支持当前图片接口的模型并复制调用名。",{"name":1052,"type":1055,"required":43,"description":211},{"name":1006,"type":974,"required":327,"description":211},{"name":1273,"type":974,"required":43,"description":211},"response_format",{"name":1020,"type":974,"required":43,"description":1275},"可用尺寸由模型决定；Seedream 5.0 的首次调用示例使用 2048x2048。",[],[1278,1294],{"status":1279,"description":1280,"contentType":1265,"type":1281,"fields":1282},"200","图片生成或编辑响应。","ImageResponse",[1283,1286,1289,1291],{"name":1284,"type":1285,"required":43,"description":211},"created","integer (int64)",{"name":1287,"type":1288,"required":43,"description":211},"data","array\u003Cobject>",{"name":1290,"type":974,"required":43,"description":211},"data.b64_json",{"name":1292,"type":1293,"required":43,"description":211},"data.url","string (uri)",{"status":1295,"description":1296,"contentType":1265,"type":1297,"fields":1298},"default","Volcengine 兼容错误。","VolcengineError",[1299],{"name":1300,"type":1301,"required":43,"description":211},"error","FreeFormObject",{"found":327,"operationId":1303,"summary":1304,"description":1305,"method":192,"path":935,"publiclyDiscoverable":43,"security":1306,"parameters":1308,"requestBody":1309,"responses":1322},"editImageV3","编辑图片（Volcengine v3）","使用 multipart\u002Fform-data 上传图片；请求体通过 #\u002Fcomponents\u002FrequestBodies\u002FImageEdit 定义，解析后 model、prompt 和 image 为必填字段。",{"schemes":1307,"optional":43},[1261,1262],[],{"present":327,"required":327,"description":1310,"contentType":182,"type":1311,"fields":1312,"variants":1321},"图片编辑 v1\u002Fv3 共用的必填请求体。Content-Type 为 multipart\u002Fform-data；继续解析 ImageEditRequest 可获得 model、prompt、image 等字段。","ImageEditRequest",[1313,1315,1317,1318,1319,1320],{"name":987,"type":1314,"required":327,"description":211},"string (binary) | array\u003Cstring (binary)>",{"name":1038,"type":1316,"required":43,"description":211},"string (binary)",{"name":971,"type":974,"required":327,"description":211},{"name":1052,"type":1055,"required":43,"description":211},{"name":1006,"type":974,"required":327,"description":211},{"name":1020,"type":974,"required":43,"description":211},[],[1323,1329],{"status":1279,"description":1280,"contentType":1265,"type":1281,"fields":1324},[1325,1326,1327,1328],{"name":1284,"type":1285,"required":43,"description":211},{"name":1287,"type":1288,"required":43,"description":211},{"name":1290,"type":974,"required":43,"description":211},{"name":1292,"type":1293,"required":43,"description":211},{"status":1295,"description":1330,"contentType":1265,"type":1331,"fields":1332},"OpenAI 兼容错误。","OpenAIError",[1333,1335,1338,1340],{"name":1300,"type":1334,"required":327,"description":211},"object",{"name":1336,"type":1337,"required":43,"description":211},"error.code","string | integer",{"name":1339,"type":974,"required":327,"description":211},"error.message",{"name":1341,"type":974,"required":43,"description":211},"error.type"]