Model ID

seedream-3-0-t2i-250415

Calling method: sync

Seedream-3-0-t2i-250415 API Usage Guide

Overview

Seedream 3.0 is a foundational image generation model that supports native high-resolution output. With comprehensive capabilities comparable to GPT-4o, it ranks among the world’s top-tier models. It offers faster response times, more accurate fine text generation with improved typographic effects, stronger instruction adherence, as well as enhanced fidelity and detail performance.

Key Features:

High Resolution Output: Generates images up to 1024×1024 resolution
Prompt-based Control: Translates natural text into precise, detailed visuals
Guidance Scale Adjustment: Fine-tune prompt adherence from creative to literal
Seed Reproducibility: Generate consistent images using the same seed value
Optional Watermark: Embed watermark for brand or platform compliance
Fast and Cost-Effective: Optimized for real-time image generation on GPU clusters

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Endpoint

POST /api/v1/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-3-0-t2i-250415",
    "payload": {
      "prompt": "A futuristic city skyline at sunset, ultra-realistic lighting, detailed reflections",
      "size": "1024x1024",
      "seed": 42,
      "guidance_scale": 2.5,
      "add_watermark": false,
      "response_format": "url"
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`model`	string	Yes	Model identifier	-	Must be `"seedream-3-0-t2i-250415"`
`payload.prompt`	string	Yes	Text prompt describing the image to generate	-	Required
`payload.size`	string	No	Output resolution	`"1024x1024"`	Options: `"512x512"`, `"768x768"`, `"1024x1024"`
`payload.seed`	integer	No	Random seed for reproducibility	`-1`	Any integer; `-1` = random
`payload.guidance_scale`	float	No	Controls how closely image follows prompt	`2.5`	Recommended: 1.0–7.5
`payload.add_watermark`	boolean	No	Whether to include a watermark	`false`	`true` / `false`
`payload.response_format`	string	No	Format of the returned result	`"url"`	`url`, `base64`, `json`

Response

{
  "request_id": "afc23b91-1f45-43a7-9175-4d6d39e1ab13",
  "model": "seedream-3-0-t2i-250415",
  "status": "queued",
  "created_at": 1761763441,
  "updated_at": 1761763441,
  "queued_at": 1761763441
}

Check Request Status

Endpoint

GET /api/v1/apikey/requests/{request_id}

Example

curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "afc23b91-1f45-43a7-9175-4d6d39e1ab13",
  "model": "seedream-3-0-t2i-250415",
  "status": "success",
  "payload": {
    "prompt": "A futuristic city skyline at sunset, ultra-realistic lighting, detailed reflections",
    "size": "1024x1024",
    "seed": 42,
    "guidance_scale": 2.5,
    "add_watermark": false,
    "response_format": "url"
  },
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-generated-images/user-assets/.../seedream3_generated_image_afc23b91.jpg"
      }
    ],
    "usage": {
      "generated_images": 1
    }
  },
  "created_at": 1761763441,
  "updated_at": 1761763451,
  "queued_at": 1761763441
}

Request Status Values

Status	Description
`queued`	Request is waiting to be processed
`processing`	Image generation is in progress
`success`	Image generation completed successfully
`failed`	Image generation failed
`cancelled`	Request was cancelled

List Your Requests

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests?model_id=seedream-3-0-t2i-250415

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=seedream-3-0-t2i-250415" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Model Information

Endpoint

GET /api/v1/ie/requestqueue/apikey/models/seedream-3-0-t2i-250415

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/seedream-3-0-t2i-250415" \
  -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-3-0-t2i-250415",
    "other-model-1",
    "other-model-2"
  ]
}

Pricing

Pricing Type: Per-image request
Price: $0.05 per image
Unit: Image

Example cost calculation:

1 image = $0.05
10 images = $0.50
100 images = $5.00

Image Specifications

Resolution: Up to 1024×1024 pixels
Format: PNG or JPEG
Output: Downloadable via signed URL
Watermark: Optional (default: false)
Default CFG (Guidance Scale): 2.5

Tips for Better Results

Use clear, descriptive prompts — e.g., “A fantasy landscape with floating islands, golden lighting, detailed textures.”
Adjust guidance scale —

1.5–3.0 for creative freedom
3.5–6.0 for stronger prompt adherence

Keep seeds consistent for reproducible output.
Disable watermark for raw production assets.
Optimize size — 1024×1024 for best detail, 512×512 for fast previews.

Parameter Examples

Realistic Photography

{
  "prompt": "A portrait of an astronaut walking on a beach at sunrise, realistic lighting and reflections",
  "size": "1024x1024",
  "guidance_scale": 3.0,
  "seed": 123
}

Stylized Illustration

{
  "prompt": "A whimsical watercolor painting of a cat wearing sunglasses and sipping coffee",
  "size": "1024x1024",
  "guidance_scale": 4.5,
  "add_watermark": true
}

Cinematic Concept Art

{
  "prompt": "A cyberpunk alley illuminated by neon lights in the rain, cinematic composition",
  "size": "1024x1024",
  "guidance_scale": 2.8,
  "seed": 777,
  "add_watermark": false
}

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

seedream-3-0-t2i-250415

Seedream-3-0-t2i-250415 API Usage Guide

Overview

Key Features:

Authentication

Submit Video Generation Request

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

Image Specifications

Tips for Better Results

Parameter Examples

Realistic Photography

Stylized Illustration

Cinematic Concept Art

​Seedream-3-0-t2i-250415 API Usage Guide

​Overview

​Key Features:

​Authentication

​Submit Video Generation Request

​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

​Image Specifications

​Tips for Better Results

​Parameter Examples

​Realistic Photography

​Stylized Illustration

​Cinematic Concept Art

Seedream-3-0-t2i-250415 API Usage Guide

Overview

Key Features:

Authentication

Submit Video Generation Request

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

Image Specifications

Tips for Better Results

Parameter Examples

Realistic Photography

Stylized Illustration

Cinematic Concept Art