> ## 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-3-0-t2i-250415

> API usage guide for seedream-3-0-t2i-250415.

{/* source_model_id: seedream-3-0-t2i-250415 */}

{/* source_updated_at: 1782168221 */}

**Model ID**

```bash theme={null}
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:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Video Generation Request

### Endpoint

```
POST /api/v1/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-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

```json theme={null}
{
  "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

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "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

```bash theme={null}
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

```bash theme={null}
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

```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-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

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

3. Keep seeds consistent for reproducible output.

4. Disable watermark for raw production assets.

5. Optimize size — 1024×1024 for best detail, 512×512 for fast previews.

## Parameter Examples

### Realistic Photography

```json theme={null}
{
  "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

```json theme={null}
{
  "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

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