> ## 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-5.0-lite

> API usage guide for seedream-5.0-lite.

{/* source_model_id: seedream-5.0-lite */}

{/* source_updated_at: 1774508188 */}

**Model ID**

```bash theme={null}
seedream-5.0-lite
```

**Calling method:** sync

# Seedream-5.0-lite API Documentation

Seedream-5.0-lite is a next-generation multimodal image generation model by Byteplus. It supports text, single-image, and multi-image inputs, offering high-fidelity outputs with consistent subject generation.

## 1. API Endpoint & Authentication

**Base URL:** `https://console.gmicloud.ai`
**Endpoint:** `POST /api/v1/ie/requestqueue/apikey/requests`
**Header:**

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## 2. Model Specifications

* **Pricing:** \$0.035 per output image
* **Max Input Images:** 14 reference images
* **Max Output Images:** 15 (Total of reference + generated)
* **Output Formats:** jpeg (default), png (Exclusive to 5.0-lite)

***

## 3. Image Dimension Methods (Mutually Exclusive)

### Method 1: Intelligence Presets

Specify a preset and describe the desired aspect ratio/shape in the text prompt.

* **Options:** `2K`, `3K`

### Method 2: Custom Pixel Dimensions

Specify exact width and height (e.g., "3750x1250"). Constraints:

* **Total Pixels (W x H):** Must be between 3,686,400 and 10,404,496.
* **Aspect Ratio (W / H):** Must be between 0.0625 (1:16) and 16.0 (16:1).

## 4. Parameter Reference

| Parameter                     | Type    | Required | Description                                          |
| :---------------------------- | :------ | :------- | :--------------------------------------------------- |
| `prompt`                      | string  | Yes      | Text description (\< 600 words recommended).         |
| `image`                       | array   | No       | Array of reference image URLs (up to 14).            |
| `size`                        | string  | No       | Preset (2K, 3K) or custom (WxH). Default: 2048x2048. |
| `output_format`               | string  | No       | `jpeg` or `png`.                                     |
| `max_images`                  | integer | No       | Total images allowed (up to 15).                     |
| `sequential_image_generation` | string  | No       | `auto` (for consistency) or `disabled`.              |
| `watermark`                   | boolean | No       | Toggle "AI Generated" watermark. Default: false.     |

## 5. Example CURL Request

```bash theme={null}
curl -X POST "[https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests](https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests)" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite",
    "payload": {
      "prompt": "A cinematic widescreen shot of a futuristic neon city",
      "size": "2560x1440",
      "output_format": "png",
      "max_images": 1,
      "watermark": false
    }
  }'
```

## 6. Checking Request Status

**Endpoint:** `GET /api/v1/ie/requestqueue/apikey/requests/{request_id}`

* **queued**: Waiting in line.
* **processing**: Generating image.
* **success**: Completed. Find URLs in `outcome.media_urls`.
* **failed**: Request failed.