# Seedance 2.0 15fast API Documentation

> 【15秒fast版本】Seedance 2.0 是字节跳动（ByteDance）旗下 Seed AI 团队（即梦 AI）于 2026 年 2 月推出的旗舰级 AI 视频生成大模型，主打生产级、电影质感、多镜头叙事与原生音画同步，被视为全球 AI 视频领域的里程碑产品。

## Overview

This document describes how to call the **Seedance 2.0 15fast** API.

- **Model / path slug**: `video/seedance`
- **Task type**: `async` (`sync` = synchronous, `async` = create task then poll / callback)
- **HTML docs**: `/doc/16`

## Authentication

All API requests require your platform API key as the query parameter `key`:

```
?key=YOUR_API_KEY
```

Get API Key:
1. Sign in to the console
2. Open [API Key Management](/user/key) and create or copy your key
3. Append `key=YOUR_API_KEY` to the request URL (or pass it in form/JSON when the endpoint accepts it)

---

## API Information

- **URL**: `POST https://apis.xiaobao.ink/api/video/seedance`
- **Content-Type**: `application/json` (request body commonly `application/json` or `application/x-www-form-urlencoded` for POST)
- **HTTP Method**: `POST`

### Request Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `prompt` | Yes | 提示词 |
| `aspect_ratio` | No | 尺寸，默认为720x1280。可选：720x1280，1280x720（竖屏或者横屏的意思） 默认值: 720x1280 |
| `image_urls` | Yes | 图片参考-使用 File格式 |
| `callBackUrl` | No | 用于接收视频生成任务完成更新的URL地址。可选但推荐在生产环境中使用。 |

> **Note**: `key` (API key) is required for authenticated calls even if omitted from the parameter list above.

### Request Example

```
https://apis.xiaobao.ink/api/video/seedance?key=你的密钥
```

## Details

## 请求HEADER：

| 名称 | 值 |
| --- | --- |
| Content-Type | application/json |

## 请求参数说明：

| 名称 | 必填 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- | --- |
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| prompt | 是 | string | 哥斯拉在广场中央跳舞 | 提示词 |
| aspect_ratio | 否 | string | 720x1280 | 尺寸，默认为720x1280。可选：720x1280，1280x720（竖屏或者横屏的意思） |
| image_urls | 否 | string | [https://www.xom.com/1.png] | 图片 |
| callBackUrl | 是 | string | http://your-callback-url.com/complete | 用于接收视频生成任务完成更新的URL地址。可选但推荐在生产环境中使用。 |

## 返回参数说明：

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | string | 请求结果数据集 |
| - task_id | string | 任务 ID 可与“获取任务详细信息”端点一起使用，以查询任务状态 |
| debug | string/array | 调试数据 |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |

## Response Example

```
{  "code": 200,  "msg": "success",  "data": {    "taskId": "veo_task_abcdef123456"  }}
```

## Error Codes

| Status / code | Description |
|---------------|-------------|
| 200 / success | Request successful |
| 400 | Invalid request parameters |
| 401 | Authentication failed, please check API Key |
| 402 | Insufficient account balance / points |
| 429 | Request rate limit exceeded |
| 500 | Internal server error |

## Usage Flow

1. **Create Task**: Call this API with your `key` and required parameters
2. **Get Task ID**: Read the task id from the response
3. **Wait for Results**: Use the notify/callback URL if provided, or poll the related query endpoint
4. **Get Results**: When the task succeeds, read result URLs / payload from the response

---

_Generated for AI / LLM consumption. Source of truth: `api_list` (same as HTML `/doc/{id}`)._