[{"data":1,"prerenderedAt":722},["ShallowReactive",2],{"guide-\u002Fguides-zh\u002Fimage-generation":3,"developer-code-yv63x7":718,"developer-code-1fplh0u":719,"developer-code-1vu0zq3":720,"developer-code-wmfbhl":721},{"id":4,"title":5,"body":6,"description":708,"extension":709,"meta":710,"navigation":711,"path":714,"seo":715,"stem":716,"__hash__":717},"guidesZh\u002Fguides-zh\u002Fimage-generation.md","AI 图像生成 API",{"type":7,"value":8,"toc":700},"minimark",[9,13,23,28,82,86,125,136,302,345,351,355,373,412,457,530,534,551,610,614,676,680,696],[10,11,12],"p",{},"VisionStory AI 图像生成 API 根据文本提示和可选参考素材生成或编辑图像。同步响应会返回图像 URL，你可以直接下载，也可以将其用于图生视频流程。",[14,15,16],"blockquote",{},[10,17,18,22],{},[19,20,21],"strong",{},"Beta。"," 只要账户拥有有效的 Pro 或更高等级订阅，其 API Key 即可调用此接口，无需额外申请能力白名单。",[24,25,27],"h2",{"id":26},"ai-image-api-endpoints","AI 图像接口",[29,30,31,47],"table",{},[32,33,34],"thead",{},[35,36,37,41,44],"tr",{},[38,39,40],"th",{},"方法",[38,42,43],{},"路径",[38,45,46],{},"功能",[48,49,50,67],"tbody",{},[35,51,52,59,64],{},[53,54,55],"td",{},[56,57,58],"code",{},"GET",[53,60,61],{},[56,62,63],{},"\u002Fapi\u002Fv1\u002Fimage\u002Fmodels",[53,65,66],{},"查询图像模型、支持尺寸和单张图像的点数成本",[35,68,69,74,79],{},[53,70,71],{},[56,72,73],{},"POST",[53,75,76],{},[56,77,78],{},"\u002Fapi\u002Fv1\u002Fimage",[53,80,81],{},"根据提示词及可选参考素材生成图像",[24,83,85],{"id":84},"list-image-generation-models","查询图像生成模型",[87,88,93],"pre",{"className":89,"code":90,"language":91,"meta":92,"style":92},"language-bash shiki shiki-themes github-light github-dark","curl -s -H \"X-API-Key: $VISIONSTORY_API_KEY\" https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\u002Fmodels\n","bash","",[56,94,95],{"__ignoreMap":92},[96,97,100,104,108,111,115,119,122],"span",{"class":98,"line":99},"line",1,[96,101,103],{"class":102},"sScJk","curl",[96,105,107],{"class":106},"sj4cs"," -s",[96,109,110],{"class":106}," -H",[96,112,114],{"class":113},"sZZnC"," \"X-API-Key: ",[96,116,118],{"class":117},"sVt8B","$VISIONSTORY_API_KEY",[96,120,121],{"class":113},"\"",[96,123,124],{"class":113}," https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\u002Fmodels\n",[10,126,127,128,131,132,135],{},"每个模型会返回画面比例、可用分辨率及默认值、提示词长度上限、参考图数量上限和实时价格。",[56,129,130],{},"credit_per_image"," 表示默认分辨率的价格，",[56,133,134],{},"credit_by_resolution"," 提供每个可用分辨率的价格。接入时应读取此接口的返回值，不要写死模型能力或价格。",[29,137,138,155],{},[32,139,140],{},[35,141,142,145,148,152],{},[38,143,144],{},"模型",[38,146,147],{},"分辨率",[38,149,151],{"align":150},"right","提示词上限",[38,153,154],{"align":150},"参考图上限",[48,156,157,183,202,224,244,264,283],{},[35,158,159,164,177,180],{},[53,160,161],{},[56,162,163],{},"nano-banana-2",[53,165,166,167,170,171,173,174],{},"默认 ",[56,168,169],{},"1K","；支持 ",[56,172,169],{},"、",[56,175,176],{},"2K",[53,178,179],{"align":150},"5,000 字符",[53,181,182],{"align":150},"4 张",[35,184,185,190,198,200],{},[53,186,187],{},[56,188,189],{},"nano-banana-pro",[53,191,166,192,170,194,173,196],{},[56,193,169],{},[56,195,169],{},[56,197,176],{},[53,199,179],{"align":150},[53,201,182],{"align":150},[35,203,204,209,218,221],{},[53,205,206],{},[56,207,208],{},"seedream-5.0-lite",[53,210,166,211,170,213,173,215],{},[56,212,176],{},[56,214,176],{},[56,216,217],{},"4K",[53,219,220],{"align":150},"3,000 字符",[53,222,223],{"align":150},"14 张",[35,225,226,231,239,241],{},[53,227,228],{},[56,229,230],{},"seedream-5.0-pro",[53,232,166,233,170,235,173,237],{},[56,234,169],{},[56,236,169],{},[56,238,176],{},[53,240,220],{"align":150},[53,242,243],{"align":150},"10 张",[35,245,246,251,259,261],{},[53,247,248],{},[56,249,250],{},"gpt-image-2.5-flare",[53,252,166,253,170,255,173,257],{},[56,254,169],{},[56,256,169],{},[56,258,176],{},[53,260,179],{"align":150},[53,262,263],{"align":150},"6 张",[35,265,266,271,279,281],{},[53,267,268],{},[56,269,270],{},"gpt-image-2.5-sunburst",[53,272,166,273,170,275,173,277],{},[56,274,169],{},[56,276,169],{},[56,278,176],{},[53,280,179],{"align":150},[53,282,263],{"align":150},[35,284,285,290,298,300],{},[53,286,287],{},[56,288,289],{},"gpt-image-2",[53,291,166,292,170,294,173,296],{},[56,293,169],{},[56,295,169],{},[56,297,176],{},[53,299,179],{"align":150},[53,301,263],{"align":150},[10,303,304,305,173,308,173,311,173,314,173,317,173,320,173,323,173,326,173,329,332,333,336,337,344],{},"当前七个模型均支持 ",[56,306,307],{},"1:1",[56,309,310],{},"2:3",[56,312,313],{},"3:2",[56,315,316],{},"3:4",[56,318,319],{},"4:3",[56,321,322],{},"4:5",[56,324,325],{},"5:4",[56,327,328],{},"9:16",[56,330,331],{},"16:9"," 和 ",[56,334,335],{},"21:9","。模型可用性、限制、默认值和点数成本可能调整，因此每次设计模型选择流程前，都应查询 ",[338,339,341],"a",{"href":340},"\u002Freference\u002Fimages\u002Fget-image-models",[56,342,343],{},"GET \u002Fapi\u002Fv1\u002Fimage\u002Fmodels","。",[10,346,347,348,344],{},"GPT Image 可通过 API 调用。Flare 侧重更快的生成速度，Sunburst 侧重精确编辑、处理时间更长，GPT Image 2 则是上一代模型。质量档位由模型固定，不提供公开的质量参数。GPT Image 参考图支持 PNG、JPEG（含 MPO）和 WebP；服务会将 BMP、TIFF、GIF 和 HEIC 转换为 PNG。无法读取的参考图返回错误码 ",[56,349,350],{},"37101",[24,352,354],{"id":353},"generate-or-edit-an-ai-image","生成或编辑 AI 图像",[10,356,357,358,332,361,364,365,368,369,372],{},"传入模型接口返回的 ",[56,359,360],{},"model_id",[56,362,363],{},"prompt","。你可以使用 ",[56,366,367],{},"refs"," 指定风格或主体，也可以通过提示词与参考图直接",[19,370,371],{},"编辑图像","，无需蒙版。提示词长度、可用分辨率、默认分辨率和参考图数量均取决于所选模型。",[87,374,376],{"className":89,"code":375,"language":91,"meta":92,"style":92},"curl -s -X POST -H \"X-API-Key: $VISIONSTORY_API_KEY\" -H \"Content-Type: application\u002Fjson\" -d '{\"model_id\": \"seedream-5.0-lite\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"2K\"}' https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\n",[56,377,378],{"__ignoreMap":92},[96,379,380,382,384,387,390,392,394,396,398,400,403,406,409],{"class":98,"line":99},[96,381,103],{"class":102},[96,383,107],{"class":106},[96,385,386],{"class":106}," -X",[96,388,389],{"class":113}," POST",[96,391,110],{"class":106},[96,393,114],{"class":113},[96,395,118],{"class":117},[96,397,121],{"class":113},[96,399,110],{"class":106},[96,401,402],{"class":113}," \"Content-Type: application\u002Fjson\"",[96,404,405],{"class":106}," -d",[96,407,408],{"class":113}," '{\"model_id\": \"seedream-5.0-lite\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"2K\"}'",[96,410,411],{"class":113}," https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\n",[87,413,417],{"className":414,"code":415,"language":416,"meta":92,"style":92},"language-json shiki shiki-themes github-light github-dark","{\n  \"data\": {\n    \"url\": \"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\n  }\n}\n","json",[56,418,419,424,433,445,451],{"__ignoreMap":92},[96,420,421],{"class":98,"line":99},[96,422,423],{"class":117},"{\n",[96,425,427,430],{"class":98,"line":426},2,[96,428,429],{"class":106},"  \"data\"",[96,431,432],{"class":117},": {\n",[96,434,436,439,442],{"class":98,"line":435},3,[96,437,438],{"class":106},"    \"url\"",[96,440,441],{"class":117},": ",[96,443,444],{"class":113},"\"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\n",[96,446,448],{"class":98,"line":447},4,[96,449,450],{"class":117},"  }\n",[96,452,454],{"class":98,"line":453},5,[96,455,456],{"class":117},"}\n",[458,459,460,473,495,504,524],"ul",{},[461,462,463,466,467,470,471,344],"li",{},[19,464,465],{},"画面比例："," 使用 ",[56,468,469],{},"params.aspect_ratio.values"," 返回的值；当前默认值为 ",[56,472,307],{},[461,474,475,466,478,332,481,484,485,487,488,490,491,487,493,344],{},[19,476,477],{},"分辨率：",[56,479,480],{},"params.resolution.values",[56,482,483],{},"params.resolution.default","。特别注意，",[56,486,208],{}," 不接受 ",[56,489,169],{},"，",[56,492,230],{},[56,494,217],{},[461,496,497,500,501,344],{},[19,498,499],{},"提示词："," 不要超过所选模型的 ",[56,502,503],{},"params.prompt.max_length",[461,505,506,509,510,173,513,516,517,520,521,344],{},[19,507,508],{},"参考图："," 每项使用 ",[56,511,512],{},"asset_id",[56,514,515],{},"url"," 或 ",[56,518,519],{},"inline_data","，数量不得超过所选模型的 ",[56,522,523],{},"params.refs.max",[461,525,526,529],{},[19,527,528],{},"超时："," GPT Image 至少需要 180 秒的客户端超时。Python SDK、CLI 和本地 MCP 的图像请求超时至少为 180 秒，配置更长时会保留该值。不要自动重试超时请求：首次请求可能仍会成功，重复提交可能再次扣费。",[24,531,533],{"id":532},"use-a-generated-image-in-a-video","将生成的图像用于视频",[10,535,536,537,539,540,544,545,516,548,550],{},"返回的 ",[56,538,515],{}," 是普通图像地址，可以直接传给其他接口，例如作为 ",[338,541,543],{"href":542},"\u002Fguides\u002Fai-video","AI 视频","的 ",[56,546,547],{},"first_frame",[56,549,367],{},"：",[87,552,554],{"className":414,"code":553,"language":416,"meta":92,"style":92},"{\n  \"model_id\": \"seedance-2.0\",\n  \"prompt\": \"the scene gently comes alive, slow camera push-in\",\n  \"first_frame\": {\n    \"url\": \"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\n  }\n}\n",[56,555,556,560,573,585,592,600,605],{"__ignoreMap":92},[96,557,558],{"class":98,"line":99},[96,559,423],{"class":117},[96,561,562,565,567,570],{"class":98,"line":426},[96,563,564],{"class":106},"  \"model_id\"",[96,566,441],{"class":117},[96,568,569],{"class":113},"\"seedance-2.0\"",[96,571,572],{"class":117},",\n",[96,574,575,578,580,583],{"class":98,"line":435},[96,576,577],{"class":106},"  \"prompt\"",[96,579,441],{"class":117},[96,581,582],{"class":113},"\"the scene gently comes alive, slow camera push-in\"",[96,584,572],{"class":117},[96,586,587,590],{"class":98,"line":447},[96,588,589],{"class":106},"  \"first_frame\"",[96,591,432],{"class":117},[96,593,594,596,598],{"class":98,"line":453},[96,595,438],{"class":106},[96,597,441],{"class":117},[96,599,444],{"class":113},[96,601,603],{"class":98,"line":602},6,[96,604,450],{"class":117},[96,606,608],{"class":98,"line":607},7,[96,609,456],{"class":117},[24,611,613],{"id":612},"billing-limits-and-storage","计费、限制与存储",[458,615,616,633,650,656,670],{},[461,617,618,621,622,625,626,628,629,632],{},[19,619,620],{},"默认不加入素材库。"," 接口返回图像 URL，但",[19,623,624],{},"不会","自动保存到素材库。如需可复用的 ",[56,627,512],{},"，请通过 ",[56,630,631],{},"POST \u002Fapi\u002Fv1\u002Fasset"," 上传。",[461,634,635,638,639,344,641,643,644,646,647,649],{},[19,636,637],{},"计费："," 仅成功时扣费，按所选分辨率读取 ",[56,640,134],{},[56,642,130],{}," 仍表示默认分辨率的价格。当前 GPT Image 示例为 ",[56,645,169],{}," 2 点、",[56,648,176],{}," 3 点；提交前请查询实时价格。其他当前模型在各自支持的分辨率下价格相同。",[461,651,652,655],{},[19,653,654],{},"参数校验："," 不支持的分辨率返回 HTTP 400；参考图数量超过所选模型上限时返回 HTTP 422。",[461,657,658,661,662,665,666,669],{},[19,659,660],{},"失败语义："," 内容审核拒绝返回 HTTP 403 和错误码 ",[56,663,664],{},"37100","；其他上游失败返回 HTTP 403 和错误码 ",[56,667,668],{},"1","。这些失败均发生在扣费之前。",[461,671,672,675],{},[19,673,674],{},"并发："," Beta 期间，每个 API Key 的同步生成并发数较低；超出限制的请求会被拒绝，不会排队。",[24,677,679],{"id":678},"related-visionstory-api-guides","相关 VisionStory API 指南",[458,681,682,687],{},[461,683,684,686],{},[338,685,543],{"href":542}," — 将生成的图像转为视频。",[461,688,689,695],{},[338,690,692],{"href":691},"\u002Freference\u002Fimages\u002Fcreate-image",[56,693,694],{},"POST \u002Fapi\u002Fv1\u002Fimage"," — 查看完整请求结构与错误语义。",[697,698,699],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":92,"searchDepth":426,"depth":426,"links":701},[702,703,704,705,706,707],{"id":26,"depth":426,"text":27},{"id":84,"depth":426,"text":85},{"id":353,"depth":426,"text":354},{"id":532,"depth":426,"text":533},{"id":612,"depth":426,"text":613},{"id":678,"depth":426,"text":679},"通过 VisionStory API 调用 GPT Image、Seedream 5.0 与 Nano Banana 生成或编辑图像，了解分辨率定价、参考图限制与超时设置。","md",{},{"title":712,"order":713},"图像生成",8,"\u002Fguides-zh\u002Fimage-generation",{"title":5,"description":708},"guides-zh\u002Fimage-generation","xHxsfwu7sFxdyt8DWknKT-mZKs8hAEh6MGoc-Xkm9ug","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">curl\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -s\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -H\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"X-API-Key: \u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">$VISIONSTORY_API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\u002Fmodels\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">curl\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -s\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -X\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> POST\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -H\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"X-API-Key: \u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">$VISIONSTORY_API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -H\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"Content-Type: application\u002Fjson\"\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -d\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> '{\"model_id\": \"seedream-5.0-lite\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"2K\"}'\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"data\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"url\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"model_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"seedance-2.0\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"prompt\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"the scene gently comes alive, slow camera push-in\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"first_frame\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"url\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790231923840]