> ## 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.

# seedance-2-5-260628

> API usage guide for seedance-2-5-260628.

**Model ID**

```bash theme={null}
seedance-2-5-260628
```

**Calling method:** async

# seedance-2-5-260628 API Usage Guide

## Overview

**seedance-2-5-260628** is the latest-generation Dreamina Seedance video generation model, supporting text-to-video and image-to-video workflows with rich reference inputs including images, videos, audios, and pre-uploaded avatar assets.

### Key Features

* **Text-to-Video & Image-to-Video**: Supports pure text prompts with optional first/last frame anchoring
* **Flexible Duration**: 4-15 seconds of generated video
* **Resolutions**: 480p and 720p outputs
* **Flexible Aspect Ratios**: Standard, cinematic, and adaptive ratios
* **Audio Generation**: Optional audio synthesis alongside video
* **Web Search**: Grounded generation using live web search
* **Rich References**: Reference images, videos, audios, and avatar asset IDs
* **Reproducibility**: Seed parameter ensures deterministic output
* **Watermark Control**: Choose whether to embed a watermark

***

## Authentication

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

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

## Submit Video Generation Request

### Base URL

```
https://console.gmicloud.ai
```

### Endpoint

```
POST /api/v1/ie/requestqueue/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": "seedance-2-5-260628",
    "payload": {
      "prompt": "A lone astronaut walks across a crimson Martian landscape at sunset.",
      "first_frame": "https://example.com/frame.jpg",
      "duration": 8,
      "resolution": "720p",
      "ratio": "16:9",
      "seed": 42,
      "watermark": false,
      "generate_audio": true,
      "web_search": false
    }
  }'
```

### Request Parameters

| Parameter          | Type    | Required | Description                            | Default  | Constraints                                                           |
| ------------------ | ------- | -------- | -------------------------------------- | -------- | --------------------------------------------------------------------- |
| `prompt`           | string  | Yes      | Text description of the video          | `""`     | Required                                                              |
| `duration`         | integer | No       | Duration in seconds                    | `5`      | 4-15                                                                  |
| `resolution`       | enum    | No       | Output resolution                      | `"720p"` | `"480p"`, `"720p"`                                                    |
| `ratio`            | enum    | No       | Aspect ratio                           | `"16:9"` | `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`, `"21:9"`, `"adaptive"` |
| `seed`             | integer | No       | Random seed for reproducibility        | `null`   | 0-4294967295                                                          |
| `watermark`        | boolean | No       | Whether to embed a watermark           | `false`  | true / false                                                          |
| `generate_audio`   | boolean | No       | Whether to synthesize audio            | `true`   | true / false                                                          |
| `web_search`       | boolean | No       | Whether to enable web search grounding | `false`  | true / false                                                          |
| `first_frame`      | image   | No       | First frame image for I2V              | `""`     | Publicly accessible URL                                               |
| `last_frame`       | image   | No       | Last frame image for I2V               | `""`     | Publicly accessible URL                                               |
| `reference_images` | array   | No       | Reference images (URLs)                | `[]`     | Up to 9 publicly accessible URLs                                      |
| `reference_videos` | array   | No       | Reference videos (URLs)                | `[]`     | Up to 3 publicly accessible URLs                                      |
| `reference_audios` | array   | No       | Reference audio files (URLs)           | `[]`     | Up to 3 publicly accessible URLs                                      |
| `avatar_asset_ids` | array   | No       | Pre-uploaded avatar asset IDs          | `[]`     | Array of asset ID strings                                             |

### Response

```json theme={null}
{
  "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
  "model": "seedance-2-5-260628",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}
```

## Check Request Status

### Endpoint

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

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/c1c5a812-3c44-4c77-b02c-91c934abcd12" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
  "org_id": "your-org-id",
  "model": "seedance-2-5-260628",
  "status": "success",
  "payload": {
    "prompt": "A lone astronaut walks across a crimson Martian landscape at sunset.",
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9",
    "seed": 42,
    "watermark": false,
    "generate_audio": true
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930,
  "queued_at": 1750442925
}
```

## 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=seedance-2-5-260628
```

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/seedance-2-5-260628
```

## Tips for Better Results

1. **Detailed Prompts**: More descriptive text yields better visuals
2. **Use First/Last Frame**: Anchor the start and end for tighter I2V consistency
3. **Adaptive Ratio**: Use `adaptive` to let the model choose the best ratio for your content
4. **Seeds for Control**: Use a fixed seed for reproducible outputs
5. **Audio Sync**: Enable `generate_audio` for immersive, sound-matched videos
6. **Reference Videos**: Supplying a reference video guides motion and timbre, and is priced differently from a text-only generation

## Examples

### Text-to-Video

```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": "seedance-2-5-260628",
    "payload": {
      "prompt": "A thunderstorm rolls over a medieval castle at night, lightning illuminating stone towers",
      "duration": 12,
      "resolution": "720p",
      "ratio": "21:9",
      "generate_audio": true
    }
  }'
```

### Image-to-Video with First and Last Frame

```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": "seedance-2-5-260628",
    "payload": {
      "prompt": "The flower slowly blooms, petals unfurling in morning light",
      "first_frame": "https://example.com/bud.jpg",
      "last_frame": "https://example.com/bloom.jpg",
      "duration": 6,
      "resolution": "720p",
      "ratio": "1:1",
      "generate_audio": false
    }
  }'
```

### With Reference Assets

```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": "seedance-2-5-260628",
    "payload": {
      "prompt": "The character walks through a neon-lit alley",
      "avatar_asset_ids": ["asset-id-abc123"],
      "reference_images": ["https://example.com/style-ref.jpg"],
      "duration": 10,
      "resolution": "720p",
      "ratio": "adaptive"
    }
  }'
```