{"default_endpoint":"image","display_name":"","endpoints":[{"content_types":["application/json"],"endpoint":"image","family":"image","kind":"image","lifecycle":{"cancel_path":"","mode":"sync","poll_method":"GET","poll_path":"/ai/v1/images/{id}","status_values":["pending","in_progress","completed","failed","cancelled"],"supports_async":true},"method":"POST","modality":"image","path":"/ai/v1/images/generations","request":{"envelope":"none","schema":{"additionalProperties":false,"properties":{"async":{"default":false,"type":"boolean"},"extra":{"additionalProperties":false,"description":"Vendor-specific long-tail parameter passthrough (escape hatch; equivalent to OpenRouter provider).","properties":{"optimize_prompt_options":{"additionalProperties":false,"description":"Prompt-optimization config; sub-property mode (string, default standard, enum standard/fast; fast unsupported on 5.0lite/4.5)","properties":{"mode":{"default":"standard","enum":["standard"],"type":"string"}},"type":"object","x-doc":"https://www.volcengine.com/docs/82379/1541523","x-providers":{"generate":{"to":["optimize_prompt_options"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"sequential_image_generation":{"description":"Image-group switch. auto = model decides grouping/count; disabled = single image only. seedream 5.0lite/4.5/4.0 only","enum":["auto","disabled"],"type":"string","x-doc":"https://www.volcengine.com/docs/82379/1541523","x-providers":{"generate":{"to":["sequential_image_generation"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"sequential_image_generation_options":{"description":"Image-group config (effective when sequential=auto); sub-property max_images (int, default 15, range [1,15]; reference + generated images \u003c= 15)","type":"object","x-doc":"https://www.volcengine.com/docs/82379/1541523","x-providers":{"generate":{"to":["sequential_image_generation_options"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"stream":{"default":false,"description":"Streaming output; true returns each image as soon as it is ready. 5.0lite/4.5/4.0 only","type":"boolean","x-doc":"https://www.volcengine.com/docs/82379/1541523","x-providers":{"generate":{"to":["stream"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"tools":{"description":"Model tool invocation; sub-property type (enum web_search). doubao-seedream-5.0-lite only","type":"array","x-doc":"https://www.volcengine.com/docs/82379/1541523","x-providers":{"generate":{"to":["tools"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"watermark":{"default":true,"description":"Bottom-right 'AI generated' watermark; false to omit","type":"boolean","x-doc":"https://www.volcengine.com/docs/82379/1541523","x-providers":{"generate":{"to":["watermark"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true}},"type":"object","x-evidence":"strong"},"image":{"description":"Source image for image-to-image / editing (URL or base64).","oneOf":[{"type":"string"},{"additionalProperties":false,"properties":{"url":{"type":"string"}},"required":["url"],"type":"object"}],"x-capability":"supports_image_input","x-evidence":"strong","x-media-ref":true},"images":{"description":"Source images for multi-image edit / reference. A single image input is coalesced into images[0] (x-coalesce-from bidirectional alias, image==images[0]).","items":{"description":"A media input reference. Accepts either a string (an http/https URL, a data URI, or raw base64) or an object of the form {url: ...}.\n","oneOf":[{"type":"string"},{"additionalProperties":false,"properties":{"url":{"type":"string"}},"required":["url"],"type":"object"}]},"maxItems":10,"type":"array","x-capability":"supports_multi_image","x-coalesce-from":"image","x-evidence":"strong","x-media-ref":true},"model":{"description":"Model name.","type":"string","x-evidence":"strong","x-skeleton":true},"n":{"default":1,"description":"Number of images to generate.","maximum":1,"minimum":1,"type":"integer","x-capability":"supports_n_gt_1","x-evidence":"strong"},"output_format":{"description":"Output image format.","enum":["png","jpeg"],"type":"string","x-evidence":"strong"},"prompt":{"description":"Text prompt describing the image to generate.","minLength":1,"type":"string","x-evidence":"strong","x-skeleton":true},"response_format":{"default":"url","description":"Preferred response format. url=download proxy via content_url; b64_json=inline for small images.","enum":["url","b64_json"],"type":"string","x-evidence":"strong"},"size":{"anyOf":[{"enum":["1K","1.5K","2K"],"type":"string","x-sizing":{"kind":"resolution","mode":"enum"}},{"pattern":"^[1-9][0-9]*x[1-9][0-9]*$","type":"string","x-sizing":{"constraints":{"aspectRatio":{"maximum":"16:1","minimum":"1:16"},"pixels":{"maximum":4624220,"minimum":921600}},"kind":"dimensions","mode":"custom"}},{"type":"null"}],"default":"2048x2048","description":"Image size in {width}x{height} format, or a resolution tier (e.g. 2K) kept for compatibility. Mutually exclusive with aspect_ratio (the vendor edge picks one at runtime).","x-evidence":"strong"},"webhook_events_filter":{"items":{"enum":["completed","failed","cancelled"],"type":"string"},"minItems":1,"type":"array","uniqueItems":true},"webhook_url":{"format":"uri","maxLength":512,"type":"string"}},"required":["model"],"type":"object"}},"schema_version":"1.17"}],"family":"image","modality":"image","model":"doubao-seedream-5-5","schema_version":"1.17"}