> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jimmyai.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# SP 创建视频
> 创建 Seedance 2.0 视频生成任务。支持满血版（sd2_mx_*，按秒计费，素材须审核）、SP 经济版（seedance2.0-sp / seedance2.0-fast-sp，按分辨率按秒计费）、SP 官方版（seedance2.0-of-sp / seedance2.0-of-fast-sp，按分辨率按秒计费）、Mini 版（seedance2.0-mini，按分辨率按秒计费）、Mini 特价版（seedance2.0-mini-sp，按次计费，仅 480p/720p）、MD（seedance2.0-md / seedance2.0-fast-md，按次计费，720p，不支持音频）、Fast I2V（seedance2.0-fast-i2v，按次计费，720p，仅图片参考最多 9 张，不支持参考视频/音频）、STD 标准版（seedance2.0-std，按次计费，720p，支持音频参考）。创建后使用 GET /api/open-api/v1/videos/{taskId} 查询结果。详见 seedance/md/create、seedance/md/fast-i2v、seedance/md/std、seedance/mini/create 与 seedance/mini-sp/create 文档。
创建 Seedance **SP** 视频生成任务（经济版 / 官方版）。提交成功后返回 `task_id`，请使用 [查询视频任务](/zh/api-reference/common/query) 轮询状态，完成后从 `result.video_url` 获取视频地址。
本接口与 [创建 Seedance 满血版视频](/zh/api-reference/seedance/create) 共用 `POST /api/open-api/v1/seedance/videos`。满血版见满血版文档，Mini 见 [Mini 创建视频](/zh/api-reference/seedance/mini/create)，MD 见 [MD 创建视频](/zh/api-reference/seedance/md/create)。
## 模型
| 线路 | `model` 取值 | 计费 | 时长 |
| ----- | ------------------------ | -------- | ------ |
| 经济版标准 | `seedance2.0-sp` | 按秒 × 分辨率 | 4–15 秒 |
| 经济版快速 | `seedance2.0-fast-sp` | 按秒 × 分辨率 | 4–15 秒 |
| 官方版标准 | `seedance2.0-of-sp` | 按秒 × 分辨率 | 4–15 秒 |
| 官方版快速 | `seedance2.0-of-fast-sp` | 按秒 × 分辨率 | 4–15 秒 |
支持输出分辨率：`480p`、`720p`（默认）、`1080p`。计费按「单价 × 时长（秒）」结算，分辨率通过 `resolution` 字段指定。
## 请求参数
| 字段 | 类型 | 必填 | 说明 |
| ------------------ | --------- | -- | ------------------------------- |
| `model` | string | 是 | 见上表 |
| `prompt` | string | 是 | 视频生成提示词 |
| `duration` | int | 是 | 时长（秒），4–15，默认 5 |
| `resolution` | string | 否 | 输出分辨率：`480p`、`720p`（默认）、`1080p` |
| `ratio` | string | 否 | 画面比例，如 `16:9`、`9:16`、`1:1` |
| `images` | string\[] | 否 | 参考图列表 |
| `first_image` | string | 否 | 首帧图片 |
| `last_image` | string | 否 | 尾帧图片 |
| `reference_videos` | string\[] | 否 | 参考视频列表 |
| `reference_audios` | string\[] | 否 | 参考音频；须搭配参考图/视频或首尾帧 |
## 素材说明
* 可直接传入公网 `https://` URL。
* 也可先 [上传素材](/zh/api-reference/seedance/sp/assets-upload)，再使用 `asset://{asset_id}`。
* 涉及真人肖像时，须先 [提交真人加白](/zh/api-reference/seedance/sp/realperson-submit)，待 `Active` 后再引用。
## 约束
* `images`（参考图模式）与 `first_image` / `last_image`（首尾帧模式）**不可同时使用**。
* `reference_audios` 不能单独使用，须搭配参考图、参考视频或首尾帧。
## 示例
### 官方版 — 首帧图生视频
```bash theme={null}
curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
-H 'Authorization: Bearer sk_xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance2.0-of-sp",
"prompt": "雨夜街头，女孩回头微笑，电影感镜头推进",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"first_image": "https://example.com/start.png"
}'
```
### 经济版 — 首帧图生视频
```bash theme={null}
curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
-H 'Authorization: Bearer sk_xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance2.0-sp",
"prompt": "雨夜街头，女孩回头微笑，电影感镜头推进",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"first_image": "https://example.com/start.png"
}'
```
### 参考图生视频
```bash theme={null}
curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
-H 'Authorization: Bearer sk_xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance2.0-sp",
"prompt": "人物缓缓转头，微风拂动发丝",
"duration": 6,
"ratio": "9:16",
"images": [
"https://example.com/ref-1.jpg",
"https://example.com/ref-2.jpg"
]
}'
```
### 使用素材库 asset
```bash theme={null}
curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
-H 'Authorization: Bearer sk_xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance2.0-fast-sp",
"prompt": "镜头缓慢推进，光影变化细腻",
"duration": 8,
"resolution": "1080p",
"ratio": "16:9",
"images": ["asset://your-asset-id-here"]
}'
```
## 响应示例
```json theme={null}
{
"code": 0,
"msg": "ok",
"data": {
"task_id": "vid_abc123",
"status": "queued",
"model": "seedance2.0-of-sp",
"created_at": 1710000000
}
}
```
## 查询任务
```bash theme={null}
curl -X GET 'https://www.jimmyai.cn/api/open-api/v1/videos/{task_id}' \
-H 'Authorization: Bearer sk_xxx'
```
任务状态：`queued` → `processing` → `completed` / `failed`。完成后从 `data.result.video_url` 获取视频地址。
视频结果 URL 保存约 **3 天**，请及时转存。
## OpenAPI
````yaml POST /api/open-api/v1/seedance/videos
openapi: 3.1.0
info:
title: Jimmy AI OpenAPI
description: API for Jimmy AI video generation services
version: 1.0.0
servers:
- url: https://www.jimmyai.cn
description: Production server
security:
- bearerAuth: []
paths:
/api/open-api/v1/seedance/videos:
post:
summary: Create Seedance Video Task
description: >-
Create a Seedance 2.0 video task. Routes: Full/Manxue (sd2_mx_*,
per-second, assets require audit), SP economy (seedance2.0-sp /
seedance2.0-fast-sp, per-second by resolution), SP official
(seedance2.0-of-sp / seedance2.0-of-fast-sp, per-second by resolution),
Mini (seedance2.0-mini, per-second by resolution), Mini Special
(seedance2.0-mini-sp, per-task, 480p/720p only), MD (seedance2.0-md /
seedance2.0-fast-md, per-task, 720p, no audio), Fast I2V
(seedance2.0-fast-i2v, per-task, 720p, image refs only, max 9, no
reference video/audio), STD standard (seedance2.0-std, per-task, 720p,
supports audio references). Poll GET /api/open-api/v1/videos/{taskId}
for results. See seedance/md/create, seedance/md/fast-i2v,
seedance/md/std, seedance/mini/create and seedance/mini-sp/create for
details.
operationId: createSeedanceVideo
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SeedanceGenerationRequest'
responses:
'200':
description: Task created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/VideoGenerationResponse'
components:
schemas:
SeedanceGenerationRequest:
type: object
required:
- model
- prompt
- duration
properties:
model:
type: string
description: >-
Model name. Manxue: sd2_mx_720p | sd2_mx_1080p | sd2_mx_2k |
sd2_mx_4k; Fast: sd2_mx_fast_720p | sd2_mx_fast_1080p; Video ref:
sd2_mx_video_720p | sd2_mx_video_1080p | sd2_mx_video_2k |
sd2_mx_video_4k; Video ref Fast: sd2_mx_video_fast_720p |
sd2_mx_video_fast_1080p (all per-second). reference_videos only for
video-series models. SP economy: seedance2.0-sp |
seedance2.0-fast-sp (per-second by resolution). SP official:
seedance2.0-of-sp | seedance2.0-of-fast-sp (per-second by
resolution). Mini: seedance2.0-mini (per-second by resolution). Mini
Special: seedance2.0-mini-sp (per-task, 480p/720p only). MD:
seedance2.0-md | seedance2.0-fast-md (per-task, 720p). Fast I2V:
seedance2.0-fast-i2v (per-task, 720p, image refs only). STD
standard: seedance2.0-std (per-task, 720p)
prompt:
type: string
description: 'Text prompt. MD route: max 5000 characters'
duration:
type: integer
description: >-
Duration in seconds. Full 4-12; SP economy 4-15; MD 1-15; STD
standard 4-15. Default 5
resolution:
type: string
enum:
- 480p
- 720p
- 1080p
description: Output resolution for SP economy. Default 720p
orientation:
type: string
enum:
- landscape
- portrait
description: Video orientation (ratio takes precedence if set)
images:
type: array
items:
type: string
description: >-
Reference images. Full route: asset://{assetId}; SP/MD/STD/Fast I2V:
https:// URL. MD max 4; seedance2.0-fast-i2v and STD max 9. Mutually
exclusive with first_image/last_image
ratio:
type: string
description: >-
Aspect ratio. MD: 16:9, 9:16, 1:1 only. STD: 21:9, 16:9, 4:3, 1:1,
3:4, 9:16. Full route also supports 4:3, 3:4, 21:9, Adaptive
first_image:
type: string
description: >-
First frame. Full: asset://{assetId}; Economy/MD: https:// URL. MD
frame mode requires last_image as well; first frame only is not
supported
last_image:
type: string
description: >-
Last frame. Full: asset://{assetId}; Economy/MD: https:// URL. MD
frame mode requires first_image as well
reference_videos:
type: array
items:
type: string
description: >-
Reference videos. Full: asset://{assetId}; Economy/MD: https:// URL.
MD: max 3, combined duration ≤15s, combined size ≤200MB, each
resolution 720px–2160px. Not supported on seedance2.0-fast-i2v
reference_audios:
type: array
items:
type: string
description: >-
Reference audio. Supported on Full, SP economy, and STD. Not
supported on MD or seedance2.0-fast-i2v. Full: asset://{assetId};
SP: https:// URL or asset://. STD max 3 clips; frame mode does not
support audio references
VideoGenerationResponse:
type: object
properties:
code:
type: string
example: '20000'
msg:
type: string
example: ok
data:
type: object
properties:
task_id:
type: string
status:
type: string
model:
type: string
created_at:
type: integer
format: int64
securitySchemes:
bearerAuth:
type: http
scheme: bearer
````