Model ID

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:

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

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

{
  "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

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

{
  "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

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

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

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
    "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)

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

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

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

Prompt Clarity: Use detailed, specific prompts for precise results.
Reference Image Control: Include 1–3 clear, high-quality images for better blending.
Sequential Mode: Enables consistent subjects across a batch of generated images.
Watermark Toggle: Disable watermark for professional or internal use.
Seed Usage: Set a fixed seed for reproducible output.

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

seedream-4-0-250828

Seedream-4-0-250828 API Usage Guide

Overview

Authentication

Submit Image Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Example Use Cases

Text-to-Image (Prompt Only)

Multi-Image Blending

Sequential Consistent Image Generation

Tips for Better Results

​Seedream-4-0-250828 API Usage Guide

​Overview

​Authentication

​Submit Image Generation Request

​Base URL

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Pricing

​Example Use Cases

​Text-to-Image (Prompt Only)

​Multi-Image Blending

​Sequential Consistent Image Generation

​Tips for Better Results

Seedream-4-0-250828 API Usage Guide

Overview

Authentication

Submit Image Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Example Use Cases

Text-to-Image (Prompt Only)

Multi-Image Blending

Sequential Consistent Image Generation

Tips for Better Results