> ## 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-0-260128-upscale

> API usage guide for seedance-2-0-260128-upscale.

{/* source_model_id: seedance-2-0-260128-upscale */}

{/* source_updated_at: 1781313665 */}

**Model ID**

```bash theme={null}
seedance-2-0-260128-upscale
```

**Calling method:** async

# Seedance 2.0 API Usage Guide

## Overview

**Seedance 2.0** is BytePlus's flagship video generation model. It supports text-to-video (T2V), image-to-video (I2V) using first/last frame conditioning, and reference-to-video (R2V) using reference images, videos, or audio.

## Authentication

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

## Submit Video Generation Request

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format (T2V)

```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-0-260128",
    "payload": {
      "prompt": "A majestic eagle soaring over snowy mountains at sunset",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "generate_audio": true
    }
  }'
```

### Request Format (I2V — first 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-0-260128",
    "payload": {
      "first_frame": "https://example.com/frame.jpg",
      "prompt": "Camera slowly pans upward",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'
```

### Request Format (R2V — reference images)

```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-0-260128",
    "payload": {
      "reference_images": ["https://example.com/ref1.jpg"],
      "prompt": "Cinematic slow motion",
      "duration": 7,
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'
```

### Request Parameters

| Parameter                  | Type         | Required | Description                            | Default      |
| -------------------------- | ------------ | -------- | -------------------------------------- | ------------ |
| `payload.prompt`           | string       | No\*     | Text description. Optional for I2V/R2V | `""`         |
| `payload.first_frame`      | image URL    | No\*     | First frame image URL (I2V)            | —            |
| `payload.last_frame`       | image URL    | No       | Last frame image URL (I2V)             | —            |
| `payload.reference_images` | image URL\[] | No\*     | Reference image URLs (R2V, max 9)      | —            |
| `payload.reference_videos` | video URL\[] | No\*     | Reference video URLs (R2V, max 3)      | —            |
| `payload.reference_audios` | audio URL\[] | No       | Reference audio URLs (R2V, max 3)      | —            |
| `payload.duration`         | integer      | No       | Video length in seconds (4–15)         | `5`          |
| `payload.resolution`       | enum         | No       | Output resolution: 480p / 720p / 1080p | `"720p"`     |
| `payload.ratio`            | enum         | No       | Aspect ratio                           | `"adaptive"` |
| `payload.generate_audio`   | boolean      | No       | Generate audio track                   | `true`       |
| `payload.watermark`        | boolean      | No       | Add watermark                          | `false`      |
| `payload.seed`             | integer      | No       | Reproducibility seed (-1 = random)     | —            |
| `payload.web_search`       | boolean      | No       | Enrich prompt with web search          | `false`      |

\*At least one of `prompt`, `first_frame`, `reference_images`, or `reference_videos` must be provided.

### Response

```json theme={null}
{
  "request_id": "abc123",
  "model": "seedance-2-0-260128",
  "status": "success",
  "outcome": {
    "media_urls": [{"id": "0", "url": "https://storage.googleapis.com/..."}],
    "thumbnail_image_url": "https://storage.googleapis.com/..."
  }
}
```

## Pricing (per second of video)

| Resolution | Price / second |
| ---------- | -------------- |
| 480p       | \$0.056        |
| 720p       | \$0.122        |
| 1080p      | \$0.299        |

## Check Request Status

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