{"openapi":"3.1.0","info":{"title":"OpenAI Next · DRAW — media, chat and speech models","version":"v0.6.1","description":"Generated by NextLabs from real traffic: parameter types, ranges, defaults and descriptions; request examples are requests that actually ran, response examples are recorded. Where several models share a path, the body is a oneOf of their schemas, told apart by `model`. `x-nextlab-models` lists where each parameter goes in the native request and how async tasks finish."},"servers":[{"url":"https://draw.openai-next.com"}],"security":[{"bearer":[]}],"tags":[{"name":"ByteDance","description":"Models by ByteDance"},{"name":"Google","description":"Models by Google"},{"name":"MiniMax","description":"Models by MiniMax"},{"name":"OpenAI","description":"Models by OpenAI"},{"name":"Suno","description":"Models by Suno"},{"name":"xAI","description":"Models by xAI"}],"paths":{"/v1/images/generations":{"post":{"operationId":"post_v1_images_generations","tags":["OpenAI","ByteDance"],"summary":"20 models: gpt-image-2.5, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2, gpt-image-2-vip, gpt-image-1.5…","x-nextlab-models":[{"model":"gpt-image-2.5","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"gpt-image-2.5-flare","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"gpt-image-2.5-sunburst","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"gpt-image-2","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"gpt-image-2-vip","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"gpt-image-1.5","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"gpt-image-1","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"quality","wirePath":"quality","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"background","wirePath":"background","in":"body"},{"key":"output_format","wirePath":"output_format","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"doubao-seedream-5-0-pro-260628","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"doubao-seedream-5-0-260128","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"dola-seedream-5-0-pro-260628","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"},{"key":"reference_image","wirePath":"image[]","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"seedream-4-5-251128","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"seedream-4-0-250828","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"size","wirePath":"size","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-4.5","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-4.5-4k","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-4.1","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-4.1-4k","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-4.0","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-4.0-4k","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-3.1","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]},{"model":"jimeng-3.0","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"prompt","in":"body"}],"outputPath":"data[].url (or data[].b64_json)","notes":["Synchronous: the request stays open until the image is ready.","Slow generations can hit Cloudflare 524 timeouts; on the API platform use https://us.api.openai-next.com.","Output links are often temporary; download what you want to keep."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"model":{"const":"gpt-image-2.5","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 2.5 — Generate"},{"type":"object","properties":{"model":{"const":"gpt-image-2.5-flare","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 2.5 Flare — Generate"},{"type":"object","properties":{"model":{"const":"gpt-image-2.5-sunburst","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 2.5 Sunburst — Generate"},{"type":"object","properties":{"model":{"const":"gpt-image-2","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 2 — Generate"},{"type":"object","properties":{"model":{"const":"gpt-image-2-vip","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 2 VIP — Generate"},{"type":"object","properties":{"model":{"const":"gpt-image-1.5","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 1.5 — Generate"},{"type":"object","properties":{"model":{"const":"gpt-image-1","description":"Model ID"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536","auto"],"title":"Size","default":"auto","x-nextlab-key":"size"},"quality":{"type":"string","enum":["auto","low","medium","high"],"title":"Quality","default":"auto","x-nextlab-key":"quality"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","description":"Optional. Reference images turn this into image-to-image (gateway field `image`).","x-nextlab-key":"reference_image"}},"background":{"type":"string","enum":["auto","transparent","opaque"],"title":"Background","default":"auto","x-nextlab-key":"background"},"output_format":{"type":"string","enum":["png","jpeg","webp"],"title":"Output format","default":"png","x-nextlab-key":"output_format"}},"required":["model","prompt"],"title":"GPT Image 1 — Generate"},{"type":"object","properties":{"model":{"const":"doubao-seedream-5-0-pro-260628","description":"Model ID"},"size":{"type":"string","enum":["2K","4K"],"title":"Resolution","default":"2K","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":10,"title":"Reference images","x-nextlab-key":"reference_image"}},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","prompt"],"title":"Seedream 5.0 Pro — Generate"},{"type":"object","properties":{"model":{"const":"doubao-seedream-5-0-260128","description":"Model ID"},"size":{"type":"string","enum":["2K","4K"],"title":"Resolution","default":"2K","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":10,"title":"Reference images","x-nextlab-key":"reference_image"}},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","prompt"],"title":"Seedream 5.0 — Generate"},{"type":"object","properties":{"model":{"const":"dola-seedream-5-0-pro-260628","description":"Model ID"},"size":{"type":"string","enum":["2K","4K"],"title":"Resolution","default":"2K","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"image":{"type":"array","items":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":10,"title":"Reference images","x-nextlab-key":"reference_image"}},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","prompt"],"title":"Seedream 5.0 Pro (Dola) — Generate"},{"type":"object","properties":{"model":{"const":"seedream-4-5-251128","description":"Model ID"},"size":{"type":"string","enum":["2K","4K"],"title":"Resolution","default":"2K","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Seedream 4.5 — Generate"},{"type":"object","properties":{"model":{"const":"seedream-4-0-250828","description":"Model ID"},"size":{"type":"string","enum":["2K","4K"],"title":"Resolution","default":"2K","x-nextlab-key":"size"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Seedream 4.0 — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-4.5","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 4.5 — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-4.5-4k","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 4.5 4K — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-4.1","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 4.1 — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-4.1-4k","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 4.1 4K — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-4.0","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 4.0 — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-4.0-4k","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 4.0 4K — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-3.1","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 3.1 — Generate"},{"type":"object","properties":{"model":{"const":"jimeng-3.0","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Jimeng 3.0 — Generate"}]},"examples":{"gpt-image-2.5.generate":{"summary":"GPT Image 2.5 — Generate (real request)","value":{"model":"gpt-image-2.5","size":"1024x1024","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"gpt-image-2.5-flare.generate":{"summary":"GPT Image 2.5 Flare — Generate (real request)","value":{"model":"gpt-image-2.5-flare","size":"1024x1024","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"gpt-image-2.5-sunburst.generate":{"summary":"GPT Image 2.5 Sunburst — Generate (real request)","value":{"model":"gpt-image-2.5-sunburst","size":"1024x1024","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"gpt-image-2.generate":{"summary":"GPT Image 2 — Generate (real request)","value":{"model":"gpt-image-2","size":"1024x1024","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"gpt-image-2-vip.generate":{"summary":"GPT Image 2 VIP — Generate (real request)","value":{"model":"gpt-image-2-vip","size":"1024x1024","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"gpt-image-1.5.generate":{"summary":"GPT Image 1.5 — Generate (real request)","value":{"model":"gpt-image-1.5","size":"1024x1024","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"gpt-image-1.generate":{"summary":"GPT Image 1 — Generate (real request)","value":{"model":"gpt-image-1","size":"1024x1024","quality":"low","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"doubao-seedream-5-0-pro-260628.generate":{"summary":"Seedream 5.0 Pro — Generate (real request)","value":{"model":"doubao-seedream-5-0-pro-260628","size":"2K","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"doubao-seedream-5-0-260128.generate":{"summary":"Seedream 5.0 — Generate (real request)","value":{"model":"doubao-seedream-5-0-260128","size":"2K","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"dola-seedream-5-0-pro-260628.generate":{"summary":"Seedream 5.0 Pro (Dola) — Generate (sample)","value":{"model":"dola-seedream-5-0-pro-260628","size":"2K","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light"}},"seedream-4-5-251128.generate":{"summary":"Seedream 4.5 — Generate (sample)","value":{"model":"seedream-4-5-251128","size":"2K","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light"}},"seedream-4-0-250828.generate":{"summary":"Seedream 4.0 — Generate (sample)","value":{"model":"seedream-4-0-250828","size":"2K","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light"}},"jimeng-4.5.generate":{"summary":"Jimeng 4.5 — Generate (real request)","value":{"model":"jimeng-4.5","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"jimeng-4.5-4k.generate":{"summary":"Jimeng 4.5 4K — Generate (sample)","value":{"model":"jimeng-4.5-4k","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light"}},"jimeng-4.1.generate":{"summary":"Jimeng 4.1 — Generate (real request)","value":{"model":"jimeng-4.1","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"jimeng-4.1-4k.generate":{"summary":"Jimeng 4.1 4K — Generate (sample)","value":{"model":"jimeng-4.1-4k","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light"}},"jimeng-4.0.generate":{"summary":"Jimeng 4.0 — Generate (real request)","value":{"model":"jimeng-4.0","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"jimeng-4.0-4k.generate":{"summary":"Jimeng 4.0 4K — Generate (sample)","value":{"model":"jimeng-4.0-4k","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light"}},"jimeng-3.1.generate":{"summary":"Jimeng 3.1 — Generate (real request)","value":{"model":"jimeng-3.1","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}},"jimeng-3.0.generate":{"summary":"Jimeng 3.0 — Generate (real request)","value":{"model":"jimeng-3.0","prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"b64_json":{"type":"string"},"revised_prompt":{"type":"string"}},"required":["url","b64_json","revised_prompt"]}},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"prompt_tokens_details":{"type":"object","properties":{"cached_tokens":{"type":"integer"},"reasoning_tokens":{"type":"integer"}}},"completion_tokens_details":{"type":"object","properties":{"reasoning_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}}},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}}},"output_tokens_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"reasoning_tokens":{"type":"integer"},"image_tokens":{"type":"integer"}}}}}}},{"type":"object","properties":{"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"b64_json":{"type":"string"}},"required":["url","b64_json"]}},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"prompt_tokens_details":{"type":"object","properties":{"cached_tokens":{"type":"integer"},"reasoning_tokens":{"type":"integer"}}},"completion_tokens_details":{"type":"object","properties":{"reasoning_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}}},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}}},"output_tokens_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"reasoning_tokens":{"type":"integer"},"image_tokens":{"type":"integer"}}}}}}},{"type":"object","properties":{"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}},"usage":{"type":"object","properties":{"total_tokens":{"type":"integer"},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"image_tokens":{"type":"integer"}}}}}}},{"type":"object","properties":{"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"revised_prompt":{"type":"string"},"url":{"type":"string"}},"required":["revised_prompt","url"]}},"usage":{"type":"object","properties":{"total_tokens":{"type":"integer"},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"text_tokens":{"type":"integer"},"image_tokens":{"type":"integer"}}}}}}},{"type":"object","properties":{"created":{"type":"integer"},"background":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"b64_json":{"type":"string"}},"required":["b64_json"]}},"output_format":{"type":"string"},"quality":{"type":"string"},"size":{"type":"string"},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"image_tokens":{"type":"integer"},"text_tokens":{"type":"integer"}}},"output_tokens":{"type":"integer"},"output_tokens_details":{"type":"object","properties":{"image_tokens":{"type":"integer"},"text_tokens":{"type":"integer"}}},"total_tokens":{"type":"integer"}}}}},{"type":"object","properties":{"model":{"type":"string"},"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"size":{"type":"string"},"output_format":{"type":"string"}},"required":["url","size","output_format"]}},"usage":{"type":"object","properties":{"input_images":{"type":"integer"},"generated_images":{"type":"integer"},"output_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}}}}},{"type":"object","properties":{"model":{"type":"string"},"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"size":{"type":"string"}},"required":["url","size"]}},"usage":{"type":"object","properties":{"generated_images":{"type":"integer"},"output_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}}}}},{"type":"object","properties":{"created":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"prompt_tokens_details":{"type":"object","properties":{}},"completion_tokens_details":{"type":"object","properties":{}},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"cached_tokens":{"type":"integer"},"text_tokens":{"type":"integer"},"audio_tokens":{"type":"integer"},"image_tokens":{"type":"integer"},"video_tokens":{"type":"integer"}}}}}}}]},"examples":{"gpt-image-2.5.generate":{"summary":"GPT Image 2.5 (recorded 2026-10-11)","value":{"created":1791689174,"data":[{"url":"https://imagefil.scdn.app/public/image/319bbb9bcd5bdd18194ad1792cc242870.png","b64_json":"<base64 2049488 chars>","revised_prompt":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}],"usage":{"prompt_tokens":0,"completion_tokens":0,"total_tokens":229,"prompt_tokens_details":{"cached_tokens":0,"reasoning_tokens":0},"completion_tokens_details":{"reasoning_tokens":0,"cached_tokens":0},"input_tokens":21,"output_tokens":208,"input_tokens_details":{"text_tokens":21,"cached_tokens":0},"output_tokens_details":{"text_tokens":0,"reasoning_tokens":0,"image_tokens":208}}}},"gpt-image-2.5-flare.generate":{"summary":"GPT Image 2.5 Flare (recorded 2026-10-12)","value":{"created":1791796866,"data":[{"url":"https://imagefil.scdn.app/public/image/beb7ce3dbbbddd18de33d679f34417de0.png","b64_json":"<base64 1427928 chars>"}],"usage":{"prompt_tokens":0,"completion_tokens":0,"total_tokens":1785,"prompt_tokens_details":{"cached_tokens":0,"reasoning_tokens":0},"completion_tokens_details":{"reasoning_tokens":0,"cached_tokens":0},"input_tokens":29,"output_tokens":1756,"input_tokens_details":{"text_tokens":29,"cached_tokens":0},"output_tokens_details":{"text_tokens":0,"reasoning_tokens":0,"image_tokens":1756}}}},"gpt-image-2.5-sunburst.generate":{"summary":"GPT Image 2.5 Sunburst (recorded 2026-10-12)","value":{"created":1791796951,"data":[{"url":"https://imagefil.scdn.app/public/image/d2c358cac5bddd18a634d6791f17ab410.png","b64_json":"<base64 1501868 chars>"}],"usage":{"prompt_tokens":0,"completion_tokens":0,"total_tokens":1115,"prompt_tokens_details":{"cached_tokens":0,"reasoning_tokens":0},"completion_tokens_details":{"reasoning_tokens":0,"cached_tokens":0},"input_tokens":29,"output_tokens":1086,"input_tokens_details":{"text_tokens":29,"cached_tokens":0},"output_tokens_details":{"text_tokens":0,"reasoning_tokens":0,"image_tokens":1086}}}},"gpt-image-2.generate":{"summary":"GPT Image 2 (recorded 2026-10-11)","value":{"created":1791689218,"data":[{"url":"https://oss.filenest.top/uploads/f3c6be8c-35a6-461e-b040-750b84d68282.png"}],"usage":{"total_tokens":793,"input_tokens":28,"output_tokens":765,"input_tokens_details":{"text_tokens":28,"image_tokens":0}}}},"gpt-image-2-vip.generate":{"summary":"GPT Image 2 VIP (recorded 2026-10-12)","value":{"created":1791796660,"data":[{"revised_prompt":"","url":"https://pro.filesystem.site/cdn/20261012/37cc29af577b4bf4b34192a2c8305635.png"}],"usage":{"total_tokens":4196,"input_tokens":21,"output_tokens":4175,"input_tokens_details":{"text_tokens":21,"image_tokens":0}}}},"gpt-image-1.5.generate":{"summary":"GPT Image 1.5 (recorded 2026-10-12)","value":{"created":1791796994,"data":[{"revised_prompt":"","url":"https://pro.filesystem.site/cdn/20261012/4f75d6d6bab947e298ffb65658c9b40a.png"}],"usage":{"total_tokens":4196,"input_tokens":21,"output_tokens":4175,"input_tokens_details":{"text_tokens":21,"image_tokens":0}}}},"gpt-image-1.generate":{"summary":"GPT Image 1 (recorded 2026-10-12)","value":{"created":1791797022,"background":"opaque","data":[{"b64_json":"<base64 1760368 chars>"}],"output_format":"png","quality":"low","size":"1024x1024","usage":{"input_tokens":27,"input_tokens_details":{"image_tokens":0,"text_tokens":27},"output_tokens":272,"output_tokens_details":{"image_tokens":272,"text_tokens":0},"total_tokens":299}}},"doubao-seedream-5-0-pro-260628.generate":{"summary":"Seedream 5.0 Pro (recorded 2026-10-11)","value":{"model":"doubao-seedream-5-0-pro-260628","created":1791689303,"data":[{"url":"https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-5-0-pro/27936ff8de8e41bb12db6be036e8c6822e9dcb032042986197120/Image/2102132036/021791689240230bcd9e2286c8e630eb6bd21bb14e8ed8ff63972.jpeg?<redacted>","size":"1664x2496","output_format":"jpeg"}],"usage":{"input_images":0,"generated_images":1,"output_tokens":16224,"total_tokens":16224}}},"doubao-seedream-5-0-260128.generate":{"summary":"Seedream 5.0 (recorded 2026-10-12)","value":{"model":"doubao-seedream-5-0-260128","created":1791797418,"data":[{"url":"https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-5-0/021791797395502b71a54db2718758900f1b5b7cc45ea658eda99_0.jpeg?<redacted>","size":"1664x2496"}],"usage":{"generated_images":1,"output_tokens":16224,"total_tokens":16224}}},"jimeng-4.5.generate":{"summary":"Jimeng 4.5 (recorded 2026-10-11)","value":{"created":1791692568,"data":[{"url":"https://p16-dreamina-sign-sg.ibyteimg.com/tos-alisg-i-wopfjsm1ax-sg/9184d30bc2134d4e9ac3e94c9eb26e58~tplv-wopfjsm1ax-aigc_resize_mark:0:0.jpeg?<redacted>"}],"usage":{"prompt_tokens":1000,"total_tokens":1000,"prompt_tokens_details":{},"completion_tokens_details":{},"input_tokens":1000,"output_tokens":0,"input_tokens_details":{"cached_tokens":0,"text_tokens":1000,"audio_tokens":0,"image_tokens":0,"video_tokens":0}}}},"jimeng-4.1.generate":{"summary":"Jimeng 4.1 (recorded 2026-10-12)","value":{"created":1791797156,"data":[{"url":"https://p16-dreamina-sign-sg.ibyteimg.com/tos-alisg-i-wopfjsm1ax-sg/c82e9a8d6ce44a02b33be123034e4d74~tplv-wopfjsm1ax-aigc_resize_mark:0:0.jpeg?<redacted>"}],"usage":{"prompt_tokens":1000,"total_tokens":1000,"prompt_tokens_details":{},"completion_tokens_details":{},"input_tokens":1000,"output_tokens":0,"input_tokens_details":{"cached_tokens":0,"text_tokens":1000,"audio_tokens":0,"image_tokens":0,"video_tokens":0}}}},"jimeng-4.0.generate":{"summary":"Jimeng 4.0 (recorded 2026-10-12)","value":{"created":1791797333,"data":[{"url":"https://p16-dreamina-sign-sg.ibyteimg.com/tos-alisg-i-wopfjsm1ax-sg/a64de41dbc6b4c1a92c0b15d91737d8a~tplv-wopfjsm1ax-aigc_resize_mark:0:0.jpeg?<redacted>"}],"usage":{"prompt_tokens":1000,"total_tokens":1000,"prompt_tokens_details":{},"completion_tokens_details":{},"input_tokens":1000,"output_tokens":0,"input_tokens_details":{"cached_tokens":0,"text_tokens":1000,"audio_tokens":0,"image_tokens":0,"video_tokens":0}}}},"jimeng-3.1.generate":{"summary":"Jimeng 3.1 (recorded 2026-10-12)","value":{"created":1791797218,"data":[{"url":"https://p16-dreamina-sign-sg.ibyteimg.com/tos-alisg-i-wopfjsm1ax-sg/c4bd0a1f113448b799a2a5b8e2197eda~tplv-wopfjsm1ax-aigc_resize_mark:0:0.jpeg?<redacted>"}],"usage":{"prompt_tokens":1000,"total_tokens":1000,"prompt_tokens_details":{},"completion_tokens_details":{},"input_tokens":1000,"output_tokens":0,"input_tokens_details":{"cached_tokens":0,"text_tokens":1000,"audio_tokens":0,"image_tokens":0,"video_tokens":0}}}},"jimeng-3.0.generate":{"summary":"Jimeng 3.0 (recorded 2026-10-12)","value":{"created":1791797275,"data":[{"url":"https://p16-dreamina-sign-sg.ibyteimg.com/tos-alisg-i-wopfjsm1ax-sg/f79b31cdedea495fb18387e50309123d~tplv-wopfjsm1ax-aigc_resize_mark:0:0.jpeg?<redacted>"}],"usage":{"prompt_tokens":1000,"total_tokens":1000,"prompt_tokens_details":{},"completion_tokens_details":{},"input_tokens":1000,"output_tokens":0,"input_tokens_details":{"cached_tokens":0,"text_tokens":1000,"audio_tokens":0,"image_tokens":0,"video_tokens":0}}}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-3.1-flash-image-preview:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_3_1_flash_image_preview_generateContent","tags":["Google"],"summary":"gemini-3.1-flash-image-preview","x-nextlab-models":[{"model":"gemini-3.1-flash-image-preview","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"image_size","wirePath":"generationConfig.imageConfig.imageSize","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9","1:4","4:1","1:8","8:1"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"},"imageSize":{"type":"string","enum":["1K","512","2K","4K"],"title":"Resolution","default":"1K","x-nextlab-key":"image_size"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana 2 — Generate"},"examples":{"gemini-3.1-flash-image-preview.generate":{"summary":"Nano Banana 2 — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"}}},"modelVersion":{"type":"string"},"responseId":{"type":"string"}}},"examples":{"gemini-3.1-flash-image-preview.generate":{"summary":"Nano Banana 2 (recorded 2026-10-11)","value":{"candidates":[{"content":{"role":"model","parts":[{"inlineData":{"mimeType":"image/jpeg","data":"<base64 898256 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":29,"candidatesTokenCount":1058,"totalTokenCount":1087},"modelVersion":"gemini-3.1-flash-image-preview","responseId":"jky-60ad3af26d9e4d43a782d232827d2ef1"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-3.1-flash-image:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_3_1_flash_image_generateContent","tags":["Google"],"summary":"gemini-3.1-flash-image","x-nextlab-models":[{"model":"gemini-3.1-flash-image","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"image_size","wirePath":"generationConfig.imageConfig.imageSize","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9","1:4","4:1","1:8","8:1"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"},"imageSize":{"type":"string","enum":["1K","512","2K","4K"],"title":"Resolution","default":"1K","x-nextlab-key":"image_size"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana 2 (GA) — Generate"},"examples":{"gemini-3.1-flash-image.generate":{"summary":"Nano Banana 2 (GA) — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"}}},"modelVersion":{"type":"string"},"responseId":{"type":"string"}}},"examples":{"gemini-3.1-flash-image.generate":{"summary":"Nano Banana 2 (GA) (recorded 2026-10-12)","value":{"candidates":[{"content":{"role":"model","parts":[{"inlineData":{"mimeType":"image/jpeg","data":"<base64 714920 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":29,"candidatesTokenCount":1556,"totalTokenCount":1585},"modelVersion":"nano-banana2","responseId":"jky-3e5fe52a66ee4a03afa53645d5736c1b"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-3.1-flash-lite-image:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_3_1_flash_lite_image_generateContent","tags":["Google"],"summary":"gemini-3.1-flash-lite-image","x-nextlab-models":[{"model":"gemini-3.1-flash-lite-image","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana 2 Lite — Generate"},"examples":{"gemini-3.1-flash-lite-image.generate":{"summary":"Nano Banana 2 Lite — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"thoughtSignature":{"type":"string"},"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["thoughtSignature","inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"},"promptTokensDetails":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string"},"tokenCount":{"type":"integer"}},"required":["modality","tokenCount"]}},"candidatesTokensDetails":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string"},"tokenCount":{"type":"integer"}},"required":["modality","tokenCount"]}}}},"modelVersion":{"type":"string"},"responseId":{"type":"string"}}},"examples":{"gemini-3.1-flash-lite-image.generate":{"summary":"Nano Banana 2 Lite (recorded 2026-10-12)","value":{"candidates":[{"content":{"role":"model","parts":[{"thoughtSignature":"<base64 1120884 chars>","inlineData":{"mimeType":"image/jpeg","data":"<base64 762328 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":22,"candidatesTokenCount":1561,"totalTokenCount":1583,"promptTokensDetails":[{"modality":"TEXT","tokenCount":22}],"candidatesTokensDetails":[{"modality":"IMAGE","tokenCount":1120}]},"modelVersion":"gemini-3.1-flash-lite-image","responseId":"i6fMaqmfDsHR-8YP2KCLkQo"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-3-pro-image:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_3_pro_image_generateContent","tags":["Google"],"summary":"gemini-3-pro-image","x-nextlab-models":[{"model":"gemini-3-pro-image","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"image_size","wirePath":"generationConfig.imageConfig.imageSize","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"},"imageSize":{"type":"string","enum":["1K","2K","4K"],"title":"Resolution","default":"1K","x-nextlab-key":"image_size"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana Pro (GA) — Generate"},"examples":{"gemini-3-pro-image.generate":{"summary":"Nano Banana Pro (GA) — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"}}},"modelVersion":{"type":"string"},"responseId":{"type":"string"}}},"examples":{"gemini-3-pro-image.generate":{"summary":"Nano Banana Pro (GA) (recorded 2026-10-12)","value":{"candidates":[{"content":{"role":"model","parts":[{"inlineData":{"mimeType":"image/jpeg","data":"<base64 902876 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":29,"candidatesTokenCount":1128,"totalTokenCount":1157},"modelVersion":"nano-banana-pro","responseId":"jky-77fd209c96d74fa88a3261fb4f691709"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-3-pro-image-preview:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_3_pro_image_preview_generateContent","tags":["Google"],"summary":"gemini-3-pro-image-preview","x-nextlab-models":[{"model":"gemini-3-pro-image-preview","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"image_size","wirePath":"generationConfig.imageConfig.imageSize","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"},"imageSize":{"type":"string","enum":["1K","2K","4K"],"title":"Resolution","default":"1K","x-nextlab-key":"image_size"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana Pro — Generate"},"examples":{"gemini-3-pro-image-preview.generate":{"summary":"Nano Banana Pro — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"}}},"modelVersion":{"type":"string"},"responseId":{"type":"string"}}},"examples":{"gemini-3-pro-image-preview.generate":{"summary":"Nano Banana Pro (recorded 2026-10-12)","value":{"candidates":[{"content":{"role":"model","parts":[{"inlineData":{"mimeType":"image/jpeg","data":"<base64 840560 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":29,"candidatesTokenCount":1869,"totalTokenCount":1898},"modelVersion":"nano-banana-pro","responseId":"jky-e2035a1a62dc4bae953f33ddd5b6b0f7"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-2.5-flash-image:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_2_5_flash_image_generateContent","tags":["Google"],"summary":"gemini-2.5-flash-image","x-nextlab-models":[{"model":"gemini-2.5-flash-image","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana — Generate"},"examples":{"gemini-2.5-flash-image.generate":{"summary":"Nano Banana — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"},"promptTokensDetails":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string"},"tokenCount":{"type":"integer"}},"required":["modality","tokenCount"]}},"candidatesTokensDetails":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string"},"tokenCount":{"type":"integer"}},"required":["modality","tokenCount"]}}}},"modelVersion":{"type":"string"},"responseId":{"type":"string"}}},"examples":{"gemini-2.5-flash-image.generate":{"summary":"Nano Banana (recorded 2026-10-12)","value":{"candidates":[{"content":{"role":"model","parts":[{"inlineData":{"mimeType":"image/png","data":"<base64 1958860 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":22,"candidatesTokenCount":1290,"totalTokenCount":1312,"promptTokensDetails":[{"modality":"TEXT","tokenCount":22}],"candidatesTokensDetails":[{"modality":"IMAGE","tokenCount":1290}]},"modelVersion":"gemini-2.5-flash-image","responseId":"aqfMap3kDreP1MkPzeK3KA"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1beta/models/gemini-nano-banana-2.1:generateContent":{"post":{"operationId":"post_v1beta_models_gemini_nano_banana_2_1_generateContent","tags":["Google"],"summary":"gemini-nano-banana-2.1","x-nextlab-models":[{"model":"gemini-nano-banana-2.1","mode":"generate","task":"text-to-image","flow":"sync","params":[{"key":"prompt","wirePath":"contents[].parts[].text","in":"body"},{"key":"aspect_ratio","wirePath":"generationConfig.imageConfig.aspectRatio","in":"body"},{"key":"image_size","wirePath":"generationConfig.imageConfig.imageSize","in":"body"},{"key":"reference_image","wirePath":"contents[].parts[].fileData.fileUri","in":"body"}],"outputPath":"candidates[0].content.parts[].inlineData.data","notes":["Synchronous; images come back as base64 in candidates[0].content.parts[].inlineData.","Reference images may be data URLs (sent as inlineData) or public URLs (sent as fileData)."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"generationConfig":{"type":"object","properties":{"responseModalities":{"const":["IMAGE"],"description":"Constant for this mode"},"imageConfig":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9"],"title":"Aspect ratio","default":"1:1","x-nextlab-key":"aspect_ratio"},"imageSize":{"type":"string","enum":["1K","2K","4K"],"title":"Resolution","default":"1K","x-nextlab-key":"image_size"}}}}},"contents":{"type":"array","items":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"fileData":{"type":"object","properties":{"fileUri":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":14,"title":"Reference images","description":"Optional. Reference images enable editing and multi-image composition.","x-nextlab-key":"reference_image"}}}},"required":["text"]}}},"required":["parts"]}}},"required":["contents"],"title":"Nano Banana 2.1 — Generate"},"examples":{"gemini-nano-banana-2.1.generate":{"summary":"Nano Banana 2.1 — Generate (real request)","value":{"generationConfig":{"responseModalities":["IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}},"contents":[{"parts":[{"text":"A minimalist product poster: a glass perfume bottle on warm white paper, soft morning light, generous negative space"}]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"content":{"type":"object","properties":{"role":{"type":"string"},"parts":{"type":"array","items":{"type":"object","properties":{"inlineData":{"type":"object","properties":{"mimeType":{"type":"string"},"data":{"type":"string"}}}},"required":["inlineData"]}}}},"finishReason":{"type":"string"},"index":{"type":"integer"}},"required":["content","finishReason","index"]}},"usageMetadata":{"type":"object","properties":{"promptTokenCount":{"type":"integer"},"candidatesTokenCount":{"type":"integer"},"totalTokenCount":{"type":"integer"},"promptTokensDetails":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string"},"tokenCount":{"type":"integer"}},"required":["modality","tokenCount"]}},"candidatesTokensDetails":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string"},"tokenCount":{"type":"integer"}},"required":["modality","tokenCount"]}}}},"modelVersion":{"type":"string"}}},"examples":{"gemini-nano-banana-2.1.generate":{"summary":"Nano Banana 2.1 (recorded 2026-10-12)","value":{"candidates":[{"content":{"role":"model","parts":[{"inlineData":{"mimeType":"image/jpeg","data":"<base64 883204 chars>"}}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":26,"candidatesTokenCount":1120,"totalTokenCount":1146,"promptTokensDetails":[{"modality":"TEXT","tokenCount":26}],"candidatesTokensDetails":[{"modality":"IMAGE","tokenCount":1120}]},"modelVersion":"gemini-nano-banana-2.1"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/seedance/api/v3/contents/generations/tasks":{"post":{"operationId":"post_seedance_api_v3_contents_generations_tasks","tags":["ByteDance"],"summary":"4 models: doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615, doubao-seedance-2-5-260628","x-nextlab-models":[{"model":"doubao-seedance-2-0-260128","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-260128","mode":"image-to-video","task":"image-to-video","flow":"async","params":[{"key":"first_frame","wirePath":"content[role=first_frame].image_url.url","in":"body"},{"key":"last_frame","wirePath":"content[role=last_frame].image_url.url","in":"body"},{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-260128","mode":"reference-to-video","task":"reference-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"reference_image","wirePath":"content[role=reference_image].image_url.url","in":"body"},{"key":"reference_video","wirePath":"content[role=reference_video].video_url.url","in":"body"},{"key":"reference_audio","wirePath":"content[role=reference_audio].audio_url.url","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-fast-260128","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-fast-260128","mode":"image-to-video","task":"image-to-video","flow":"async","params":[{"key":"first_frame","wirePath":"content[role=first_frame].image_url.url","in":"body"},{"key":"last_frame","wirePath":"content[role=last_frame].image_url.url","in":"body"},{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-fast-260128","mode":"reference-to-video","task":"reference-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"reference_image","wirePath":"content[role=reference_image].image_url.url","in":"body"},{"key":"reference_video","wirePath":"content[role=reference_video].video_url.url","in":"body"},{"key":"reference_audio","wirePath":"content[role=reference_audio].audio_url.url","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-mini-260615","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-mini-260615","mode":"image-to-video","task":"image-to-video","flow":"async","params":[{"key":"first_frame","wirePath":"content[role=first_frame].image_url.url","in":"body"},{"key":"last_frame","wirePath":"content[role=last_frame].image_url.url","in":"body"},{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-0-mini-260615","mode":"reference-to-video","task":"reference-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"reference_image","wirePath":"content[role=reference_image].image_url.url","in":"body"},{"key":"reference_video","wirePath":"content[role=reference_video].video_url.url","in":"body"},{"key":"reference_audio","wirePath":"content[role=reference_audio].audio_url.url","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-5-260628","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-5-260628","mode":"image-to-video","task":"image-to-video","flow":"async","params":[{"key":"first_frame","wirePath":"content[role=first_frame].image_url.url","in":"body"},{"key":"last_frame","wirePath":"content[role=last_frame].image_url.url","in":"body"},{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]},{"model":"doubao-seedance-2-5-260628","mode":"reference-to-video","task":"reference-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"reference_image","wirePath":"content[role=reference_image].image_url.url","in":"body"},{"key":"reference_video","wirePath":"content[role=reference_video].video_url.url","in":"body"},{"key":"reference_audio","wirePath":"content[role=reference_audio].audio_url.url","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"generate_audio","wirePath":"generate_audio","in":"body"},{"key":"seed","wirePath":"seed","in":"body"},{"key":"watermark","wirePath":"watermark","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/seedance/api/v3/contents/generations/tasks/{task_id}"},"statusPath":"status","done":["succeeded"],"failed":["failed","expired","cancelled"],"outputPath":"content.video_url","notes":["Async task: pre-charged on submit, settled by actual usage after completion (measured: 480p 4 s pre-charged $0.80, settled ≈ $0.17).","content.video_url is a signed link valid for 24 hours; save the file promptly."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-260128","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 — Text to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-260128","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"image_url"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"First frame","x-nextlab-key":"first_frame"}}},"role":{"type":"string","const":"first_frame"}},"required":["type","image_url","role"]},{"type":"object","properties":{"role":{"type":"string","const":"last_frame"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Last frame","x-nextlab-key":"last_frame"}}}},"required":["role"]},{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 — Image to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-260128","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_image"},"image_url":{"type":"object","properties":{"url":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","x-nextlab-key":"reference_image"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_video"},"video_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference video","x-nextlab-key":"reference_video"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_audio"},"audio_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference audio","x-nextlab-key":"reference_audio"}}}},"required":["role"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 — Reference to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-fast-260128","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 Fast — Text to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-fast-260128","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"image_url"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"First frame","x-nextlab-key":"first_frame"}}},"role":{"type":"string","const":"first_frame"}},"required":["type","image_url","role"]},{"type":"object","properties":{"role":{"type":"string","const":"last_frame"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Last frame","x-nextlab-key":"last_frame"}}}},"required":["role"]},{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 Fast — Image to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-fast-260128","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_image"},"image_url":{"type":"object","properties":{"url":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","x-nextlab-key":"reference_image"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_video"},"video_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference video","x-nextlab-key":"reference_video"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_audio"},"audio_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference audio","x-nextlab-key":"reference_audio"}}}},"required":["role"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 Fast — Reference to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-mini-260615","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 Mini — Text to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-mini-260615","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"image_url"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"First frame","x-nextlab-key":"first_frame"}}},"role":{"type":"string","const":"first_frame"}},"required":["type","image_url","role"]},{"type":"object","properties":{"role":{"type":"string","const":"last_frame"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Last frame","x-nextlab-key":"last_frame"}}}},"required":["role"]},{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 Mini — Image to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-0-mini-260615","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_image"},"image_url":{"type":"object","properties":{"url":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","x-nextlab-key":"reference_image"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_video"},"video_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference video","x-nextlab-key":"reference_video"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_audio"},"audio_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference audio","x-nextlab-key":"reference_audio"}}}},"required":["role"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.0 Mini — Reference to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-5-260628","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.5 — Text to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-5-260628","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"image_url"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"First frame","x-nextlab-key":"first_frame"}}},"role":{"type":"string","const":"first_frame"}},"required":["type","image_url","role"]},{"type":"object","properties":{"role":{"type":"string","const":"last_frame"},"image_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Last frame","x-nextlab-key":"last_frame"}}}},"required":["role"]},{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.5 — Image to video"},{"type":"object","properties":{"model":{"const":"doubao-seedance-2-5-260628","description":"Model ID"},"ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9","adaptive"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"720p","x-nextlab-key":"resolution"},"duration":{"type":"integer","minimum":4,"maximum":15,"title":"Duration","description":"(s)","default":5,"x-nextlab-key":"duration"},"generate_audio":{"type":"boolean","title":"Generate audio","default":true,"x-nextlab-key":"generate_audio"},"content":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_image"},"image_url":{"type":"object","properties":{"url":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4,"title":"Reference images","x-nextlab-key":"reference_image"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_video"},"video_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference video","x-nextlab-key":"reference_video"}}}},"required":["role"]},{"type":"object","properties":{"role":{"type":"string","const":"reference_audio"},"audio_url":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Reference audio","x-nextlab-key":"reference_audio"}}}},"required":["role"]}]}},"seed":{"type":"integer","minimum":-1,"title":"Seed","description":"Same seed and params give similar results; -1 is random.","x-nextlab-key":"seed"},"watermark":{"type":"boolean","title":"Watermark","default":false,"x-nextlab-key":"watermark"}},"required":["model","content"],"title":"Seedance 2.5 — Reference to video"}]},"examples":{"doubao-seedance-2-0-260128.text-to-video":{"summary":"Seedance 2.0 — Text to video (real request)","value":{"model":"doubao-seedance-2-0-260128","ratio":"16:9","resolution":"480p","duration":4,"generate_audio":false,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, reflections of neon signs on the water, cinematic"}]}},"doubao-seedance-2-0-260128.image-to-video":{"summary":"Seedance 2.0 — Image to video (sample)","value":{"model":"doubao-seedance-2-0-260128","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"image_url","image_url":{"url":"https://example.com/reference.png"},"role":"first_frame"}]}},"doubao-seedance-2-0-260128.reference-to-video":{"summary":"Seedance 2.0 — Reference to video (sample)","value":{"model":"doubao-seedance-2-0-260128","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, cinematic"}]}},"doubao-seedance-2-0-fast-260128.text-to-video":{"summary":"Seedance 2.0 Fast — Text to video (real request)","value":{"model":"doubao-seedance-2-0-fast-260128","ratio":"16:9","resolution":"480p","duration":4,"generate_audio":false,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, reflections of neon signs on the water, cinematic"}]}},"doubao-seedance-2-0-fast-260128.image-to-video":{"summary":"Seedance 2.0 Fast — Image to video (sample)","value":{"model":"doubao-seedance-2-0-fast-260128","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"image_url","image_url":{"url":"https://example.com/reference.png"},"role":"first_frame"}]}},"doubao-seedance-2-0-fast-260128.reference-to-video":{"summary":"Seedance 2.0 Fast — Reference to video (sample)","value":{"model":"doubao-seedance-2-0-fast-260128","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, cinematic"}]}},"doubao-seedance-2-0-mini-260615.text-to-video":{"summary":"Seedance 2.0 Mini — Text to video (real request)","value":{"model":"doubao-seedance-2-0-mini-260615","ratio":"16:9","resolution":"480p","duration":4,"generate_audio":false,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, reflections of neon signs on the water, cinematic"}]}},"doubao-seedance-2-0-mini-260615.image-to-video":{"summary":"Seedance 2.0 Mini — Image to video (sample)","value":{"model":"doubao-seedance-2-0-mini-260615","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"image_url","image_url":{"url":"https://example.com/reference.png"},"role":"first_frame"}]}},"doubao-seedance-2-0-mini-260615.reference-to-video":{"summary":"Seedance 2.0 Mini — Reference to video (sample)","value":{"model":"doubao-seedance-2-0-mini-260615","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, cinematic"}]}},"doubao-seedance-2-5-260628.text-to-video":{"summary":"Seedance 2.5 — Text to video (real request)","value":{"model":"doubao-seedance-2-5-260628","ratio":"16:9","resolution":"480p","duration":4,"generate_audio":false,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, reflections of neon signs on the water, cinematic"}]}},"doubao-seedance-2-5-260628.image-to-video":{"summary":"Seedance 2.5 — Image to video (sample)","value":{"model":"doubao-seedance-2-5-260628","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"image_url","image_url":{"url":"https://example.com/reference.png"},"role":"first_frame"}]}},"doubao-seedance-2-5-260628.reference-to-video":{"summary":"Seedance 2.5 — Reference to video (sample)","value":{"model":"doubao-seedance-2-5-260628","ratio":"16:9","resolution":"720p","duration":5,"generate_audio":true,"content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, cinematic"}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"created_at":{"type":"integer"},"id":{"type":"string"},"model":{"type":"string"},"status":{"type":"string"}}},"examples":{"doubao-seedance-2-0-260128.text-to-video":{"summary":"Seedance 2.0 (recorded 2026-10-18)","value":{"created_at":1792331672,"id":"task_DaUaMV8AYnhCfhX7oyWF3RqcrnvKOkuu","model":"doubao-seedance-2-0-260128","status":"queued"}},"doubao-seedance-2-0-fast-260128.text-to-video":{"summary":"Seedance 2.0 Fast (recorded 2026-10-12)","value":{"created_at":1791804531,"id":"task_zqMQGcfOJgjxO7iCDGuitTuLsUWeqRAd","model":"doubao-seedance-2-0-fast-260128","status":"queued"}},"doubao-seedance-2-0-mini-260615.text-to-video":{"summary":"Seedance 2.0 Mini (recorded 2026-10-11)","value":{"created_at":1791689332,"id":"task_fwjBJz3oa4v5HKSOncsNBWwKfq20PGt8","model":"doubao-seedance-2-0-mini-260615","status":"queued"}},"doubao-seedance-2-5-260628.text-to-video":{"summary":"Seedance 2.5 (recorded 2026-10-18)","value":{"created_at":1792331672,"id":"task_ITdJOhKklU03g5Uya66mJ2kPFEeJV94w","model":"doubao-seedance-2-5-260628","status":"queued"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/seedance/api/v3/contents/generations/tasks/{task_id}":{"get":{"operationId":"get_seedance_api_v3_contents_generations_tasks_task_id_","tags":["ByteDance"],"summary":"4 models: doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615, doubao-seedance-2-5-260628","x-nextlab-models":[{"model":"doubao-seedance-2-0-260128","mode":"text-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-260128","mode":"image-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-260128","mode":"reference-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-fast-260128","mode":"text-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-fast-260128","mode":"image-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-fast-260128","mode":"reference-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-mini-260615","mode":"text-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-mini-260615","mode":"image-to-video","flow":"poll"},{"model":"doubao-seedance-2-0-mini-260615","mode":"reference-to-video","flow":"poll"},{"model":"doubao-seedance-2-5-260628","mode":"text-to-video","flow":"poll"},{"model":"doubao-seedance-2-5-260628","mode":"image-to-video","flow":"poll"},{"model":"doubao-seedance-2-5-260628","mode":"reference-to-video","flow":"poll"}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"cgtId":{"type":"string"},"content":{"type":"object","properties":{"video_url":{"type":"string"}}},"created_at":{"type":"integer"},"draft":{"type":"boolean"},"duration":{"type":"integer"},"execution_expires_after":{"type":"integer"},"framespersecond":{"type":"integer"},"generate_audio":{"type":"boolean"},"id":{"type":"string"},"model":{"type":"string"},"ratio":{"type":"string"},"resolution":{"type":"string"},"seed":{"type":"integer"},"service_tier":{"type":"string"},"status":{"type":"string"},"task_id":{"type":"string"},"updated_at":{"type":"integer"},"usage":{"type":"object","properties":{"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}}}}},{"type":"object","properties":{"content":{"type":"object","properties":{"video_url":{"type":"string"}}},"created_at":{"type":"integer"},"duration":{"type":"integer"},"execution_expires_after":{"type":"integer"},"framespersecond":{"type":"integer"},"generate_audio":{"type":"boolean"},"id":{"type":"string"},"model":{"type":"string"},"ratio":{"type":"string"},"resolution":{"type":"string"},"seed":{"type":"integer"},"status":{"type":"string"},"task_id":{"type":"string"},"tools":{"type":"array","items":{}},"updated_at":{"type":"integer"},"usage":{"type":"object","properties":{"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}}}}}]},"examples":{"doubao-seedance-2-0-260128.text-to-video":{"summary":"Seedance 2.0 — finished (recorded 2026-10-18)","value":{"cgtId":"cgt-20261018215436-dzzbl","content":{"video_url":"https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02179233167628900000000000000000000ffffac1742e8a5eb64.mp4?<redacted>"},"created_at":1792331672,"draft":false,"duration":4,"execution_expires_after":172800,"framespersecond":24,"generate_audio":false,"id":"task_DaUaMV8AYnhCfhX7oyWF3RqcrnvKOkuu","model":"doubao-seedance-2-0-260128","ratio":"16:9","resolution":"480p","seed":34348,"service_tier":"default","status":"succeeded","task_id":"VUsjokaetCABisXDiEPB07iyS2Go0ySRpJC4oZIJDmq9aA1nJbEhPzwsz89fVex52jjCTpo4sFC9SXMHozlBJWYO5AtfiBkAeLcfl50ivdbWnutN3EocZJCqze89i8h1t75XObIhfOt8","updated_at":1792331814,"usage":{"completion_tokens":40594,"total_tokens":40594}}},"doubao-seedance-2-0-fast-260128.text-to-video":{"summary":"Seedance 2.0 Fast — finished (recorded 2026-10-12)","value":{"content":{"video_url":"https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-fast/02179180453632300000000000000000000ffffac18141115f7d5.mp4?<redacted>"},"created_at":1791804531,"duration":4,"execution_expires_after":172800,"framespersecond":24,"generate_audio":false,"id":"task_zqMQGcfOJgjxO7iCDGuitTuLsUWeqRAd","model":"doubao-seedance-2-0-fast-260128","ratio":"16:9","resolution":"480p","seed":58198,"status":"succeeded","task_id":"COYbauYHfR57kyddYEPg8rKnuDhoYquviRKcjfnYt1Sopw3G1N1SAix85GEIcoNsCc8yOR6cO2O7IGFgjBt3YJaOVvgNqMoCjeAMJ3p7zROFzOzIuhrcWOPJ0crDcAl3YihT6XRIcvQWk3knVoA","tools":[],"updated_at":1791804685,"usage":{"completion_tokens":40594,"total_tokens":40594}}},"doubao-seedance-2-0-mini-260615.text-to-video":{"summary":"Seedance 2.0 Mini — finished (recorded 2026-10-11)","value":{"content":{"video_url":"https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02179168934539000000000000000000000ffffac17421319d567.mp4?<redacted>"},"created_at":1791689332,"duration":4,"execution_expires_after":172800,"framespersecond":24,"generate_audio":false,"id":"task_fwjBJz3oa4v5HKSOncsNBWwKfq20PGt8","model":"doubao-seedance-2-0-mini-260615","ratio":"16:9","resolution":"480p","seed":82718,"status":"succeeded","task_id":"8cdFRwPQSdUAWhgnBFpVLaDZf5JlnnIQAVa0eT3a4O8PqHWXwXKYne5D91nBpzIg56QFN50F3V6vj0tOsA9JEAcIW5J8Mq1q8NWVHTbv7YY6ZAMFrQMto4wivG5t8DYxbihPgrgcTWn10qzpreC","tools":[],"updated_at":1791689437,"usage":{"completion_tokens":40594,"total_tokens":40594}}},"doubao-seedance-2-5-260628.text-to-video":{"summary":"Seedance 2.5 — finished (recorded 2026-10-18)","value":{"content":{"video_url":"https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-5/2129101375/Video/zqr9d-54451281016202-tgc_7e352a17e381caffff00000000000000000000772586133297120/cgt-20261018215445-d9rqz.mp4?<redacted>"},"created_at":1792331672,"duration":4,"execution_expires_after":172800,"framespersecond":24,"generate_audio":false,"id":"task_ITdJOhKklU03g5Uya66mJ2kPFEeJV94w","model":"doubao-seedance-2-5-260628","ratio":"16:9","resolution":"480p","seed":67459,"status":"succeeded","task_id":"RC0afBiZx5jU3LRnUtHOODMiRLcVSpynqVya3BuWG3ekuhKJH4YCeTqd9KDj1blfDEy8NxbTr59rPkkTfh2MoPV4zgoV7dYjpCsJzW2jDHv1ypbgnHYognSx1KksTLG4qumc9EX26yP3","tools":[],"updated_at":1792331815,"usage":{"completion_tokens":38830,"total_tokens":38830}}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1/videos":{"post":{"operationId":"post_v1_videos","tags":["Google"],"summary":"2 models: veo3.1-fast, veo3.1","x-nextlab-models":[{"model":"veo3.1-fast","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"prompt","in":"form"},{"key":"aspect_ratio","wirePath":"aspect_ratio","in":"form"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/v1/videos/{task_id}"},"statusPath":"status","done":["completed","succeeded","success"],"failed":["failed","error","cancelled","expired"],"notes":["Submit as multipart/form-data; JSON bodies are rejected upstream (Unsupported content type).","If the finished task has no direct URL, download it from GET /v1/videos/{id}/content (needs the key — call it server-side)."]},{"model":"veo3.1","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"prompt","in":"form"},{"key":"aspect_ratio","wirePath":"aspect_ratio","in":"form"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/v1/videos/{task_id}"},"statusPath":"status","done":["completed","succeeded","success"],"failed":["failed","error","cancelled","expired"],"notes":["Submit as multipart/form-data; JSON bodies are rejected upstream (Unsupported content type).","If the finished task has no direct URL, download it from GET /v1/videos/{id}/content (needs the key — call it server-side)."]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"anyOf":[{"type":"object","properties":{"model":{"const":"veo3.1-fast","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"aspect_ratio"}},"required":["model","prompt"],"title":"Veo 3.1 Fast — Text to video"},{"type":"object","properties":{"model":{"const":"veo3.1","description":"Model ID"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"aspect_ratio"}},"required":["model","prompt"],"title":"Veo 3.1 — Text to video"}]}}}},"responses":{"200":{"description":"OK"},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/v1/videos/{task_id}":{"get":{"operationId":"get_v1_videos_task_id_","tags":["Google"],"summary":"2 models: veo3.1-fast, veo3.1","x-nextlab-models":[{"model":"veo3.1-fast","mode":"text-to-video","flow":"poll"},{"model":"veo3.1","mode":"text-to-video","flow":"poll"}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/hailuo/v2/video_generation":{"post":{"operationId":"post_hailuo_v2_video_generation","tags":["MiniMax"],"summary":"MiniMax-H3","x-nextlab-models":[{"model":"MiniMax-H3","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"content[type=text].text","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"ratio","wirePath":"ratio","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/hailuo/v2/query/video_generation/{task_id}"},"statusPath":"task.status","done":["succeeded"],"failed":["failed"],"outputPath":"task.content.url","notes":["resolution must be upper-case, e.g. 768P.","task.progress is a 0–1 fraction; 1 means done."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"const":"MiniMax-H3","description":"Model ID"},"resolution":{"type":"string","enum":["768P"],"title":"Resolution","default":"768P","x-nextlab-key":"resolution"},"duration":{"type":"integer","enum":[6,10],"title":"Duration","default":6,"x-nextlab-key":"duration"},"ratio":{"type":"string","enum":["16:9","9:16","1:1"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"ratio"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["type","text"]}}},"required":["model","content"],"title":"MiniMax H3 — Text to video"},"examples":{"MiniMax-H3.text-to-video":{"summary":"MiniMax H3 — Text to video (real request)","value":{"model":"MiniMax-H3","resolution":"768P","duration":6,"ratio":"16:9","content":[{"type":"text","text":"A paper boat drifting slowly down a rain-soaked street at dusk, reflections of neon signs on the water, cinematic"}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string"}}},"examples":{"MiniMax-H3.text-to-video":{"summary":"MiniMax H3 (recorded 2026-10-18)","value":{"task_id":"453748672639333"}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/hailuo/v2/query/video_generation/{task_id}":{"get":{"operationId":"get_hailuo_v2_query_video_generation_task_id_","tags":["MiniMax"],"summary":"MiniMax-H3","x-nextlab-models":[{"model":"MiniMax-H3","mode":"text-to-video","flow":"poll"}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"task":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"content":{"type":"object","properties":{"url":{"type":"string"}}},"resolution":{"type":"string"},"duration":{"type":"integer"},"usage":{"type":"object","properties":{"total_seconds":{"type":"integer"},"input_seconds":{"type":"integer"},"output_seconds":{"type":"integer"},"input_image_count":{"type":"integer"},"total_tokens":{"type":"integer"},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"}}},"ratio":{"type":"string"},"task_type":{"type":"string"}}}}},"examples":{"MiniMax-H3.text-to-video":{"summary":"MiniMax H3 — finished (recorded 2026-10-18)","value":{"task":{"id":"453748672639333","model":"MiniMax-H3","status":"succeeded","created_at":1792331673,"updated_at":1792331801,"content":{"url":"https://video-product.cdn.minimax.io/inference_output/rollout/2026-10-18/74a4ff76-10ec-4d1d-9415-16f56c0260af/output_aigc.mp4"},"resolution":"768P","duration":6,"usage":{"total_seconds":6,"input_seconds":0,"output_seconds":6,"input_image_count":0,"total_tokens":195294,"prompt_tokens":0,"completion_tokens":195294},"ratio":"16:9","task_type":"generation"}}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/xai-video/v1/videos/generations":{"post":{"operationId":"post_xai_video_v1_videos_generations","tags":["xAI"],"summary":"grok-imagine-0.9","x-nextlab-models":[{"model":"grok-imagine-0.9","mode":"text-to-video","task":"text-to-video","flow":"async","params":[{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"aspect_ratio","wirePath":"aspect_ratio","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/xai-video/v1/videos/{task_id}"},"statusPath":"status","done":["done"],"failed":["failed","expired"],"outputPath":"video.url","notes":[]},{"model":"grok-imagine-0.9","mode":"image-to-video","task":"image-to-video","flow":"async","params":[{"key":"image","wirePath":"image.url","in":"body"},{"key":"prompt","wirePath":"prompt","in":"body"},{"key":"duration","wirePath":"duration","in":"body"},{"key":"resolution","wirePath":"resolution","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/xai-video/v1/videos/{task_id}"},"statusPath":"status","done":["done"],"failed":["failed","expired"],"outputPath":"video.url","notes":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"model":{"const":"grok-imagine-0.9","description":"Model ID"},"duration":{"type":"integer","minimum":1,"maximum":15,"title":"Duration","description":"(s)","default":6,"x-nextlab-key":"duration"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","3:2","2:3"],"title":"Aspect ratio","default":"16:9","x-nextlab-key":"aspect_ratio"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"480p","x-nextlab-key":"resolution"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"}},"required":["model","prompt"],"title":"Grok Imagine — Text to video"},{"type":"object","properties":{"model":{"const":"grok-imagine-0.9","description":"Model ID"},"duration":{"type":"integer","minimum":1,"maximum":15,"title":"Duration","description":"(s)","default":6,"x-nextlab-key":"duration"},"resolution":{"type":"string","enum":["480p","720p"],"title":"Resolution","default":"480p","x-nextlab-key":"resolution"},"prompt":{"type":"string","title":"Prompt","description":"Describe what to generate. Be specific: subject, scene, style, lighting, camera.","x-nextlab-key":"prompt"},"image":{"type":"object","properties":{"url":{"type":"string","format":"uri","title":"Image","x-nextlab-key":"image"}}}},"required":["model","image","prompt"],"title":"Grok Imagine — Image to video"}]},"examples":{"grok-imagine-0.9.text-to-video":{"summary":"Grok Imagine — Text to video (sample)","value":{"model":"grok-imagine-0.9","duration":6,"aspect_ratio":"16:9","resolution":"480p","prompt":"A paper boat drifting slowly down a rain-soaked street at dusk, cinematic"}},"grok-imagine-0.9.image-to-video":{"summary":"Grok Imagine — Image to video (sample)","value":{"model":"grok-imagine-0.9","duration":6,"resolution":"480p","prompt":"A paper boat drifting slowly down a rain-soaked street at dusk, cinematic","image":{"url":"https://example.com/reference.png"}}}}}}},"responses":{"200":{"description":"OK"},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/xai-video/v1/videos/{task_id}":{"get":{"operationId":"get_xai_video_v1_videos_task_id_","tags":["xAI"],"summary":"grok-imagine-0.9","x-nextlab-models":[{"model":"grok-imagine-0.9","mode":"text-to-video","flow":"poll"},{"model":"grok-imagine-0.9","mode":"image-to-video","flow":"poll"}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/_open/suno/music/generate":{"post":{"operationId":"post_open_suno_music_generate","tags":["Suno"],"summary":"chirp-v4","x-nextlab-models":[{"model":"chirp-v4","mode":"inspiration","task":"text-to-music","flow":"async","params":[{"key":"description","wirePath":"gptDescriptionPrompt","in":"body"},{"key":"instrumental","wirePath":"makeInstrumental","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/_open/suno/music/getState?taskBatchId={task_id}"},"statusPath":"data.taskStatus","done":["finished"],"failed":["failed","error","cancelled"],"outputPath":"data.items[0].cld2AudioUrl","notes":["Each run produces two tracks, in data.items[].","Audio links live in a temporary directory; download what you want to keep."]},{"model":"chirp-v4","mode":"custom-lyrics","task":"lyrics-to-music","flow":"async","params":[{"key":"lyrics","wirePath":"prompt","in":"body"},{"key":"tags","wirePath":"tags","in":"body"},{"key":"title","wirePath":"title","in":"body"}],"poll":{"method":"GET","url":"https://draw.openai-next.com/_open/suno/music/getState?taskBatchId={task_id}"},"statusPath":"data.taskStatus","done":["finished"],"failed":["failed","error","cancelled"],"outputPath":"data.items[0].cld2AudioUrl","notes":["Each run produces two tracks, in data.items[].","Audio links live in a temporary directory; download what you want to keep."]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mvVersion":{"const":"chirp-v4","description":"Model ID"},"inputType":{"const":"10","description":"Constant for this mode"},"gptDescriptionPrompt":{"type":"string","maxLength":200,"title":"Song description","description":"Describe style, mood and use; lyrics and arrangement are generated. Returns two tracks.","x-nextlab-key":"description"},"makeInstrumental":{"type":"boolean","title":"Instrumental","default":false,"x-nextlab-key":"instrumental"}},"required":["mvVersion","inputType","gptDescriptionPrompt"],"title":"Suno v4 — Describe a song"},{"type":"object","properties":{"mvVersion":{"const":"chirp-v4","description":"Model ID"},"inputType":{"const":"20","description":"Constant for this mode"},"prompt":{"type":"string","maxLength":3000,"title":"Lyrics","description":"Supports structure tags like [Verse] and [Chorus].","x-nextlab-key":"lyrics"},"tags":{"type":"string","maxLength":200,"title":"Style tags","x-nextlab-key":"tags"},"title":{"type":"string","title":"Title","x-nextlab-key":"title"}},"required":["mvVersion","inputType","prompt","tags","title"],"title":"Suno v4 — Custom lyrics"}]},"examples":{"chirp-v4.inspiration":{"summary":"Suno v4 — Describe a song (real request)","value":{"mvVersion":"chirp-v4","inputType":"10","gptDescriptionPrompt":"a short warm lo-fi instrumental for a product launch video"}},"chirp-v4.custom-lyrics":{"summary":"Suno v4 — Custom lyrics (sample)","value":{"mvVersion":"chirp-v4","inputType":"20","prompt":"[Verse]\nCity lights flicker on\nThe highway hums along\n\n[Chorus]\nDriving home tonight","tags":"pop, female voice, warm","title":"Night Drive"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":"string"},"data":{"type":"object","properties":{"taskBatchId":{"type":"string"},"taskStatus":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"createTime":{"type":"string"},"id":{"type":"string"},"inputType":{"type":"string"},"gptDescriptionPrompt":{"type":"string"},"progress":{"type":"integer"},"status":{"type":"integer"},"progressMsg":{"type":"string"}},"required":["createTime","id","inputType","gptDescriptionPrompt","progress","status","progressMsg"]}}}}}},"examples":{"chirp-v4.inspiration":{"summary":"Suno v4 (recorded 2026-10-11)","value":{"code":200,"msg":"您已成功提交创作任务，目前剩余并发任务数为99","data":{"taskBatchId":"1316004241194344449","taskStatus":"create","items":[{"createTime":"2026-10-11T11:31:01.422+08:00","id":"2109124585252417538","inputType":"10","gptDescriptionPrompt":"a short warm lo-fi instrumental for a product launch video","progress":0,"status":0,"progressMsg":"Analyzing your creation..."},{"createTime":"2026-10-11T11:31:01.422+08:00","id":"2109124585252417539","inputType":"10","gptDescriptionPrompt":"a short warm lo-fi instrumental for a product launch video","progress":0,"status":0,"progressMsg":"Analyzing your creation..."}]}}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}},"/_open/suno/music/getState":{"get":{"operationId":"get_open_suno_music_getState","tags":["Suno"],"summary":"chirp-v4","x-nextlab-models":[{"model":"chirp-v4","mode":"inspiration","flow":"poll"},{"model":"chirp-v4","mode":"custom-lyrics","flow":"poll"}],"parameters":[{"name":"taskBatchId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":"string"},"data":{"type":"object","properties":{"taskBatchId":{"type":"string"},"taskStatus":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"createTime":{"type":"string"},"id":{"type":"string"},"inputType":{"type":"string"},"prompt":{"type":"string"},"gptDescriptionPrompt":{"type":"string"},"title":{"type":"string"},"tags":{"type":"string"},"duration":{"type":"number"},"progress":{"type":"integer"},"waitNum":{"type":"integer"},"status":{"type":"integer"},"cld2AudioUrl":{"type":"string"},"cld2ImageUrl":{"type":"string"},"progressMsg":{"type":"string"},"clipId":{"type":"string"}},"required":["createTime","id","inputType","prompt","gptDescriptionPrompt","title","tags","duration","progress","waitNum","status","cld2AudioUrl","cld2ImageUrl","progressMsg","clipId"]}}}}}},"examples":{"chirp-v4.inspiration":{"summary":"Suno v4 — finished (recorded 2026-10-11)","value":{"code":200,"msg":"操作成功","data":{"taskBatchId":"1316004241194344449","taskStatus":"finished","items":[{"createTime":"2026-10-11T11:31:01.000+08:00","id":"2109124585252417538","inputType":"10","prompt":"[Instrumental]","gptDescriptionPrompt":"a short warm lo-fi instrumental for a product launch video","title":"Soft Start","tags":"Lo-fi instrumental, carefully balanced clear modern mix with warm subtle tape texture; soft dusty drums, rounded bass, mellow electric piano chords, and a simple memorable plucked synth motif; brief piano-and-texture intro, gentle beat-and-bass entry, light melodic lift in the middle, clean resolution with a short natural tail; relaxed mid-tempo pocket.","duration":158.4,"progress":100,"waitNum":0,"status":30,"cld2AudioUrl":"https://file.lloongai.com/temp/suno/s104/2026/10/11/20261011113227A525.mp3","cld2ImageUrl":"https://cdn2.suno.ai/image_b8dd1c5d-141b-46a6-9d85-53f19399c742.jpeg","progressMsg":"Production completed","clipId":"b8dd1c5d-141b-46a6-9d85-53f19399c742"},{"createTime":"2026-10-11T11:31:01.000+08:00","id":"2109124585252417539","inputType":"10","prompt":"[Instrumental]","gptDescriptionPrompt":"a short warm lo-fi instrumental for a product launch video","title":"Soft Start","tags":"Lo-fi instrumental with mellow electric piano chords, rounded bass, soft dusty drums, and a simple memorable plucked synth motif; brief piano-and-texture intro, gentle beat-and-bass entry, light melodic lift, clean short tail; subtle tape texture, clear modern mix; relaxed mid-tempo pocket.","duration":122.36,"progress":100,"waitNum":0,"status":30,"cld2AudioUrl":"https://file.lloongai.com/temp/suno/s104/2026/10/11/20261011113232A526.mp3","cld2ImageUrl":"https://cdn2.suno.ai/image_df7a219b-7776-45e5-a864-9c75838405b1.jpeg","progressMsg":"Production completed","clipId":"df7a219b-7776-45e5-a864-9c75838405b1"}]}}}}}}},"400":{"$ref":"#/components/responses/error_content_blocked"},"401":{"$ref":"#/components/responses/error_invalid_key"},"403":{"$ref":"#/components/responses/error_insufficient_quota"},"404":{"$ref":"#/components/responses/error_upstream_model_not_found"},"406":{"$ref":"#/components/responses/error_upstream_rejected"},"429":{"$ref":"#/components/responses/error_overloaded"},"500":{"$ref":"#/components/responses/error_upstream_unreachable"},"503":{"$ref":"#/components/responses/error_no_channel"},"524":{"$ref":"#/components/responses/error_timeout"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer $OPENAI_NEXT_DRAW_API_KEY"}},"responses":{"error_invalid_key":{"description":"Invalid key — Missing or wrong key, or a key from the other platform — API and DRAW keys are not interchangeable. Use a key issued by the selected platform; the Lab detects a key's platform via /v1/models.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"}}}}},"example":{"error":{"message":"Invalid token. (request id: 2026101104530173855870796e93ae3rpPkpEIk)","type":"shell_api_error"}}}}},"error_no_channel":{"description":"Model not available — No channel on this platform serves the model for your key's group: a typo, a model listed only on the other platform, or a channel that is down. Check the model ID; see the Lab status page for which platform serves it, or switch to a similar model.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"}}}}},"example":{"error":{"message":"Current group default has no available channels for model kling-v2-6 under billing mode [pay-as-you-go, pay-per-request] (request id: 2026101103273627171594896e93ae3H2QvDMSv)","type":"shell_api_error"}}}}},"error_overloaded":{"description":"Upstream overloaded — The upstream model service is busy and the gateway refused the task. Retry later, or switch to a similar model.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"code":{"type":"string"}}},"example":{"message":"{\"error\":{\"message\":\"当前模型负载较高，请稍候重试，或者切换其他模型\"}}","type":"task_error","code":"fail_to_fetch_task"}}}},"error_upstream_unreachable":{"description":"Upstream unreachable — The gateway could not reach the upstream service (e.g. ECONNREFUSED). Failed requests may still be billed. Retry later; if it persists, check the model status page.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"code":{"type":"string"}}},"example":{"message":"{\"error\":{\"message\":\"connect ECONNREFUSED <upstream>\"}}","type":"task_error","code":"fail_to_fetch_task"}}}},"error_upstream_rejected":{"description":"Upstream rejected — The upstream service refused the request and the gateway relayed its error (e.g. the upstream account ran out of credit). A platform-side problem unrelated to your key; switch models or try later.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}},"example":{"code":-1,"message":"not ok match: {\"code\":\"permission-denied\",\"error\":\"Your team <redacted> has either used all available credits or reached its monthly spending limit. To continue making API requests, please purchase more credits or raise your spending limit.\"}"}}}},"error_upstream_model_not_found":{"description":"Model missing upstream — The platform forwarded the request to an upstream account that has no access to the model (or endpoint); the model is listed but can't run. A platform-side problem, not your parameters; use the other platform or a similar model.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"code":{"type":"string"}}}}},"example":{"error":{"message":"","type":"Not Found","code":"InvalidEndpointOrModel.NotFound"}}}}},"error_timeout":{"description":"Request timed out — A synchronous endpoint (such as image generation) ran past Cloudflare's 100-second limit. On the API platform, use the fallback https://us.api.openai-next.com (same routes).","content":{"application/json":{"schema":{"type":"object"}}}},"error_insufficient_quota":{"description":"Not enough credit — The key's balance or limit doesn't cover the pre-charge — async tasks (video and the like) are pre-charged at their maximum and settled afterwards. Top up the key or raise its limit, or use cheaper settings (shorter, lower resolution).","content":{"application/json":{"schema":{"type":"object"}}}},"error_content_blocked":{"description":"Blocked by content policy — The prompt, a reference image or the result tripped the upstream's content policy. Change the prompt or reference images and try again.","content":{"application/json":{"schema":{"type":"object"}}}}}}}