{"servers":[{"url":"https://api.modellix.ai/api/v1/bytedance/seedream-5.0-pro"}],"post":{"description":"[Core Function] Seedream 5.0 Pro is ByteDance's flagship professional-grade Text-to-Image (T2I) generation model. [Strengths] It delivers top-tier image quality with enhanced precision control over positions and elements, superior prompt adherence, and improved generation consistency for professional scenarios. [Best For] Highly recommended for: professional design assets, high-fidelity photorealistic imagery, precisely controlled compositions, and brand or commercial visuals where quality matters most. [Limitations] Do NOT use this model for batch image generation or streaming output; it generates exactly one image per request and supports up to 2K resolution (no 3K/4K). [Routing] Choose this Pro model when the user emphasizes ultimate quality or precision. Choose Seedream 5.0 Lite when real-time web knowledge, batch generation, or 3K resolution is needed. To edit an existing image use Seedream 5.0 Pro Edit; to blend multiple reference images use Seedream 5.0 Pro Multi-Reference.","operationId":"seedream50ProT2iAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Basic generation","value":{"prompt":"A cinematic sunset over a futuristic city skyline"}},"full_params":{"summary":"Full parameters with PNG output","value":{"optimize_prompt_mode":"fast","output_format":"png","prompt":"A futuristic city at sunset, ultra detailed, cinematic lighting, volumetric clouds","size":"2048x2048"}}},"schema":{"properties":{"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 description text, supports Chinese and English. Maximum 10000 characters. We recommend keeping the prompt under 600 words. Excessively long prompts may scatter information, causing the model to overlook details and focus only on major elements, which can result in missing details in the generated image.","example":"A futuristic city at sunset, ultra detailed","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"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"code":0,"data":{"get_result":{"method":"GET","url":"https://api.modellix.ai/api/v1/tasks/task-seedream50pro001"},"model_id":"bytedance/seedream-5.0-pro","status":"pending","task_id":"task-seedream50pro001"},"message":"success"},"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"},"400":{"content":{"application/json":{"example":{"code":400,"message":"Invalid parameters: parameter 'prompt' is required"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Invalid request parameters"},"401":{"content":{"application/json":{"example":{"code":401,"message":"Authentication failed: invalid API key"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Unauthorized - Invalid or missing API Key"},"429":{"content":{"application/json":{"example":{"code":429,"message":"Rate limit exceeded: 100 requests per minute, retry after 60 seconds"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Too many requests - Rate limit exceeded","headers":{"X-RateLimit-Limit":{"description":"Maximum requests per minute","schema":{"example":100,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining quota in current window","schema":{"example":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Rate limit window reset time (Unix timestamp)","schema":{"example":1704067260,"type":"integer"}}}},"500":{"content":{"application/json":{"example":{"code":500,"message":"Internal server error"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Internal server error"}},"summary":"Seedream 5.0 Pro","x-mint":{"href":"bytedance/seedream-5-0-pro"}}}