{ "checkedAt": "2026-10-28", "models": [ { "id": "seedance-2-0", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "seedance-2-0-fast", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "seedance-2-0-mini", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "seedance-2-5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "AWSD-5-pro-nsfw", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "CAT-SD2.0-903", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "doubao-seedance-2-0-260128", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "doubao-seedance-2-0-fast-260128", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "doubao-seedance-2-0-mini-260615", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "doubao-seedance-2-5-260628", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "gpt-image-2", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2 4K", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2 Adobe", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5 Adobe", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-flare", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-flare Adobe", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-flare Max", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-flare 4K", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-sunburst", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-sunburst Adobe", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-sunburst Max", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "gpt-image-2.5-sunburst 4K", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "grok-imagine-image-2.0", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "grok-imagine-nsfw-2.0", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "unsupported", "endpoint": null } } }, { "id": "grok-imagine-video-1.5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "JIAS-Grok-video-1.5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "JIAS-SD2.0-720P", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "JIAS-SD2.0-Pro", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "JIAS-SD2.5-Pro", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "kling-video-v3", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "kling-video-v3-omni", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "kling-video-v3-turbo", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "kling-video-v4", "endpoints": [], "status": "needs-verification", "capabilities": { "generation": { "status": "needs-verification", "endpoint": null } } }, { "id": "midjourney", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "Midjourney v6", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "Midjourney v6.1", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "Midjourney v7", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "Midjourney v8.1", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "Midjourney v8.2", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "minimaxH3-A", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "MX-SD-2.5-A", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "MX-SD-2.5-A2", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "MX-SD-2.5-B", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "nano-banana-2", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "nano-banana-2.1", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "nano-banana-pro", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "NSFW-seedance2.0", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "NSFW-seedance2.0-fast", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "NSFW-seedance2.0-mini", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "NSFW-seedance2.5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "RuoX-SD2.5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "RuoX-SD2.5-S", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "RuoX-wan3", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "RuoX-wan3-Prime", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "RuoX-wan3-smart", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "seedance2.0-A", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "seedance2.5-A", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "TX-SD2.0", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "TX-SD2.5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "video-ultra-720p", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "video-ultra-720p-fast", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "video-ultra-720p-mini", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "video-ultra2.5-720p", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "seedream-5-0", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "seedream-v5-pro", "endpoints": [ "image-generation" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/generations" } } }, { "id": "seedream-v5-pro-nsfw", "endpoints": [ "image-generation", "image-edit" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/images/generations" }, "reference": { "status": "documented", "endpoint": "/v1/images/edits" } } }, { "id": "VinH3", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "VinSeedance-2.0", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "VinSeedance-2.5", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "XING-SD2.0-933", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "XING-SD2.5-720", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "YUXI-H3-PRO", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "YUXI-SD2.0-A", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "YUXI-SD2.0-fast", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "YUXI-SD2.0-mini", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "YUXI-SD2.5-C", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.0-903", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.0-G", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.0-K", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.0-S", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.5-A", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.5-K", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.5-S", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.5-1080", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.5-480", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } }, { "id": "ZHKJ-SD2.5-720", "endpoints": [ "openai-video" ], "status": "documented", "capabilities": { "generation": { "status": "documented", "endpoint": "/v1/videos" } } } ], "videoModels": [ { "id": "grok-imagine-video-1.5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "grok-imagine-video-1.5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 1, "maximum": 15, "values": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ] }, { "name": "input_reference", "type": "object", "required": false, "description": "One first-frame image as an object: image_url is a publicly downloadable HTTPS URL.", "source": "url", "requiredProperties": [ "image_url" ], "properties": { "image_url": { "type": "string", "format": "uri", "pattern": "^https://" } }, "additionalProperties": false }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "minItems": 7 } ] }, { "id": "JIAS-Grok-video-1.5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "JIAS-Grok-video-1.5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 6000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 3, "maximum": 15, "values": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "face", "type": "object", "required": false, "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`.", "requiredProperties": [ "enabled" ], "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } } }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 7 } ] }, { "id": "JIAS-SD2.0-720P", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "JIAS-SD2.0-720P" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 6000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "face", "type": "object", "required": false, "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`.", "requiredProperties": [ "enabled" ], "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } } }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "JIAS-SD2.0-Pro", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "JIAS-SD2.0-Pro" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 6000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 15, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "face", "type": "object", "required": false, "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`.", "requiredProperties": [ "enabled" ], "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } } }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "JIAS-SD2.5-Pro", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "JIAS-SD2.5-Pro" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 6000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "face", "type": "object", "required": false, "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`.", "requiredProperties": [ "enabled" ], "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } } }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "kling-video-v3", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "kling-video-v3" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 3, "maximum": 15, "values": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p", "1080p", "4K" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 2 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "kling-video-v3-omni", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "kling-video-v3-omni" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 3, "maximum": 15, "values": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p", "1080p", "4K" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 7 } ] }, { "id": "kling-video-v3-turbo", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "kling-video-v3-turbo" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 3, "maximum": 15, "values": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p", "1080p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 1 } ] }, { "id": "minimaxH3-A", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "minimaxH3-A" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "MX-SD-2.5-B", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "MX-SD-2.5-B" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 10000 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 10, "maximum": 30, "values": [ "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ] }, { "name": "resolution", "type": "string", "required": true, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": true, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "mode", "type": "string", "required": false, "description": "Optional mode; omit for automatic selection. Accepted protocol values are `文生视频`, `图生视频` and `多模态`.", "values": [ "文生视频", "图生视频", "多模态" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "MX-SD-2.5-A", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "MX-SD-2.5-A" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "10" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "MX-SD-2.5-A2", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "MX-SD-2.5-A2" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "10" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "RuoX-SD2.5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "RuoX-SD2.5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "RuoX-SD2.5-S", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "RuoX-SD2.5-S" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "RuoX-wan3", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "RuoX-wan3" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 2, "maximum": 30, "values": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "10" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "1:1", "4:3", "16:9", "9:16" ], "default": "16:9" }, { "name": "input_reference", "type": "object", "required": false, "description": "One first-frame image as an object: image_url is a publicly downloadable HTTPS URL.", "source": "url", "requiredProperties": [ "image_url" ], "properties": { "image_url": { "type": "string", "format": "uri", "pattern": "^https://" } }, "additionalProperties": false }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "RuoX-wan3-Prime", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "RuoX-wan3-Prime" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 30, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "10" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "1:1", "4:3", "16:9", "9:16" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 } ] }, { "id": "RuoX-wan3-smart", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "RuoX-wan3-smart" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 2, "maximum": 30, "values": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480P", "720P", "1080P" ], "default": "720P" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16" ], "default": "16:9" }, { "name": "audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "prompt_extend", "type": "boolean", "required": false, "description": "Whether to expand the prompt." }, { "name": "watermark", "type": "boolean", "required": false, "description": "Whether to add a watermark." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 } ] }, { "id": "seedance2.0-A", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "seedance2.0-A" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "auto" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "seedance2.5-A", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "seedance2.5-A" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "CAT-SD2.0-903", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "CAT-SD2.0-903" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "4:3", "1:1", "3:4" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "TX-SD2.0", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "TX-SD2.0" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported.", "default": true }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "TX-SD2.5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "TX-SD2.5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ], "default": "1080p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported.", "default": true }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "XING-SD2.0-933", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "XING-SD2.0-933" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 15000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 15, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "doubao-seedance-2-0-260128", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "doubao-seedance-2-0-260128" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p", "4k" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "doubao-seedance-2-0-fast-260128", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "doubao-seedance-2-0-fast-260128" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "doubao-seedance-2-0-mini-260615", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "doubao-seedance-2-0-mini-260615" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "doubao-seedance-2-5-260628", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "doubao-seedance-2-5-260628" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "video-ultra-720p", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "video-ultra-720p" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "video-ultra-720p-fast", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "video-ultra-720p-fast" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "video-ultra-720p-mini", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "video-ultra-720p-mini" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "video-ultra2.5-720p", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "video-ultra2.5-720p" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "VinH3", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "VinH3" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 6000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ], "default": "16:9" }, { "name": "input_reference", "type": "object", "required": false, "description": "One first-frame image as an object: image_url is a publicly downloadable HTTPS URL.", "source": "url", "requiredProperties": [ "image_url" ], "properties": { "image_url": { "type": "string", "format": "uri", "pattern": "^https://" } }, "additionalProperties": false }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "VinSeedance-2.0", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "VinSeedance-2.0" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 15000 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "5", "10", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "camera_movement", "type": "string", "required": false, "description": "Camera motion: auto or fixed.", "values": [ "auto", "fixed" ] }, { "name": "native_face", "type": "boolean", "required": false, "description": "Face handling; true requires an image or video reference." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "VinSeedance-2.5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "VinSeedance-2.5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1, "maxLength": 15000 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 15, "maximum": 30, "values": [ "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "camera_movement", "type": "string", "required": false, "description": "Camera motion: auto or fixed.", "values": [ "auto", "fixed" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "YUXI-H3-PRO", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "YUXI-H3-PRO" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 1, "maximum": 15, "values": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "768p" ], "default": "768p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "YUXI-SD2.0-A", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "YUXI-SD2.0-A" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "5", "10", "15" ], "default": "15" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "YUXI-SD2.5-C", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "YUXI-SD2.5-C" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "30" ], "default": "30" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "NSFW-seedance2.0", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "NSFW-seedance2.0" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ] }, { "name": "resolution", "type": "string", "required": true, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p", "4k" ] }, { "name": "aspect_ratio", "type": "string", "required": true, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "watermark", "type": "boolean", "required": false, "description": "Whether to add a watermark." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "NSFW-seedance2.0-fast", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "NSFW-seedance2.0-fast" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ] }, { "name": "resolution", "type": "string", "required": true, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": true, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "watermark", "type": "boolean", "required": false, "description": "Whether to add a watermark." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "NSFW-seedance2.0-mini", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "NSFW-seedance2.0-mini" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ] }, { "name": "resolution", "type": "string", "required": true, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": true, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "watermark", "type": "boolean", "required": false, "description": "Whether to add a watermark." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "NSFW-seedance2.5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "NSFW-seedance2.5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 30, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ] }, { "name": "resolution", "type": "string", "required": true, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ] }, { "name": "aspect_ratio", "type": "string", "required": true, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "generate_audio", "type": "boolean", "required": false, "description": "Whether to generate an output audio track. Explicit false is supported." }, { "name": "watermark", "type": "boolean", "required": false, "description": "Whether to add a watermark." }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "ZHKJ-SD2.0-903", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.0-903" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "15" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "ZHKJ-SD2.0-G", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.0-G" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 15, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "ZHKJ-SD2.0-K", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.0-K" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "5", "10", "15" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "ZHKJ-SD2.0-S", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.0-S" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 15, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "ZHKJ-SD2.5-K", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.5-K" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "10", "15", "20", "25", "30" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 } ] }, { "id": "ZHKJ-SD2.5-S", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.5-S" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 30, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "ZHKJ-SD2.5-A", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.5-A" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "values": [ "30" ] }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "ZHKJ-SD2.5-480", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.5-480" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 30, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "ZHKJ-SD2.5-720", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.5-720" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 30, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "ZHKJ-SD2.5-1080", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "ZHKJ-SD2.5-1080" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": true, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 30, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "1080p" ], "default": "1080p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "XING-SD2.5-720", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "XING-SD2.5-720" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 5, "maximum": 30, "values": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "5" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "9:16" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 } ] }, { "id": "YUXI-SD2.0-fast", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "YUXI-SD2.0-fast" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "15" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "9:16" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "YUXI-SD2.0-mini", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "YUXI-SD2.0-mini" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "15" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "9:16" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 } ] }, { "id": "kling-video-v4", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "pending", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "kling-video-v4" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration as a string containing an integer from 3 to 30 seconds. Defaults to 10 seconds.", "values": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "10" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "720p", "1080p" ] }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Supported aspect ratios: 16:9, 9:16, 1:1 and 21:9. auto is available only when the request includes video or audio references.", "values": [ "16:9", "9:16", "1:1", "21:9", "auto" ] }, { "name": "reference_images", "type": "array", "required": false, "description": "For image-only requests, only the first two images are used as the first and last frames; submitting at most 2 images is recommended. Requests with video or audio references allow up to 10 images. All reference materials combined must not exceed 15.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Up to 5 reference videos, each 3–30 seconds and no larger than 300 MB. Their combined duration must not exceed 30 seconds. Use MP4 or MOV.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 5 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Up to 3 audio references for voice timbre, each 5–30 seconds and no larger than 50 MB. MP3 or WAV is recommended.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "enable_audio", "type": "boolean", "required": false, "description": "In mixed-reference mode only, enable_audio generates sound and keep_original_sound preserves the reference video’s original audio. Do not set both to true." }, { "name": "keep_original_sound", "type": "boolean", "required": false, "description": "In mixed-reference mode only, enable_audio generates sound and keep_original_sound preserves the reference video’s original audio. Do not set both to true.", "default": false }, { "name": "first_frame", "type": "string", "required": false, "description": "Provide at most one first_frame image. last_frame is optional, but requires first_frame; frame fields cannot be combined with reference_images.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Provide at most one first_frame image. last_frame is optional, but requires first_frame; frame fields cannot be combined with reference_images.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "seedance-2-0", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "seedance-2-0" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p", "4k" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "seedance-2-0-fast", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "seedance-2-0-fast" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "seedance-2-0-mini", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "seedance-2-0-mini" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Output duration in seconds; use the range or values listed here.", "minimum": 4, "maximum": 15, "values": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 9 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 3 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" } ] }, { "id": "seedance-2-5", "endpoint": "/v1/videos", "contentTypes": [ "application/json" ], "status": "verified", "parameters": [ { "name": "model", "type": "string", "required": true, "description": "Exact model ID from this catalog.", "values": [ "seedance-2-5" ] }, { "name": "prompt", "type": "string", "required": true, "description": "Describe the desired scene and motion.", "minLength": 1 }, { "name": "seconds", "type": "string", "required": false, "description": "Ordinary generation: 4–30 seconds. Video editing: \"0\", together with mode=videoEdit2video.", "minimum": 0, "maximum": 30, "values": [ "0", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "default": "4" }, { "name": "resolution", "type": "string", "required": false, "description": "Output resolution; values are case-sensitive.", "values": [ "480p", "720p", "1080p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "string", "required": false, "description": "Output aspect ratio.", "values": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "default": "adaptive" }, { "name": "reference_images", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 30 }, { "name": "reference_videos", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "reference_audios", "type": "array", "required": false, "description": "Array of publicly accessible HTTPS media URLs.", "source": "url", "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "maxItems": 10 }, { "name": "first_frame", "type": "string", "required": false, "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "last_frame", "type": "string", "required": false, "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules.", "source": "url", "format": "uri", "pattern": "^https://" }, { "name": "mode", "type": "string", "required": false, "description": "For seedance-2-5 video editing, set mode to videoEdit2video, seconds to \"0\" and aspect_ratio to adaptive. Provide one 4–30 second reference video; up to 30 images may be added. Omit audio references. For ordinary generation, omit mode.", "values": [ "videoEdit2video" ] } ] } ], "imageModels": [ { "id": "AWSD-5-pro-nsfw", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1424x800" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "800x1424" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1568x672" }, { "resolution": "1.5K", "aspect_ratio": "1:1", "size": "1536x1536" }, { "resolution": "1.5K", "aspect_ratio": "4:3", "size": "1792x1344" }, { "resolution": "1.5K", "aspect_ratio": "3:4", "size": "1344x1792" }, { "resolution": "1.5K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "1.5K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "1.5K", "aspect_ratio": "3:2", "size": "1872x1248" }, { "resolution": "1.5K", "aspect_ratio": "2:3", "size": "1248x1872" }, { "resolution": "1.5K", "aspect_ratio": "21:9", "size": "2352x1008" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2368x1776" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1776x2368" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2816x1584" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1584x2816" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "3136x1344" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "AWSD-5-pro-nsfw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1152x864", "864x1152", "1424x800", "800x1424", "1248x832", "832x1248", "1568x672", "1536x1536", "1792x1344", "1344x1792", "2048x1152", "1152x2048", "1872x1248", "1248x1872", "2352x1008", "2048x2048", "2368x1776", "1776x2368", "2816x1584", "1584x2816", "2496x1664", "1664x2496", "3136x1344" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "2048x2048" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as public URL or complete image Data URL strings.", "operation": "generation", "requiredWhen": "reference", "maxItems": 10 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "Midjourney v6", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "1024x1280" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1280x1024" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1344x576" } ], "resultCount": 4, "requestExample": { "model": "YOUR_MODEL", "prompt": "A glass lighthouse above misty cliffs at dawn", "n": 1, "size": "16:9", "aspect_ratio": "16:9", "resolution": "1k", "quality": "1", "style": "raw", "stylize": 100, "chaos": 0, "output_format": "jpeg", "response_format": "url" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "Midjourney v6" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image to generate." }, { "name": "n", "type": "integer", "required": false, "values": null, "default": 1, "minimum": 1, "maximum": 50, "status": "documented", "description": "For one standard Midjourney generation, use n=1; the task returns four candidate images. The current published range is 1–50.", "recommended": 1 }, { "name": "mode", "type": "string", "required": false, "values": [ "text-to-image" ], "default": "text-to-image", "minimum": null, "maximum": null, "status": "documented", "description": "Generation mode; use text-to-image. This is not a speed setting.", "recommended": "text-to-image" }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x864", "864x1536", "1152x864", "864x1152", "1248x832", "832x1248", "1024x1280", "1280x1024", "1344x576" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a supported aspect-ratio string or listed WIDTHxHEIGHT value. Keep size, aspect_ratio, and resolution consistent; final pixel dimensions may differ.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "0.25", "0.5", "1", "2" ], "default": "1", "minimum": null, "maximum": null, "status": "documented", "description": "Quality values are 0.25, 0.5, 1, and 2; default 1. Quality is independent of resolution.", "recommended": "1" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1k" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use 1k for v6, v6.1, and v7. The 2k option is published for v8.1 and v8.2." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, and 21:9." }, { "name": "style", "type": "string", "required": false, "values": [ "", "raw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stylize", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "chaos", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "seed", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 4294967295, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sw", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "iw", "type": "number", "required": false, "values": [ "0.5", "1", "2", "3" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": "2" }, { "name": "tile", "type": "boolean", "required": false, "values": null, "default": false, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "weird", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 3000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "negative_prompt", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "hd", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "draft", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cw", "type": "integer", "required": false, "values": [ 0, 50, 100 ], "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stop", "type": "integer", "required": false, "values": [ 50, 80, 100 ], "default": null, "minimum": 10, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "bot_type", "type": "string", "required": false, "values": [ "MID_JOURNEY", "NIJI_JOURNEY" ], "default": "MID_JOURNEY", "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "extra", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Additional MJ command-line options not represented by structured fields. Do not duplicate or conflict with structured parameters." }, { "name": "count", "type": "integer", "required": false, "values": null, "default": null, "minimum": 1, "maximum": 50, "status": "documented", "description": "count is an alias for n, with a range of 1–50. Use count=1 for one task, which returns four candidate images." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "url", "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present." }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 }, { "name": "images", "type": "ImageInputReference[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 } ], "notes": [ "Send a reference as a public HTTPS URL or image Data URL in image or images. The current published model capability lists at most one reference image; a reference guides generation and does not guarantee an exact copy or edit.", "Use structured JSON fields such as size, aspect_ratio, resolution, and quality instead of putting --ar, --v, or --quality in prompt. The selected model determines the version. Use extra for additional MJ command-line options not represented by a structured field.", "With n=1, one Midjourney task returns four images. After completion, process every item in data[] and read url or b64_json according to response_format. No fixed result-URL expiry is stated here; save results you need to keep.", "Controls: style selects raw rendering; stylize controls stylization; chaos controls variation; seed fixes the random seed; sref and sw set a style reference and its weight; iw sets image-reference weight; tile enables seamless tiling; weird controls unusualness; negative_prompt excludes content. Use only the controls published for the selected version.", "Version-specific options: hd is for v8.1/v8.2; draft is for v7/v8.1; cref, cw, and stop are for v6/v6.1; NIJI_JOURNEY is available in bot_type for v6/v7. The version follows the selected model ID; omit version.", "Choose the exact Midjourney model ID exposed to your API key. The version is selected by model; do not use a prompt directive or version field to switch it.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "Midjourney v6.1", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "1024x1280" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1280x1024" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1344x576" } ], "resultCount": 4, "requestExample": { "model": "YOUR_MODEL", "prompt": "A glass lighthouse above misty cliffs at dawn", "n": 1, "size": "16:9", "aspect_ratio": "16:9", "resolution": "1k", "quality": "1", "style": "raw", "stylize": 100, "chaos": 0, "output_format": "jpeg", "response_format": "url" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "Midjourney v6.1" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image to generate." }, { "name": "n", "type": "integer", "required": false, "values": null, "default": 1, "minimum": 1, "maximum": 50, "status": "documented", "description": "For one standard Midjourney generation, use n=1; the task returns four candidate images. The current published range is 1–50.", "recommended": 1 }, { "name": "mode", "type": "string", "required": false, "values": [ "text-to-image" ], "default": "text-to-image", "minimum": null, "maximum": null, "status": "documented", "description": "Generation mode; use text-to-image. This is not a speed setting.", "recommended": "text-to-image" }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x864", "864x1536", "1152x864", "864x1152", "1248x832", "832x1248", "1024x1280", "1280x1024", "1344x576" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a supported aspect-ratio string or listed WIDTHxHEIGHT value. Keep size, aspect_ratio, and resolution consistent; final pixel dimensions may differ.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "0.25", "0.5", "1", "2" ], "default": "1", "minimum": null, "maximum": null, "status": "documented", "description": "Quality values are 0.25, 0.5, 1, and 2; default 1. Quality is independent of resolution.", "recommended": "1" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1k" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use 1k for v6, v6.1, and v7. The 2k option is published for v8.1 and v8.2." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, and 21:9." }, { "name": "style", "type": "string", "required": false, "values": [ "", "raw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stylize", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "chaos", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "seed", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 4294967295, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sw", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "iw", "type": "number", "required": false, "values": [ "0.5", "1", "2", "3" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": "2" }, { "name": "tile", "type": "boolean", "required": false, "values": null, "default": false, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "weird", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 3000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "negative_prompt", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "hd", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "draft", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cw", "type": "integer", "required": false, "values": [ 0, 50, 100 ], "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stop", "type": "integer", "required": false, "values": [ 50, 80, 100 ], "default": null, "minimum": 10, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "bot_type", "type": "string", "required": false, "values": [ "MID_JOURNEY", "NIJI_JOURNEY" ], "default": "MID_JOURNEY", "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "extra", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Additional MJ command-line options not represented by structured fields. Do not duplicate or conflict with structured parameters." }, { "name": "count", "type": "integer", "required": false, "values": null, "default": null, "minimum": 1, "maximum": 50, "status": "documented", "description": "count is an alias for n, with a range of 1–50. Use count=1 for one task, which returns four candidate images." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "url", "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present." }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 }, { "name": "images", "type": "ImageInputReference[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 } ], "notes": [ "Send a reference as a public HTTPS URL or image Data URL in image or images. The current published model capability lists at most one reference image; a reference guides generation and does not guarantee an exact copy or edit.", "Use structured JSON fields such as size, aspect_ratio, resolution, and quality instead of putting --ar, --v, or --quality in prompt. The selected model determines the version. Use extra for additional MJ command-line options not represented by a structured field.", "With n=1, one Midjourney task returns four images. After completion, process every item in data[] and read url or b64_json according to response_format. No fixed result-URL expiry is stated here; save results you need to keep.", "Controls: style selects raw rendering; stylize controls stylization; chaos controls variation; seed fixes the random seed; sref and sw set a style reference and its weight; iw sets image-reference weight; tile enables seamless tiling; weird controls unusualness; negative_prompt excludes content. Use only the controls published for the selected version.", "Version-specific options: hd is for v8.1/v8.2; draft is for v7/v8.1; cref, cw, and stop are for v6/v6.1; NIJI_JOURNEY is available in bot_type for v6/v7. The version follows the selected model ID; omit version.", "Choose the exact Midjourney model ID exposed to your API key. The version is selected by model; do not use a prompt directive or version field to switch it.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "Midjourney v7", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "1024x1280" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1280x1024" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1344x576" } ], "resultCount": 4, "requestExample": { "model": "YOUR_MODEL", "prompt": "A glass lighthouse above misty cliffs at dawn", "n": 1, "size": "16:9", "aspect_ratio": "16:9", "resolution": "1k", "quality": "1", "style": "raw", "stylize": 100, "chaos": 0, "output_format": "jpeg", "response_format": "url" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "Midjourney v7" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image to generate." }, { "name": "n", "type": "integer", "required": false, "values": null, "default": 1, "minimum": 1, "maximum": 50, "status": "documented", "description": "For one standard Midjourney generation, use n=1; the task returns four candidate images. The current published range is 1–50.", "recommended": 1 }, { "name": "mode", "type": "string", "required": false, "values": [ "text-to-image" ], "default": "text-to-image", "minimum": null, "maximum": null, "status": "documented", "description": "Generation mode; use text-to-image. This is not a speed setting.", "recommended": "text-to-image" }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x864", "864x1536", "1152x864", "864x1152", "1248x832", "832x1248", "1024x1280", "1280x1024", "1344x576" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a supported aspect-ratio string or listed WIDTHxHEIGHT value. Keep size, aspect_ratio, and resolution consistent; final pixel dimensions may differ.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "0.25", "0.5", "1", "2" ], "default": "1", "minimum": null, "maximum": null, "status": "documented", "description": "Quality values are 0.25, 0.5, 1, and 2; default 1. Quality is independent of resolution.", "recommended": "1" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1k" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use 1k for v6, v6.1, and v7. The 2k option is published for v8.1 and v8.2." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, and 21:9." }, { "name": "style", "type": "string", "required": false, "values": [ "", "raw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stylize", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "chaos", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "seed", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 4294967295, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sw", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "iw", "type": "number", "required": false, "values": [ "0.5", "1", "2", "3" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": "2" }, { "name": "tile", "type": "boolean", "required": false, "values": null, "default": false, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "weird", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 3000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "negative_prompt", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "hd", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "draft", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cw", "type": "integer", "required": false, "values": [ 0, 50, 100 ], "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stop", "type": "integer", "required": false, "values": [ 50, 80, 100 ], "default": null, "minimum": 10, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "bot_type", "type": "string", "required": false, "values": [ "MID_JOURNEY", "NIJI_JOURNEY" ], "default": "MID_JOURNEY", "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "extra", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Additional MJ command-line options not represented by structured fields. Do not duplicate or conflict with structured parameters." }, { "name": "count", "type": "integer", "required": false, "values": null, "default": null, "minimum": 1, "maximum": 50, "status": "documented", "description": "count is an alias for n, with a range of 1–50. Use count=1 for one task, which returns four candidate images." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "url", "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present." }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 }, { "name": "images", "type": "ImageInputReference[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 } ], "notes": [ "Send a reference as a public HTTPS URL or image Data URL in image or images. The current published model capability lists at most one reference image; a reference guides generation and does not guarantee an exact copy or edit.", "Use structured JSON fields such as size, aspect_ratio, resolution, and quality instead of putting --ar, --v, or --quality in prompt. The selected model determines the version. Use extra for additional MJ command-line options not represented by a structured field.", "With n=1, one Midjourney task returns four images. After completion, process every item in data[] and read url or b64_json according to response_format. No fixed result-URL expiry is stated here; save results you need to keep.", "Controls: style selects raw rendering; stylize controls stylization; chaos controls variation; seed fixes the random seed; sref and sw set a style reference and its weight; iw sets image-reference weight; tile enables seamless tiling; weird controls unusualness; negative_prompt excludes content. Use only the controls published for the selected version.", "Version-specific options: hd is for v8.1/v8.2; draft is for v7/v8.1; cref, cw, and stop are for v6/v6.1; NIJI_JOURNEY is available in bot_type for v6/v7. The version follows the selected model ID; omit version.", "Choose the exact Midjourney model ID exposed to your API key. The version is selected by model; do not use a prompt directive or version field to switch it.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "Midjourney v8.1", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "1024x1280" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1280x1024" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1344x576" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2048x1536" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1536x2048" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2048x1360" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1360x2048" }, { "resolution": "2K", "aspect_ratio": "4:5", "size": "1632x2040" }, { "resolution": "2K", "aspect_ratio": "5:4", "size": "2040x1632" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "2016x864" } ], "resultCount": 4, "requestExample": { "model": "YOUR_MODEL", "prompt": "A glass lighthouse above misty cliffs at dawn", "n": 1, "size": "16:9", "aspect_ratio": "16:9", "resolution": "1k", "quality": "1", "style": "raw", "stylize": 100, "chaos": 0, "output_format": "jpeg", "response_format": "url" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "Midjourney v8.1" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image to generate." }, { "name": "n", "type": "integer", "required": false, "values": null, "default": 1, "minimum": 1, "maximum": 50, "status": "documented", "description": "For one standard Midjourney generation, use n=1; the task returns four candidate images. The current published range is 1–50.", "recommended": 1 }, { "name": "mode", "type": "string", "required": false, "values": [ "text-to-image" ], "default": "text-to-image", "minimum": null, "maximum": null, "status": "documented", "description": "Generation mode; use text-to-image. This is not a speed setting.", "recommended": "text-to-image" }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x864", "864x1536", "1152x864", "864x1152", "1248x832", "832x1248", "1024x1280", "1280x1024", "1344x576", "2048x2048", "2048x1152", "1152x2048", "2048x1536", "1536x2048", "2048x1360", "1360x2048", "1632x2040", "2040x1632", "2016x864" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a supported aspect-ratio string or listed WIDTHxHEIGHT value. Keep size, aspect_ratio, and resolution consistent; final pixel dimensions may differ.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "0.25", "0.5", "1", "2" ], "default": "1", "minimum": null, "maximum": null, "status": "documented", "description": "Quality values are 0.25, 0.5, 1, and 2; default 1. Quality is independent of resolution.", "recommended": "1" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1k", "2k" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use 1k for v6, v6.1, and v7. The 2k option is published for v8.1 and v8.2." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, and 21:9." }, { "name": "style", "type": "string", "required": false, "values": [ "", "raw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stylize", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "chaos", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "seed", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 4294967295, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sw", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "iw", "type": "number", "required": false, "values": [ "0.5", "1", "2", "3" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": "2" }, { "name": "tile", "type": "boolean", "required": false, "values": null, "default": false, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "weird", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 3000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "negative_prompt", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "hd", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "draft", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cw", "type": "integer", "required": false, "values": [ 0, 50, 100 ], "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stop", "type": "integer", "required": false, "values": [ 50, 80, 100 ], "default": null, "minimum": 10, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "bot_type", "type": "string", "required": false, "values": [ "MID_JOURNEY", "NIJI_JOURNEY" ], "default": "MID_JOURNEY", "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "extra", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Additional MJ command-line options not represented by structured fields. Do not duplicate or conflict with structured parameters." }, { "name": "count", "type": "integer", "required": false, "values": null, "default": null, "minimum": 1, "maximum": 50, "status": "documented", "description": "count is an alias for n, with a range of 1–50. Use count=1 for one task, which returns four candidate images." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "url", "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present." }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 }, { "name": "images", "type": "ImageInputReference[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 } ], "notes": [ "Send a reference as a public HTTPS URL or image Data URL in image or images. The current published model capability lists at most one reference image; a reference guides generation and does not guarantee an exact copy or edit.", "Use structured JSON fields such as size, aspect_ratio, resolution, and quality instead of putting --ar, --v, or --quality in prompt. The selected model determines the version. Use extra for additional MJ command-line options not represented by a structured field.", "With n=1, one Midjourney task returns four images. After completion, process every item in data[] and read url or b64_json according to response_format. No fixed result-URL expiry is stated here; save results you need to keep.", "Controls: style selects raw rendering; stylize controls stylization; chaos controls variation; seed fixes the random seed; sref and sw set a style reference and its weight; iw sets image-reference weight; tile enables seamless tiling; weird controls unusualness; negative_prompt excludes content. Use only the controls published for the selected version.", "Version-specific options: hd is for v8.1/v8.2; draft is for v7/v8.1; cref, cw, and stop are for v6/v6.1; NIJI_JOURNEY is available in bot_type for v6/v7. The version follows the selected model ID; omit version.", "Choose the exact Midjourney model ID exposed to your API key. The version is selected by model; do not use a prompt directive or version field to switch it.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "Midjourney v8.2", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "1024x1280" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1280x1024" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1344x576" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2048x1536" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1536x2048" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2048x1360" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1360x2048" }, { "resolution": "2K", "aspect_ratio": "4:5", "size": "1632x2040" }, { "resolution": "2K", "aspect_ratio": "5:4", "size": "2040x1632" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "2016x864" } ], "resultCount": 4, "requestExample": { "model": "YOUR_MODEL", "prompt": "A glass lighthouse above misty cliffs at dawn", "n": 1, "size": "16:9", "aspect_ratio": "16:9", "resolution": "1k", "quality": "1", "style": "raw", "stylize": 100, "chaos": 0, "output_format": "jpeg", "response_format": "url" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "Midjourney v8.2" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image to generate." }, { "name": "n", "type": "integer", "required": false, "values": null, "default": 1, "minimum": 1, "maximum": 50, "status": "documented", "description": "For one standard Midjourney generation, use n=1; the task returns four candidate images. The current published range is 1–50.", "recommended": 1 }, { "name": "mode", "type": "string", "required": false, "values": [ "text-to-image" ], "default": "text-to-image", "minimum": null, "maximum": null, "status": "documented", "description": "Generation mode; use text-to-image. This is not a speed setting.", "recommended": "text-to-image" }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x864", "864x1536", "1152x864", "864x1152", "1248x832", "832x1248", "1024x1280", "1280x1024", "1344x576", "2048x2048", "2048x1152", "1152x2048", "2048x1536", "1536x2048", "2048x1360", "1360x2048", "1632x2040", "2040x1632", "2016x864" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a supported aspect-ratio string or listed WIDTHxHEIGHT value. Keep size, aspect_ratio, and resolution consistent; final pixel dimensions may differ.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "0.25", "0.5", "1", "2" ], "default": "1", "minimum": null, "maximum": null, "status": "documented", "description": "Quality values are 0.25, 0.5, 1, and 2; default 1. Quality is independent of resolution.", "recommended": "1" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1k", "2k" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use 1k for v6, v6.1, and v7. The 2k option is published for v8.1 and v8.2." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, and 21:9." }, { "name": "style", "type": "string", "required": false, "values": [ "", "raw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stylize", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "chaos", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "seed", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 4294967295, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sw", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "iw", "type": "number", "required": false, "values": [ "0.5", "1", "2", "3" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": "2" }, { "name": "tile", "type": "boolean", "required": false, "values": null, "default": false, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "weird", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 3000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "negative_prompt", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "hd", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "draft", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cw", "type": "integer", "required": false, "values": [ 0, 50, 100 ], "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stop", "type": "integer", "required": false, "values": [ 50, 80, 100 ], "default": null, "minimum": 10, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "bot_type", "type": "string", "required": false, "values": [ "MID_JOURNEY", "NIJI_JOURNEY" ], "default": "MID_JOURNEY", "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "extra", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Additional MJ command-line options not represented by structured fields. Do not duplicate or conflict with structured parameters." }, { "name": "count", "type": "integer", "required": false, "values": null, "default": null, "minimum": 1, "maximum": 50, "status": "documented", "description": "count is an alias for n, with a range of 1–50. Use count=1 for one task, which returns four candidate images." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "url", "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present." }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 }, { "name": "images", "type": "ImageInputReference[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 } ], "notes": [ "Send a reference as a public HTTPS URL or image Data URL in image or images. The current published model capability lists at most one reference image; a reference guides generation and does not guarantee an exact copy or edit.", "Use structured JSON fields such as size, aspect_ratio, resolution, and quality instead of putting --ar, --v, or --quality in prompt. The selected model determines the version. Use extra for additional MJ command-line options not represented by a structured field.", "With n=1, one Midjourney task returns four images. After completion, process every item in data[] and read url or b64_json according to response_format. No fixed result-URL expiry is stated here; save results you need to keep.", "Controls: style selects raw rendering; stylize controls stylization; chaos controls variation; seed fixes the random seed; sref and sw set a style reference and its weight; iw sets image-reference weight; tile enables seamless tiling; weird controls unusualness; negative_prompt excludes content. Use only the controls published for the selected version.", "Version-specific options: hd is for v8.1/v8.2; draft is for v7/v8.1; cref, cw, and stop are for v6/v6.1; NIJI_JOURNEY is available in bot_type for v6/v7. The version follows the selected model ID; omit version.", "Choose the exact Midjourney model ID exposed to your API key. The version is selected by model; do not use a prompt directive or version field to switch it.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1536x1024" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "1024x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2304x1728" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1728x2304" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "auto", "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2 4K", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2 4K" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "4096x2304" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high", "xhigh", "max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2 Adobe", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2 Adobe" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1536x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1536x1024" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "1024x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2304x1728" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1728x2304" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "auto", "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5 Adobe", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5 Adobe" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1536x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-flare", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1536x1024" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "1024x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2304x1728" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1728x2304" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-flare" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "auto", "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-flare 4K", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-flare 4K" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "4096x2304" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high", "xhigh", "max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-flare Adobe", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-flare Adobe" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1536x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-flare Max", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-flare Max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "4096x2736" }, { "name": "quality", "type": "string", "required": false, "values": [ "auto", "low", "medium", "high", "xhigh", "max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-sunburst", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1536x1024" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "1024x1536" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1536x864" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "864x1536" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2304x1728" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1728x2304" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-sunburst" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "auto", "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-sunburst 4K", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4096x2736" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "2736x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4096x3072" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3072x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "2304x4096" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-sunburst 4K" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "4096x2304" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high", "xhigh", "max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-sunburst Adobe", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-sunburst Adobe" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1536x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "gpt-image-2.5-sunburst Max", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "gpt-image-2.5-sunburst Max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1536x1024", "1024x1536", "1152x864", "864x1152", "1536x864", "864x1536", "2048x2048", "2496x1664", "1664x2496", "2304x1728", "1728x2304", "2048x1152", "1152x2048", "4096x4096", "4096x2736", "2736x4096", "4096x3072", "3072x4096", "4096x2304", "2304x4096" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "4096x2736" }, { "name": "quality", "type": "string", "required": false, "values": [ "auto", "low", "medium", "high", "xhigh", "max" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg", "webp" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 16 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "grok-imagine-image-2.0", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1280x720" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "720x1280" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1024x768" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "768x1024" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1152x768" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "768x1152" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2816x1584" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1584x2816" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2368x1776" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1776x2368" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "grok-imagine-image-2.0" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1280x720", "720x1280", "1024x768", "768x1024", "1152x768", "768x1152", "2048x2048", "2816x1584", "1584x2816", "2368x1776", "1776x2368", "2496x1664", "1664x2496" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "2048x2048" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "auto" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "auto" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 5 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "grok-imagine-nsfw-2.0", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": null, "contentType": null, "status": "unsupported" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1280x720" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "720x1280" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1024x768" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "768x1024" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1152x768" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "768x1152" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2816x1584" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1584x2816" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2368x1776" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1776x2368" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "grok-imagine-nsfw-2.0" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1280x720", "720x1280", "1024x768", "768x1024", "1152x768", "768x1152", "2048x2048", "2816x1584", "1584x2816", "2368x1776", "1776x2368", "2496x1664", "1664x2496" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "2048x2048" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "auto" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "auto" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "midjourney", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "resultCount": 4, "requestExample": { "model": "YOUR_MODEL", "prompt": "A glass lighthouse above misty cliffs at dawn", "n": 1, "size": "16:9", "aspect_ratio": "16:9", "resolution": "1k", "quality": "1", "style": "raw", "stylize": 100, "chaos": 0, "output_format": "jpeg", "response_format": "url" }, "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "midjourney" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image to generate." }, { "name": "n", "type": "integer", "required": false, "values": null, "default": 1, "minimum": 1, "maximum": 50, "status": "documented", "description": "For one standard Midjourney generation, use n=1; the task returns four candidate images. The current published range is 1–50.", "recommended": 1 }, { "name": "mode", "type": "string", "required": false, "values": [ "text-to-image" ], "default": "text-to-image", "minimum": null, "maximum": null, "status": "documented", "description": "Generation mode; use text-to-image. This is not a speed setting.", "recommended": "text-to-image" }, { "name": "size", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a supported aspect-ratio string or listed WIDTHxHEIGHT value. Keep size, aspect_ratio, and resolution consistent; final pixel dimensions may differ." }, { "name": "quality", "type": "string", "required": false, "values": [ "0.25", "0.5", "1", "2" ], "default": "1", "minimum": null, "maximum": null, "status": "documented", "description": "Quality values are 0.25, 0.5, 1, and 2; default 1. Quality is independent of resolution.", "recommended": "1" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1k", "2k" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use 1k for v6, v6.1, and v7. The 2k option is published for v8.1 and v8.2." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, and 21:9." }, { "name": "style", "type": "string", "required": false, "values": [ "", "raw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stylize", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "chaos", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "seed", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 4294967295, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "sw", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 1000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 100 }, { "name": "iw", "type": "number", "required": false, "values": [ "0.5", "1", "2", "3" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": "2" }, { "name": "tile", "type": "boolean", "required": false, "values": null, "default": false, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "weird", "type": "integer", "required": false, "values": null, "default": null, "minimum": 0, "maximum": 3000, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version.", "recommended": 0 }, { "name": "negative_prompt", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "hd", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "draft", "type": "boolean", "required": false, "values": [ false, true ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cref", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "cw", "type": "integer", "required": false, "values": [ 0, 50, 100 ], "default": null, "minimum": 0, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "stop", "type": "integer", "required": false, "values": [ 50, 80, 100 ], "default": null, "minimum": 10, "maximum": 100, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "bot_type", "type": "string", "required": false, "values": [ "MID_JOURNEY", "NIJI_JOURNEY" ], "default": "MID_JOURNEY", "minimum": null, "maximum": null, "status": "documented", "description": "MJ-specific control; its availability depends on the selected version." }, { "name": "extra", "type": "string", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Additional MJ command-line options not represented by structured fields. Do not duplicate or conflict with structured parameters." }, { "name": "count", "type": "integer", "required": false, "values": null, "default": null, "minimum": 1, "maximum": 50, "status": "documented", "description": "count is an alias for n, with a range of 1–50. Use count=1 for one task, which returns four candidate images." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "url", "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present." }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 }, { "name": "images", "type": "ImageInputReference[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "For reference input, send either image or images, not both; the total limit is one image.", "operation": "generation", "maxItems": 1 } ], "notes": [ "Send a reference as a public HTTPS URL or image Data URL in image or images. The current published model capability lists at most one reference image; a reference guides generation and does not guarantee an exact copy or edit.", "Use structured JSON fields such as size, aspect_ratio, resolution, and quality instead of putting --ar, --v, or --quality in prompt. The selected model determines the version. Use extra for additional MJ command-line options not represented by a structured field.", "With n=1, one Midjourney task returns four images. After completion, process every item in data[] and read url or b64_json according to response_format. No fixed result-URL expiry is stated here; save results you need to keep.", "Controls: style selects raw rendering; stylize controls stylization; chaos controls variation; seed fixes the random seed; sref and sw set a style reference and its weight; iw sets image-reference weight; tile enables seamless tiling; weird controls unusualness; negative_prompt excludes content. Use only the controls published for the selected version.", "Version-specific options: hd is for v8.1/v8.2; draft is for v7/v8.1; cref, cw, and stop are for v6/v6.1; NIJI_JOURNEY is available in bot_type for v6/v7. The version follows the selected model ID; omit version.", "Choose the exact Midjourney model ID exposed to your API key. The version is selected by model; do not use a prompt directive or version field to switch it.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "nano-banana-2", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1376x768" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "768x1376" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1200x896" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "896x1200" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1264x848" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "848x1264" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1152x928" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "928x1152" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1584x672" }, { "resolution": "1K", "aspect_ratio": "8:1", "size": "2928x352" }, { "resolution": "1K", "aspect_ratio": "4:1", "size": "2064x512" }, { "resolution": "1K", "aspect_ratio": "1:4", "size": "512x2064" }, { "resolution": "1K", "aspect_ratio": "1:8", "size": "352x2928" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2752x1536" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1536x2752" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2400x1792" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1792x2400" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2528x1696" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1696x2528" }, { "resolution": "2K", "aspect_ratio": "5:4", "size": "2304x1856" }, { "resolution": "2K", "aspect_ratio": "4:5", "size": "1856x2304" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "3168x1344" }, { "resolution": "2K", "aspect_ratio": "8:1", "size": "5856x704" }, { "resolution": "2K", "aspect_ratio": "4:1", "size": "4128x1024" }, { "resolution": "2K", "aspect_ratio": "1:4", "size": "1024x4128" }, { "resolution": "2K", "aspect_ratio": "1:8", "size": "704x5856" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "5504x3072" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "3072x5504" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4800x3584" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3584x4800" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "5056x3392" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "3392x5056" }, { "resolution": "4K", "aspect_ratio": "5:4", "size": "4608x3712" }, { "resolution": "4K", "aspect_ratio": "4:5", "size": "3712x4608" }, { "resolution": "4K", "aspect_ratio": "21:9", "size": "6336x2688" }, { "resolution": "4K", "aspect_ratio": "8:1", "size": "11712x1408" }, { "resolution": "4K", "aspect_ratio": "4:1", "size": "8256x2048" }, { "resolution": "4K", "aspect_ratio": "1:4", "size": "2048x8256" }, { "resolution": "4K", "aspect_ratio": "1:8", "size": "1408x11712" } ], "sizePresetFields": [ "size", "resolution", "aspect_ratio" ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "nano-banana-2" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1376x768", "768x1376", "1200x896", "896x1200", "1264x848", "848x1264", "1152x928", "928x1152", "1584x672", "2928x352", "2064x512", "512x2064", "352x2928", "2048x2048", "2752x1536", "1536x2752", "2400x1792", "1792x2400", "2528x1696", "1696x2528", "2304x1856", "1856x2304", "3168x1344", "5856x704", "4128x1024", "1024x4128", "704x5856", "4096x4096", "5504x3072", "3072x5504", "4800x3584", "3584x4800", "5056x3392", "3392x5056", "4608x3712", "3712x4608", "6336x2688", "11712x1408", "8256x2048", "2048x8256", "1408x11712" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1K", "2K", "4K" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "When selecting a listed size, send resolution and aspect_ratio from the same row in the size table." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9", "8:1", "4:1", "1:4", "1:8" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use the aspect_ratio from the same row as size and resolution; omit both auxiliary fields when size is omitted." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 14 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "nano-banana-2.1", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "size": "1024x1024", "resolution": "1K", "aspect_ratio": "1:1" }, { "size": "1376x768", "resolution": "1K", "aspect_ratio": "16:9" }, { "size": "768x1376", "resolution": "1K", "aspect_ratio": "9:16" }, { "size": "1200x896", "resolution": "1K", "aspect_ratio": "4:3" }, { "size": "896x1200", "resolution": "1K", "aspect_ratio": "3:4" }, { "size": "1264x848", "resolution": "1K", "aspect_ratio": "3:2" }, { "size": "848x1264", "resolution": "1K", "aspect_ratio": "2:3" }, { "size": "1152x928", "resolution": "1K", "aspect_ratio": "5:4" }, { "size": "928x1152", "resolution": "1K", "aspect_ratio": "4:5" }, { "size": "1584x672", "resolution": "1K", "aspect_ratio": "21:9" }, { "size": "2928x352", "resolution": "1K", "aspect_ratio": "8:1" }, { "size": "2064x512", "resolution": "1K", "aspect_ratio": "4:1" }, { "size": "512x2064", "resolution": "1K", "aspect_ratio": "1:4" }, { "size": "352x2928", "resolution": "1K", "aspect_ratio": "1:8" }, { "size": "2048x2048", "resolution": "2K", "aspect_ratio": "1:1" }, { "size": "2752x1536", "resolution": "2K", "aspect_ratio": "16:9" }, { "size": "1536x2752", "resolution": "2K", "aspect_ratio": "9:16" }, { "size": "2400x1792", "resolution": "2K", "aspect_ratio": "4:3" }, { "size": "1792x2400", "resolution": "2K", "aspect_ratio": "3:4" }, { "size": "2528x1696", "resolution": "2K", "aspect_ratio": "3:2" }, { "size": "1696x2528", "resolution": "2K", "aspect_ratio": "2:3" }, { "size": "2304x1856", "resolution": "2K", "aspect_ratio": "5:4" }, { "size": "1856x2304", "resolution": "2K", "aspect_ratio": "4:5" }, { "size": "3168x1344", "resolution": "2K", "aspect_ratio": "21:9" }, { "size": "5856x704", "resolution": "2K", "aspect_ratio": "8:1" }, { "size": "4128x1024", "resolution": "2K", "aspect_ratio": "4:1" }, { "size": "1024x4128", "resolution": "2K", "aspect_ratio": "1:4" }, { "size": "704x5856", "resolution": "2K", "aspect_ratio": "1:8" }, { "size": "4096x4096", "resolution": "4K", "aspect_ratio": "1:1" }, { "size": "5504x3072", "resolution": "4K", "aspect_ratio": "16:9" }, { "size": "3072x5504", "resolution": "4K", "aspect_ratio": "9:16" }, { "size": "4800x3584", "resolution": "4K", "aspect_ratio": "4:3" }, { "size": "3584x4800", "resolution": "4K", "aspect_ratio": "3:4" }, { "size": "5056x3392", "resolution": "4K", "aspect_ratio": "3:2" }, { "size": "3392x5056", "resolution": "4K", "aspect_ratio": "2:3" }, { "size": "4608x3712", "resolution": "4K", "aspect_ratio": "5:4" }, { "size": "3712x4608", "resolution": "4K", "aspect_ratio": "4:5" }, { "size": "6336x2688", "resolution": "4K", "aspect_ratio": "21:9" }, { "size": "11712x1408", "resolution": "4K", "aspect_ratio": "8:1" }, { "size": "8256x2048", "resolution": "4K", "aspect_ratio": "4:1" }, { "size": "2048x8256", "resolution": "4K", "aspect_ratio": "1:4" }, { "size": "1408x11712", "resolution": "4K", "aspect_ratio": "1:8" } ], "sizePresetFields": [ "size", "resolution", "aspect_ratio" ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "nano-banana-2.1" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1376x768", "768x1376", "1200x896", "896x1200", "1264x848", "848x1264", "1152x928", "928x1152", "1584x672", "2928x352", "2064x512", "512x2064", "352x2928", "2048x2048", "2752x1536", "1536x2752", "2400x1792", "1792x2400", "2528x1696", "1696x2528", "2304x1856", "1856x2304", "3168x1344", "5856x704", "4128x1024", "1024x4128", "704x5856", "4096x4096", "5504x3072", "3072x5504", "4800x3584", "3584x4800", "5056x3392", "3392x5056", "4608x3712", "3712x4608", "6336x2688", "11712x1408", "8256x2048", "2048x8256", "1408x11712" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "4800x3584" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "high" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1K", "2K", "4K" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "When selecting a listed size, send resolution and aspect_ratio from the same row in the size table." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9", "8:1", "4:1", "1:4", "1:8" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use the aspect_ratio from the same row as size and resolution; omit both auxiliary fields when size is omitted." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 14 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "nano-banana-pro", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1376x768" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "768x1376" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1200x896" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "896x1200" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1264x848" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "848x1264" }, { "resolution": "1K", "aspect_ratio": "5:4", "size": "1152x928" }, { "resolution": "1K", "aspect_ratio": "4:5", "size": "928x1152" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1584x672" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2752x1536" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1536x2752" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2400x1792" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1792x2400" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2528x1696" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1696x2528" }, { "resolution": "2K", "aspect_ratio": "5:4", "size": "2304x1856" }, { "resolution": "2K", "aspect_ratio": "4:5", "size": "1856x2304" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "3168x1344" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "5504x3072" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "3072x5504" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4800x3584" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3584x4800" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "5056x3392" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "3392x5056" }, { "resolution": "4K", "aspect_ratio": "5:4", "size": "4608x3712" }, { "resolution": "4K", "aspect_ratio": "4:5", "size": "3712x4608" }, { "resolution": "4K", "aspect_ratio": "21:9", "size": "6336x2688" } ], "sizePresetFields": [ "size", "resolution", "aspect_ratio" ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "nano-banana-pro" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1376x768", "768x1376", "1200x896", "896x1200", "1264x848", "848x1264", "1152x928", "928x1152", "1584x672", "2048x2048", "2752x1536", "1536x2752", "2400x1792", "1792x2400", "2528x1696", "1696x2528", "2304x1856", "1856x2304", "3168x1344", "4096x4096", "5504x3072", "3072x5504", "4800x3584", "3584x4800", "5056x3392", "3392x5056", "4608x3712", "3712x4608", "6336x2688" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "1024x1024" }, { "name": "quality", "type": "string", "required": false, "values": [ "low", "medium", "high" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use only the values listed for this exact model.", "recommended": "medium" }, { "name": "resolution", "type": "string", "required": false, "values": [ "1K", "2K", "4K" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "When selecting a listed size, send resolution and aspect_ratio from the same row in the size table." }, { "name": "aspect_ratio", "type": "string", "required": false, "values": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use the aspect_ratio from the same row as size and resolution; omit both auxiliary fields when size is omitted." }, { "name": "output_format", "type": "string", "required": false, "values": [ "png" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 14 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "seedream-5-0", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2304x1728" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1728x2304" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2848x1600" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1600x2848" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "3136x1344" }, { "resolution": "3K", "aspect_ratio": "1:1", "size": "3072x3072" }, { "resolution": "3K", "aspect_ratio": "4:3", "size": "3456x2592" }, { "resolution": "3K", "aspect_ratio": "3:4", "size": "2592x3456" }, { "resolution": "3K", "aspect_ratio": "16:9", "size": "4096x2304" }, { "resolution": "3K", "aspect_ratio": "9:16", "size": "2304x4096" }, { "resolution": "3K", "aspect_ratio": "3:2", "size": "3744x2496" }, { "resolution": "3K", "aspect_ratio": "2:3", "size": "2496x3744" }, { "resolution": "3K", "aspect_ratio": "21:9", "size": "4704x2016" }, { "resolution": "4K", "aspect_ratio": "1:1", "size": "4096x4096" }, { "resolution": "4K", "aspect_ratio": "4:3", "size": "4704x3520" }, { "resolution": "4K", "aspect_ratio": "3:4", "size": "3520x4704" }, { "resolution": "4K", "aspect_ratio": "16:9", "size": "5504x3040" }, { "resolution": "4K", "aspect_ratio": "9:16", "size": "3040x5504" }, { "resolution": "4K", "aspect_ratio": "3:2", "size": "4992x3328" }, { "resolution": "4K", "aspect_ratio": "2:3", "size": "3328x4992" }, { "resolution": "4K", "aspect_ratio": "21:9", "size": "6240x2656" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "seedream-5-0" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "2048x2048", "2304x1728", "1728x2304", "2848x1600", "1600x2848", "2496x1664", "1664x2496", "3136x1344", "3072x3072", "3456x2592", "2592x3456", "4096x2304", "2304x4096", "3744x2496", "2496x3744", "4704x2016", "4096x4096", "4704x3520", "3520x4704", "5504x3040", "3040x5504", "4992x3328", "3328x4992", "6240x2656" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use the listed WIDTHxHEIGHT values. The image ratio is encoded in size.", "recommended": "2048x2048" }, { "name": "output_format", "type": "string", "required": false, "values": [ "jpeg", "png" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "jpeg" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as public URL or complete image Data URL strings.", "operation": "generation", "requiredWhen": "reference", "maxItems": 14 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "seedream-v5-pro", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/generations", "contentType": "application/json", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1424x800" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "800x1424" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1568x672" }, { "resolution": "1.5K", "aspect_ratio": "1:1", "size": "1536x1536" }, { "resolution": "1.5K", "aspect_ratio": "4:3", "size": "1792x1344" }, { "resolution": "1.5K", "aspect_ratio": "3:4", "size": "1344x1792" }, { "resolution": "1.5K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "1.5K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "1.5K", "aspect_ratio": "3:2", "size": "1872x1248" }, { "resolution": "1.5K", "aspect_ratio": "2:3", "size": "1248x1872" }, { "resolution": "1.5K", "aspect_ratio": "21:9", "size": "2352x1008" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2368x1776" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1776x2368" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2816x1584" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1584x2816" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "3136x1344" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "seedream-v5-pro" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1152x864", "864x1152", "1424x800", "800x1424", "1248x832", "832x1248", "1568x672", "1536x1536", "1792x1344", "1344x1792", "2048x1152", "1152x2048", "1872x1248", "1248x1872", "2352x1008", "2048x2048", "2368x1776", "1776x2368", "2816x1584", "1584x2816", "2496x1664", "1664x2496", "3136x1344" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "2048x2048" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "string | string[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as public URL or complete image Data URL strings.", "operation": "generation", "requiredWhen": "reference", "maxItems": 10 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] }, { "id": "seedream-v5-pro-nsfw", "guideId": "image-models", "status": "documented", "endpoint": "/v1/images/generations", "contentTypes": [ "application/json" ], "edit": { "endpoint": "/v1/images/edits", "contentType": "multipart/form-data", "status": "documented" }, "sizePresets": [ { "resolution": "1K", "aspect_ratio": "1:1", "size": "1024x1024" }, { "resolution": "1K", "aspect_ratio": "4:3", "size": "1152x864" }, { "resolution": "1K", "aspect_ratio": "3:4", "size": "864x1152" }, { "resolution": "1K", "aspect_ratio": "16:9", "size": "1424x800" }, { "resolution": "1K", "aspect_ratio": "9:16", "size": "800x1424" }, { "resolution": "1K", "aspect_ratio": "3:2", "size": "1248x832" }, { "resolution": "1K", "aspect_ratio": "2:3", "size": "832x1248" }, { "resolution": "1K", "aspect_ratio": "21:9", "size": "1568x672" }, { "resolution": "1.5K", "aspect_ratio": "1:1", "size": "1536x1536" }, { "resolution": "1.5K", "aspect_ratio": "4:3", "size": "1792x1344" }, { "resolution": "1.5K", "aspect_ratio": "3:4", "size": "1344x1792" }, { "resolution": "1.5K", "aspect_ratio": "16:9", "size": "2048x1152" }, { "resolution": "1.5K", "aspect_ratio": "9:16", "size": "1152x2048" }, { "resolution": "1.5K", "aspect_ratio": "3:2", "size": "1872x1248" }, { "resolution": "1.5K", "aspect_ratio": "2:3", "size": "1248x1872" }, { "resolution": "1.5K", "aspect_ratio": "21:9", "size": "2352x1008" }, { "resolution": "2K", "aspect_ratio": "1:1", "size": "2048x2048" }, { "resolution": "2K", "aspect_ratio": "4:3", "size": "2368x1776" }, { "resolution": "2K", "aspect_ratio": "3:4", "size": "1776x2368" }, { "resolution": "2K", "aspect_ratio": "16:9", "size": "2816x1584" }, { "resolution": "2K", "aspect_ratio": "9:16", "size": "1584x2816" }, { "resolution": "2K", "aspect_ratio": "3:2", "size": "2496x1664" }, { "resolution": "2K", "aspect_ratio": "2:3", "size": "1664x2496" }, { "resolution": "2K", "aspect_ratio": "21:9", "size": "3136x1344" } ], "parameters": [ { "name": "model", "type": "string", "required": true, "values": [ "seedream-v5-pro-nsfw" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Exact public model ID." }, { "name": "prompt", "type": "string", "required": true, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Describe the image or requested edit." }, { "name": "n", "type": "integer", "required": false, "values": [ 1 ], "default": 1, "minimum": null, "maximum": null, "status": "documented", "description": "Requested image count; additional images may increase the charge.", "recommended": 1 }, { "name": "size", "type": "string", "required": false, "values": [ "1024x1024", "1152x864", "864x1152", "1424x800", "800x1424", "1248x832", "832x1248", "1568x672", "1536x1536", "1792x1344", "1344x1792", "2048x1152", "1152x2048", "1872x1248", "1248x1872", "2352x1008", "2048x2048", "2368x1776", "1776x2368", "2816x1584", "1584x2816", "2496x1664", "1664x2496", "3136x1344" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Use a listed WIDTHxHEIGHT value. For automatic sizing, omit size; do not send the literal auto.", "recommended": "2048x2048" }, { "name": "output_format", "type": "string", "required": false, "values": [ "png", "jpeg" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Encoded image format; separate from the response container.", "recommended": "png" }, { "name": "response_format", "type": "string", "required": false, "values": [ "b64_json" ], "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Read every item in `data[]`. Decode b64_json or download url when present.", "recommended": "b64_json" }, { "name": "image", "type": "file[]", "required": false, "values": null, "default": null, "minimum": null, "maximum": null, "status": "documented", "description": "Reference images as multipart files. Repeat image for multiple files.", "operation": "edit", "requiredWhen": "reference", "maxItems": 10 } ], "notes": [ "Read every item in `data[]`. Decode b64_json or download url when present.", "This guide documents only the fields and directives listed for each model; it does not define support for other fields such as mask, stream, or tools." ] } ] }