> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedream 5.0 Pro Multi-Reference > [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. ## OpenAPI ````yaml /model-api/bytedance/bytedance-i2i.json post /bytedance/seedream-5.0-pro-multi-reference openapi: 3.1.0 info: description: The image-to-image models API from ByteDance. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: ByteDance Image-to-Image Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-image models API from ByteDance. security: - bearerAuth: [] paths: /bytedance/seedream-5.0-pro-multi-reference: post: summary: Seedream 5.0 Pro Multi-Reference 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: required: true content: application/json: schema: $ref: '#/components/schemas/Seedream50ProMultiRefI2iRequest' examples: basic: summary: Blend two reference images value: prompt: >- Combine the character from image 1 with the scene from image 2 image: - https://example.com/ref-1.jpg - https://example.com/ref-2.jpg full_params: summary: Multi-reference generation with full parameters value: prompt: >- Place the product from image 1 into the living room scene from image 2, keep the style of image 3 image: - https://example.com/ref-1.jpg - https://example.com/ref-2.jpg - https://example.com/ref-3.jpg size: 2048x2048 optimize_prompt_mode: standard output_format: png responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' components: schemas: Seedream50ProMultiRefI2iRequest: type: object required: - prompt - image properties: prompt: type: string 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. minLength: 1 maxLength: 10000 example: >- Replace the object in the selection box (100,100)-(300,300) with a red vintage car image: type: array 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. minItems: 2 maxItems: 10 items: type: string example: - https://example.com/ref-1.jpg - https://example.com/ref-2.jpg size: type: string 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). default: 1024x1024 example: 2048x2048 optimize_prompt_mode: type: string enum: - standard - fast description: >- Prompt optimization mode. 'standard': higher quality with longer generation time. 'fast': faster generation with slightly lower quality. default: standard example: standard output_format: type: string enum: - jpeg - png description: 'Output image format. Supported values: ''jpeg'' and ''png''.' default: jpeg example: png AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````