> ## Documentation Index > Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt > Use this file to discover all available pages before exploring further. # seedream-4-0-250828 > API usage guide for seedream-4-0-250828. {/* source_model_id: seedream-4-0-250828 */} {/* source_updated_at: 1782168489 */} **Model ID** ```bash theme={null} seedream-4-0-250828 ``` **Calling method:** sync # Seedream-4-0-250828 API Usage Guide ## Overview **Seedream-4-0-250828** is a **multimodal image generation model** supporting text, single-image, and multi-image inputs. It delivers high-fidelity, stylistically consistent outputs with flexible composition control. With features like **multi-image blending**, **image editing**, and **subject-consistent sequential generation**, Seedream 4.0 gives creators unprecedented freedom and control in digital image creation. **Key Features:** **Text-to-Image & Image-to-Image Support:** Accepts text-only, single image, or multiple images as input. **Multi-Image Blending:** Combine several reference images to synthesize coherent outputs. **Image Editing:** Modify or restyle existing images using textual guidance. Sequential Batch Generation: Generate consistent image sequences maintaining the same subject or composition. **High Resolution:** Outputs up to 1024×1024 pixels. **Watermark Option:** Easily toggle watermark for brand or compliance purposes. Fast & Reliable Inference: Optimized for high-throughput GPU acceleration in GMI Cloud’s infrastructure. ## Authentication All API requests require authentication using an API key. Include your API key in the Authorization header: ```bash theme={null} Authorization: Bearer YOUR_API_KEY ``` ## Submit Image Generation Request ### Base URL ``` https://console.gmicloud.ai ``` ### Endpoint ``` POST /api/v1/ie/requestqueue/apikey/requests ``` ### Request Format ```bash theme={null} curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-4-0-250828", "payload": { "prompt": "A hyperrealistic portrait of a cyberpunk woman under neon lights", "image": [ "https://example.com/ref1.jpg", "https://example.com/ref2.jpg" ], "size": "1024x1024", "max_images": 2, "sequential_image_generation": "auto", "seed": -1, "watermark": true, "response_format": "url" } }' ``` ### Request Parameters | Parameter | Type | Required | Description | Default | Constraints | | ----------------------------- | ------- | -------- | ------------------------------------------------------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | Yes | Text description of the desired image (max 2000 characters). | - | Required | | `image` | string | No | Reference image URL or an array of URLs (jpeg/png). | - | Up to 10 images are supported. | | `size` | string | No | Output size preset (supports 1K/2K/4K or custom WxH). | "2048x2048" | Options: "1K", "2K", "4K", "1024x1024", "1440x2560", "1664x2496", "1728x2304", "2048x2048", "2304x1728", "2496x1664", "2560x1440", "3024x1296", "4096x4096" | | `max_images` | integer | No | Total (reference+generated) ≤ 15. | 1 | Optional | | `sequential_image_generation` | string | No | Generate a sequence of related images automatically. | disabled | Options: "disabled", "auto" | | `seed` | integer | No | Random seed. Use -1 for random. | -1 | -1 to 2147483647 | | `watermark` | boolean | No | Whether to include watermark in the output. | false | Optional | ### Response ```json theme={null} { "request_id": "7eaa77fc-bc67-4021-9f1b-96b3fd832314", "model": "seedream-4-0-250828", "status": "queued", "created_at": 1761763441, "updated_at": 1761763441, "queued_at": 1761763441 } ``` ## Check Request Status ### Endpoint ``` GET /api/v1/ie/requestqueue/apikey/requests/{request_id} ``` ### Example ```bash theme={null} curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/7eaa77fc-bc67-4021-9f1b-96b3fd832314" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response ```json theme={null} { "request_id": "7eaa77fc-bc67-4021-9f1b-96b3fd832314", "model": "seedream-4-0-250828", "status": "success", "payload": { "prompt": "A hyperrealistic portrait of a cyberpunk woman under neon lights", "image": [ "https://example.com/ref1.jpg", "https://example.com/ref2.jpg" ], "size": "1024x1024", "max_images": 2, "sequential_image_generation": "auto", "seed": -1, "watermark": true, "response_format": "url" }, "outcome": { "media_urls": [ { "id": "0", "url": "https://storage.googleapis.com/gmi-generated-assets/.../seedream4_output_0.jpg" }, { "id": "1", "url": "https://storage.googleapis.com/gmi-generated-assets/.../seedream4_output_1.jpg" } ] }, "created_at": 1761763441, "updated_at": 1761763451, "queued_at": 1761763441 } ``` ## Request Status Values | Status | Description | | ------------ | --------------------------------------- | | `queued` | Request is waiting to be processed | | `processing` | Video generation is in progress | | `success` | Video generation completed successfully | | `failed` | Video generation failed | | `cancelled` | Request was cancelled | ## List Your Requests ### Endpoint ``` GET api/v1/ie/requestqueue/apikey/requests?model_id=seedream-4-0-250828 ``` ### Example ```bash theme={null} curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=seedream-4-0-250828" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## Get Model Information ### Endpoint ``` GET /api/v1/ie/requestqueue/apikey/models/seedream-4-0-250828 ``` ### Example ```bash theme={null} curl -X GET "https://api.example.com/api/v1/apikey/models/seedream-4-0-250828" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## List Available Models ### Endpoint ``` GET /api/v1/apikey/models ``` ### Example ```bash theme={null} curl -X GET "https://api.example.com/api/v1/apikey/models" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response ```json theme={null} { "model_ids": [ "seedream-4-0-250828", "other-model-1", "other-model-2" ] } ``` ## Pricing * **Pricing Type**: Per-image request * **Price**: \$0.05 per image * **Unit**: Image ## Example Use Cases ### Text-to-Image (Prompt Only) ```bash theme={null} curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-4-0-250828", "payload": { "prompt": "A fantasy castle floating above clouds, golden sunlight, cinematic tone", "size": "1024x1024", "max_images": 1, "watermark": false } }' ``` ### Multi-Image Blending ```bash theme={null} curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-4-0-250828", "payload": { "prompt": "Merge visual styles of both references into one cohesive fantasy artwork", "image": [ "https://example.com/portrait1.jpg", "https://example.com/portrait2.jpg" ], "max_images": 1, "watermark": true } }' ``` ### Sequential Consistent Image Generation ```bash theme={null} curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-4-0-250828", "payload": { "prompt": "A cat exploring a futuristic city street at night, cinematic perspective", "size": "1024x1024", "max_images": 3, "sequential_image_generation": "auto", "watermark": false } }' ``` ## Tips for Better Results 1. **Prompt Clarity**: Use detailed, specific prompts for precise results. 2. **Reference Image Control**: Include 1–3 clear, high-quality images for better blending. 3. **Sequential Mode**: Enables consistent subjects across a batch of generated images. 4. **Watermark Toggle**: Disable watermark for professional or internal use. 5. **Seed Usage**: Set a fixed seed for reproducible output.