{"servers":[{"url":"https://api.modellix.ai/api/v1/bytedance/seedream-5.0-pro-multi-reference"}],"post":{"description":"[Core Function] Seedream 5.0 Pro Multi-Reference is a professional-grade multi-reference image generation (I2I) model that creates a single image from 2-10 reference images plus a text prompt. [Strengths] It excels at reference consistency, preserving characters, styles, and objects across multiple input images while following complex blending instructions with professional-grade quality. [Best For] Highly recommended for: keeping character or style consistency across references, combining subjects from different images into one scene, placing products into reference scenes, and IP-consistent content creation. [Limitations] Do NOT use this model with fewer than 2 or more than 10 reference images, and do NOT use it for batch generation or streaming; it outputs exactly one image per request. [Routing] For single-image editing use Seedream 5.0 Pro Edit; for text-only generation use Seedream 5.0 Pro; choose Seedream 5.0 Lite Edit when up to 14 reference images or batch outputs are needed.","operationId":"seedream50ProMultiRefI2iAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Blend two reference images","value":{"image":["https://example.com/ref-1.jpg","https://example.com/ref-2.jpg"],"prompt":"Combine the character from image 1 with the scene from image 2"}},"full_params":{"summary":"Multi-reference generation with full parameters","value":{"image":["https://example.com/ref-1.jpg","https://example.com/ref-2.jpg","https://example.com/ref-3.jpg"],"optimize_prompt_mode":"standard","output_format":"png","prompt":"Place the product from image 1 into the living room scene from image 2, keep the style of image 3","size":"2048x2048"}}},"schema":{"properties":{"image":{"description":"Reference image array (2-10 images), each as a URL (or Base64 data URI). Each image must be <= 30 MB, width and height > 14 px, aspect ratio within [1/16, 16], total pixels <= 36,000,000. Supported formats: JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF.","example":["https://example.com/ref-1.jpg","https://example.com/ref-2.jpg"],"items":{"type":"string"},"maxItems":10,"minItems":2,"type":"array"},"optimize_prompt_mode":{"default":"standard","description":"Prompt optimization mode. 'standard': higher quality with longer generation time. 'fast': faster generation with slightly lower quality.","enum":["standard","fast"],"example":"standard","type":"string"},"output_format":{"default":"jpeg","description":"Output image format. Supported values: 'jpeg' and 'png'.","enum":["jpeg","png"],"example":"png","type":"string"},"prompt":{"description":"Image editing instruction, supports Chinese and English. Maximum 10000 characters. We recommend keeping the prompt under 600 words. Interactive precise editing is supported: edit locations can be specified via coordinates, selection boxes, or arrows described in the prompt.","example":"Replace the object in the selection box (100,100)-(300,300) with a red vintage car","maxLength":10000,"minLength":1,"type":"string"},"size":{"default":"1024x1024","description":"Image size in format 'widthxheight'. Total pixels must be within [1280x720(921,600), 4,624,220] and aspect ratio within [1/16, 16], corresponding to the official 1K/2K resolution levels (3K/4K not supported). Recommended 2K sizes: 2048x2048 (1:1), 2816x1584 (16:9), 2368x1776 (4:3).","example":"2048x2048","type":"string"}},"required":["prompt","image"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"}},"summary":"Seedream 5.0 Pro Multi-Reference","x-mint":{"href":"bytedance/seedream-5-0-pro-multi-reference"}}}