Skip to main content

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.

Model ID 
seedream-3-0-t2i-250415

​
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

ParameterTypeRequiredDescriptionDefaultConstraints
modelstringYesModel identifier-Must be "seedream-3-0-t2i-250415"
payload.promptstringYesText prompt describing the image to generate-Required
payload.sizestringNoOutput resolution"1024x1024"Options: "512x512", "768x768", "1024x1024"
payload.seedintegerNoRandom seed for reproducibility-1Any integer; -1 = random
payload.guidance_scalefloatNoControls how closely image follows prompt2.5Recommended: 1.0–7.5
payload.add_watermarkbooleanNoWhether to include a watermarkfalsetrue / false
payload.response_formatstringNoFormat 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

StatusDescription
queuedRequest is waiting to be processed
processingImage generation is in progress
successImage generation completed successfully
failedImage generation failed
cancelledRequest 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"
  ]
}

​
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

  1. Use clear, descriptive prompts, e.g., “A fantasy landscape with floating islands, golden lighting, detailed textures.”
  2. Adjust guidance scale
  • 1.5–3.0 for creative freedom
  • 3.5–6.0 for stronger prompt adherence
  1. Keep seeds consistent for reproducible output.
  2. Disable watermark for raw production assets.
  3. 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
}