[{"data":1,"prerenderedAt":488},["ShallowReactive",2],{"guide-\u002Fguides\u002Fimage-generation":3,"developer-code-yv63x7":484,"developer-code-ms6u8k":485,"developer-code-1vu0zq3":486,"developer-code-wmfbhl":487},{"id":4,"title":5,"body":6,"description":475,"extension":476,"meta":477,"navigation":478,"path":480,"seo":481,"stem":482,"__hash__":483},"guides\u002Fguides\u002Fimage-generation.md","AI Image Generation API",{"type":7,"value":8,"toc":467},"minimark",[9,13,28,33,86,90,129,148,152,171,210,255,326,330,349,408,412,445,449,463],[10,11,12],"p",{},"The VisionStory AI Image Generation API creates or edits images from text prompts and optional reference media. The synchronous response returns an image URL that you can download or pass directly into an image-to-video workflow.",[14,15,16],"blockquote",{},[10,17,18,22,23,27],{},[19,20,21],"strong",{},"Beta access."," This endpoint is allowlisted during beta. If a request returns ",[24,25,26],"code",{},"403 \u002F not enabled",", contact your VisionStory representative. An active subscription is required.",[29,30,32],"h2",{"id":31},"ai-image-api-endpoints","AI image API endpoints",[34,35,36,52],"table",{},[37,38,39],"thead",{},[40,41,42,46,49],"tr",{},[43,44,45],"th",{},"Method",[43,47,48],{},"Path",[43,50,51],{},"What it does",[53,54,55,71],"tbody",{},[40,56,57,63,68],{},[58,59,60],"td",{},[24,61,62],{},"GET",[58,64,65],{},[24,66,67],{},"\u002Fapi\u002Fv1\u002Fimage\u002Fmodels",[58,69,70],{},"List image models with sizes and per-image credit cost",[40,72,73,78,83],{},[58,74,75],{},[24,76,77],{},"POST",[58,79,80],{},[24,81,82],{},"\u002Fapi\u002Fv1\u002Fimage",[58,84,85],{},"Generate an image from a prompt (+ optional references)",[29,87,89],{"id":88},"list-image-generation-models","List image generation models",[91,92,97],"pre",{"className":93,"code":94,"language":95,"meta":96,"style":96},"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","",[24,98,99],{"__ignoreMap":96},[100,101,104,108,112,115,119,123,126],"span",{"class":102,"line":103},"line",1,[100,105,107],{"class":106},"sScJk","curl",[100,109,111],{"class":110},"sj4cs"," -s",[100,113,114],{"class":110}," -H",[100,116,118],{"class":117},"sZZnC"," \"X-API-Key: ",[100,120,122],{"class":121},"sVt8B","$VISIONSTORY_API_KEY",[100,124,125],{"class":117},"\"",[100,127,128],{"class":117}," https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\u002Fmodels\n",[10,130,131,132,135,136,139,140,143,144,147],{},"Each model reports its aspect ratios, resolutions, reference-image limit, and ",[24,133,134],{},"credit_per_image",". Current models: ",[24,137,138],{},"nano-banana"," (fast, economical), ",[24,141,142],{},"nano-banana-2"," (balanced, strong edits), ",[24,145,146],{},"nano-banana-pro"," (highest quality, supports 2K). Drive your integration from this endpoint rather than hardcoding.",[29,149,151],{"id":150},"generate-or-edit-an-ai-image","Generate or edit an AI image",[10,153,154,155,158,159,162,163,166,167,170],{},"Send a ",[24,156,157],{},"model_id"," (from the models endpoint) and a ",[24,160,161],{},"prompt",". Optionally add up to 4 ",[24,164,165],{},"refs"," (reference images) to guide style or subject, or to ",[19,168,169],{},"edit"," — editing works through instructions in the prompt plus reference images, no mask needed.",[91,172,174],{"className":93,"code":173,"language":95,"meta":96,"style":96},"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",[24,175,176],{"__ignoreMap":96},[100,177,178,180,182,185,188,190,192,194,196,198,201,204,207],{"class":102,"line":103},[100,179,107],{"class":106},[100,181,111],{"class":110},[100,183,184],{"class":110}," -X",[100,186,187],{"class":117}," POST",[100,189,114],{"class":110},[100,191,118],{"class":117},[100,193,122],{"class":121},[100,195,125],{"class":117},[100,197,114],{"class":110},[100,199,200],{"class":117}," \"Content-Type: application\u002Fjson\"",[100,202,203],{"class":110}," -d",[100,205,206],{"class":117}," '{\"model_id\": \"nano-banana\", \"prompt\": \"A red panda barista in a cozy cafe, warm lighting\", \"aspect_ratio\": \"1:1\", \"resolution\": \"1K\"}'",[100,208,209],{"class":117}," https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fimage\n",[91,211,215],{"className":212,"code":213,"language":214,"meta":96,"style":96},"language-json shiki shiki-themes github-light github-dark","{\n  \"data\": {\n    \"url\": \"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\n  }\n}\n","json",[24,216,217,222,231,243,249],{"__ignoreMap":96},[100,218,219],{"class":102,"line":103},[100,220,221],{"class":121},"{\n",[100,223,225,228],{"class":102,"line":224},2,[100,226,227],{"class":110},"  \"data\"",[100,229,230],{"class":121},": {\n",[100,232,234,237,240],{"class":102,"line":233},3,[100,235,236],{"class":110},"    \"url\"",[100,238,239],{"class":121},": ",[100,241,242],{"class":117},"\"https:\u002F\u002Fcdn.visionstory.ai\u002Fexample.png\"\n",[100,244,246],{"class":102,"line":245},4,[100,247,248],{"class":121},"  }\n",[100,250,252],{"class":102,"line":251},5,[100,253,254],{"class":121},"}\n",[256,257,258,298,311],"ul",{},[259,260,261,264,265,268,269,272,273,272,276,272,279,272,282,272,285,272,288,272,291,272,294,297],"li",{},[19,262,263],{},"Aspect ratio:"," one of ",[24,266,267],{},"1:1"," (default) \u002F ",[24,270,271],{},"2:3"," \u002F ",[24,274,275],{},"3:2",[24,277,278],{},"3:4",[24,280,281],{},"4:3",[24,283,284],{},"4:5",[24,286,287],{},"5:4",[24,289,290],{},"9:16",[24,292,293],{},"16:9",[24,295,296],{},"21:9",".",[259,299,300,303,304,307,308,297],{},[19,301,302],{},"Resolution:"," ",[24,305,306],{},"1K"," (default) or ",[24,309,310],{},"2K",[259,312,313,316,317,272,320,272,323,297],{},[19,314,315],{},"References:"," up to 4, each ",[24,318,319],{},"asset_id",[24,321,322],{},"url",[24,324,325],{},"inline_data",[29,327,329],{"id":328},"use-a-generated-image-in-a-video","Use a generated image in a video",[10,331,332,333,335,336,339,340,342,343,348],{},"The returned ",[24,334,322],{}," is a normal image URL — pass it straight into other endpoints, e.g. as ",[24,337,338],{},"first_frame"," or ",[24,341,165],{}," for ",[344,345,347],"a",{"href":346},"\u002Fguides\u002Fai-video","AI Video",":",[91,350,352],{"className":212,"code":351,"language":214,"meta":96,"style":96},"{\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",[24,353,354,358,371,383,390,398,403],{"__ignoreMap":96},[100,355,356],{"class":102,"line":103},[100,357,221],{"class":121},[100,359,360,363,365,368],{"class":102,"line":224},[100,361,362],{"class":110},"  \"model_id\"",[100,364,239],{"class":121},[100,366,367],{"class":117},"\"seedance-2.0\"",[100,369,370],{"class":121},",\n",[100,372,373,376,378,381],{"class":102,"line":233},[100,374,375],{"class":110},"  \"prompt\"",[100,377,239],{"class":121},[100,379,380],{"class":117},"\"the scene gently comes alive, slow camera push-in\"",[100,382,370],{"class":121},[100,384,385,388],{"class":102,"line":245},[100,386,387],{"class":110},"  \"first_frame\"",[100,389,230],{"class":121},[100,391,392,394,396],{"class":102,"line":251},[100,393,236],{"class":110},[100,395,239],{"class":121},[100,397,242],{"class":117},[100,399,401],{"class":102,"line":400},6,[100,402,248],{"class":121},[100,404,406],{"class":102,"line":405},7,[100,407,254],{"class":121},[29,409,411],{"id":410},"billing-limits-and-storage","Billing, limits, and storage",[256,413,414,430,439],{},[259,415,416,419,420,423,424,427,428,297],{},[19,417,418],{},"Not stored by default."," The image is returned as a URL but ",[19,421,422],{},"not"," added to your asset library — upload it via ",[24,425,426],{},"POST \u002Fapi\u002Fv1\u002Fasset"," if you want a reusable ",[24,429,319],{},[259,431,432,435,436,438],{},[19,433,434],{},"Billing:"," credits per image (see ",[24,437,134],{}," from the models endpoint), charged only on success.",[259,440,441,444],{},[19,442,443],{},"Concurrency:"," synchronous generation is capped at a few concurrent requests per key during beta; excess requests are rejected rather than queued.",[29,446,448],{"id":447},"related-visionstory-api-guides","Related VisionStory API guides",[256,450,451,456],{},[259,452,453,455],{},[344,454,347],{"href":346}," — turn a generated image into video.",[259,457,458,462],{},[344,459,461],{"href":460},"\u002Freference","API reference"," — full request schema and error codes.",[464,465,466],"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":96,"searchDepth":224,"depth":224,"links":468},[469,470,471,472,473,474],{"id":31,"depth":224,"text":32},{"id":88,"depth":224,"text":89},{"id":150,"depth":224,"text":151},{"id":328,"depth":224,"text":329},{"id":410,"depth":224,"text":411},{"id":447,"depth":224,"text":448},"Generate or edit images from text prompts and reference media with the VisionStory API, then reuse the result in image-to-video workflows.","md",{},{"title":479,"order":405},"Image Generation","\u002Fguides\u002Fimage-generation",{"title":5,"description":475},"guides\u002Fimage-generation","1oy0EsaU2ov9MvAQ4SSlHhkzm_5l5eXZ9rFgMEcWxKc","\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>",1788166855862]