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