[{"data":1,"prerenderedAt":485},["ShallowReactive",2],{"guide-\u002Fguides-zh\u002Fimage-generation":3,"developer-code-yv63x7":481,"developer-code-ms6u8k":482,"developer-code-1vu0zq3":483,"developer-code-wmfbhl":484},{"id":4,"title":5,"body":6,"description":471,"extension":472,"meta":473,"navigation":474,"path":477,"seo":478,"stem":479,"__hash__":480},"guidesZh\u002Fguides-zh\u002Fimage-generation.md","AI 图像生成 API",{"type":7,"value":8,"toc":463},"minimark",[9,13,23,28,82,86,125,144,148,167,206,251,322,326,345,404,408,441,445,459],[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,136,139,140,143],{},"每个模型会返回画面比例、分辨率、参考图数量上限和 ",[56,129,130],{},"credit_per_image","。当前模型包括：",[56,133,134],{},"nano-banana","（速度快、成本低）、",[56,137,138],{},"nano-banana-2","（均衡、擅长编辑）和 ",[56,141,142],{},"nano-banana-pro","（最高质量、支持 2K）。接入时应读取此接口的返回值，不要写死模型能力。",[24,145,147],{"id":146},"generate-or-edit-an-ai-image","生成或编辑 AI 图像",[10,149,150,151,154,155,158,159,162,163,166],{},"传入模型接口返回的 ",[56,152,153],{},"model_id"," 和 ",[56,156,157],{},"prompt","。可选传入最多 4 个 ",[56,160,161],{},"refs","（参考图），用于指定风格或主体，也可用于",[19,164,165],{},"编辑图像","：通过提示词说明修改要求并附上参考图即可，无需蒙版。",[87,168,170],{"className":89,"code":169,"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\": \"nano-banana\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"1K\"}' https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\n",[56,171,172],{"__ignoreMap":92},[96,173,174,176,178,181,184,186,188,190,192,194,197,200,203],{"class":98,"line":99},[96,175,103],{"class":102},[96,177,107],{"class":106},[96,179,180],{"class":106}," -X",[96,182,183],{"class":113}," POST",[96,185,110],{"class":106},[96,187,114],{"class":113},[96,189,118],{"class":117},[96,191,121],{"class":113},[96,193,110],{"class":106},[96,195,196],{"class":113}," \"Content-Type: application\u002Fjson\"",[96,198,199],{"class":106}," -d",[96,201,202],{"class":113}," '{\"model_id\": \"nano-banana\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"1K\"}'",[96,204,205],{"class":113}," https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\n",[87,207,211],{"className":208,"code":209,"language":210,"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,212,213,218,227,239,245],{"__ignoreMap":92},[96,214,215],{"class":98,"line":99},[96,216,217],{"class":117},"{\n",[96,219,221,224],{"class":98,"line":220},2,[96,222,223],{"class":106},"  \"data\"",[96,225,226],{"class":117},": {\n",[96,228,230,233,236],{"class":98,"line":229},3,[96,231,232],{"class":106},"    \"url\"",[96,234,235],{"class":117},": ",[96,237,238],{"class":113},"\"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\n",[96,240,242],{"class":98,"line":241},4,[96,243,244],{"class":117},"  }\n",[96,246,248],{"class":98,"line":247},5,[96,249,250],{"class":117},"}\n",[252,253,254,294,307],"ul",{},[255,256,257,260,261,264,265,268,269,268,272,268,275,268,278,268,281,268,284,268,287,268,290,293],"li",{},[19,258,259],{},"画面比例："," 支持 ",[56,262,263],{},"1:1","（默认）\u002F ",[56,266,267],{},"2:3"," \u002F ",[56,270,271],{},"3:2",[56,273,274],{},"3:4",[56,276,277],{},"4:3",[56,279,280],{},"4:5",[56,282,283],{},"5:4",[56,285,286],{},"9:16",[56,288,289],{},"16:9",[56,291,292],{},"21:9","。",[255,295,296,299,300,303,304,293],{},[19,297,298],{},"分辨率："," ",[56,301,302],{},"1K","（默认）或 ",[56,305,306],{},"2K",[255,308,309,312,313,268,316,268,319,293],{},[19,310,311],{},"参考图："," 最多 4 张，每张使用 ",[56,314,315],{},"asset_id",[56,317,318],{},"url",[56,320,321],{},"inline_data",[24,323,325],{"id":324},"use-a-generated-image-in-a-video","将生成的图像用于视频",[10,327,328,329,331,332,337,338,341,342,344],{},"返回的 ",[56,330,318],{}," 是普通图像地址，可以直接传给其他接口，例如作为 ",[333,334,336],"a",{"href":335},"\u002Fguides\u002Fai-video","AI 视频","的 ",[56,339,340],{},"first_frame"," 或 ",[56,343,161],{},"：",[87,346,348],{"className":208,"code":347,"language":210,"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,349,350,354,367,379,386,394,399],{"__ignoreMap":92},[96,351,352],{"class":98,"line":99},[96,353,217],{"class":117},[96,355,356,359,361,364],{"class":98,"line":220},[96,357,358],{"class":106},"  \"model_id\"",[96,360,235],{"class":117},[96,362,363],{"class":113},"\"seedance-2.0\"",[96,365,366],{"class":117},",\n",[96,368,369,372,374,377],{"class":98,"line":229},[96,370,371],{"class":106},"  \"prompt\"",[96,373,235],{"class":117},[96,375,376],{"class":113},"\"the scene gently comes alive, slow camera push-in\"",[96,378,366],{"class":117},[96,380,381,384],{"class":98,"line":241},[96,382,383],{"class":106},"  \"first_frame\"",[96,385,226],{"class":117},[96,387,388,390,392],{"class":98,"line":247},[96,389,232],{"class":106},[96,391,235],{"class":117},[96,393,238],{"class":113},[96,395,397],{"class":98,"line":396},6,[96,398,244],{"class":117},[96,400,402],{"class":98,"line":401},7,[96,403,250],{"class":117},[24,405,407],{"id":406},"billing-limits-and-storage","计费、限制与存储",[252,409,410,427,435],{},[255,411,412,415,416,419,420,422,423,426],{},[19,413,414],{},"默认不加入素材库。"," 接口返回图像 URL，但",[19,417,418],{},"不会","自动保存到素材库。如需可复用的 ",[56,421,315],{},"，请通过 ",[56,424,425],{},"POST \u002Fapi\u002Fv1\u002Fasset"," 上传。",[255,428,429,432,433,293],{},[19,430,431],{},"计费："," 按图像张数扣除点数，仅在成功时收费；单张成本见模型接口的 ",[56,434,130],{},[255,436,437,440],{},[19,438,439],{},"并发："," Beta 期间，每个 API Key 的同步生成并发数较低；超出限制的请求会被拒绝，不会排队。",[24,442,444],{"id":443},"related-visionstory-api-guides","相关 VisionStory API 指南",[252,446,447,452],{},[255,448,449,451],{},[333,450,336],{"href":335}," — 将生成的图像转为视频。",[255,453,454,458],{},[333,455,457],{"href":456},"\u002Freference","API 参考"," — 查看完整请求结构和错误码。",[460,461,462],"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":220,"depth":220,"links":464},[465,466,467,468,469,470],{"id":26,"depth":220,"text":27},{"id":84,"depth":220,"text":85},{"id":146,"depth":220,"text":147},{"id":324,"depth":220,"text":325},{"id":406,"depth":220,"text":407},{"id":443,"depth":220,"text":444},"通过 VisionStory API 根据文本提示和参考素材生成或编辑图像，再将结果用于图生视频。","md",{},{"title":475,"order":476},"图像生成",8,"\u002Fguides-zh\u002Fimage-generation",{"title":5,"description":471},"guides-zh\u002Fimage-generation","Ww-BLd43XJE7d3kFaMwR58oqIubiZ5nMaTw2ejO9hC4","\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\": \"nano-banana\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"1K\"}'\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>",1788547143927]