seedance1.5-api

Name: seedance1.5-api
Author: algoderiv

58stars3forks

How to install seedance1.5-api?

algoderiv/agent-skills/seedance1.5-api

$npx -y skills add algoderiv/agent-skills --skill seedance1.5-api

Installs into the current project.

Summary

Seedance 1.5/1.0 系列视频生成 API 文档（火山方舟平台）。用于通过 API 调用 Seedance 模型实现文生视频、图生视频（首帧/首尾帧/参考图）、有声视频生成等功能，包含完整的请求参数、SDK 示例、提示词技巧和错误码参考。

Files · 1

View on GitHub

SKILL.md

1	# Seedance 1.5 API Skill
2
3	Seedance 是字节跳动豆包大模型团队推出的视频生成基础模型系列，通过火山方舟（Volcano Ark）平台提供 API 服务。本技能涵盖 Seedance 1.5 pro、1.0 pro、1.0 pro fast、1.0 lite 全系列模型的视频生成 API 使用方法。
4
5	> 注意: Seedance 2.0 目前仅支持控制台体验中心体验，暂不支持 API 调用。
6
7	## When to Use This Skill
8
9	This skill should be triggered when:
10	- 调用 Seedance API 生成视频（文生视频、图生视频）
11	- 使用火山方舟平台的视频生成 API
12	- 需要了解 Seedance 模型的参数配置（分辨率、宽高比、时长等）
13	- 编写 Seedance 视频生成的提示词（prompt）
14	- 使用 Python/Go/Java SDK 调用 Seedance
15	- 处理视频生成任务的创建、查询、取消
16	- 调试 Seedance API 的错误码
17
18	## Quick Reference
19
20	### API Base URL
21
22	```
23	https://ark.cn-beijing.volces.com/api/v3
24	```
25
26	### 鉴权方式
27
28	```bash
29	Authorization: Bearer $ARK_API_KEY
30	```
31
32	### 模型 ID 列表
33
34	\| 模型 \| Model ID \| 能力 \|
35	\|------\|----------\|------\|
36	\| Seedance 1.5 pro \| `doubao-seedance-1-5-pro-251215` \| 文生视频、首帧图生视频、首尾帧图生视频、有声视频、样片模式 \|
37	\| Seedance 1.0 pro \| `doubao-seedance-1-0-pro-250528` \| 文生视频、首帧图生视频、首尾帧图生视频 \|
38	\| Seedance 1.0 pro fast \| `doubao-seedance-1-0-pro-fast-250528` \| 文生视频、首帧图生视频 \|
39	\| Seedance 1.0 lite t2v \| `doubao-seedance-1-0-lite-t2v` \| 文生视频 \|
40	\| Seedance 1.0 lite i2v \| `doubao-seedance-1-0-lite-i2v` \| 首帧/首尾帧/参考图(1-4张)图生视频 \|
41
42	### 核心 API 端点
43
44	\| 操作 \| 方法 \| 端点 \|
45	\|------\|------\|------\|
46	\| 创建视频生成任务 \| `POST` \| `/contents/generations/tasks` \|
47	\| 查询视频生成任务 \| `GET` \| `/contents/generations/tasks/{id}` \|
48	\| 查询任务列表 \| `GET` \| `/contents/generations/tasks?page_num=&page_size=&filter.status=` \|
49	\| 取消/删除任务 \| `DELETE` \| `/contents/generations/tasks/{id}` \|
50
51	### 快速开始 - 文生视频（curl）
52
53	```bash
54	curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
55	-H "Content-Type: application/json" \
56	-H "Authorization: Bearer $ARK_API_KEY" \
57	-d '{
58	"model": "doubao-seedance-1-5-pro-251215",
59	"content": [
60	{
61	"type": "text",
62	"text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
63	}
64	],
65	"ratio": "16:9",
66	"duration": 5,
67	"resolution": "720p",
68	"watermark": false
69	}'
70	```
71
72	### 快速开始 - 图生视频（首帧）
73
74	```bash
75	curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
76	-H "Content-Type: application/json" \
77	-H "Authorization: Bearer $ARK_API_KEY" \
78	-d '{
79	"model": "doubao-seedance-1-5-pro-251215",
80	"content": [
81	{"type": "text", "text": "老人缓缓戴上眼镜，微笑"},
82	{
83	"type": "image_url",
84	"image_url": {"url": "https://example.com/image.jpg"},
85	"role": "first_frame"
86	}
87	],
88	"ratio": "16:9",
89	"duration": 5
90	}'
91	```
92
93	### 快速开始 - 有声视频（Seedance 1.5 pro）
94
95	```bash
96	curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
97	-H "Content-Type: application/json" \
98	-H "Authorization: Bearer $ARK_API_KEY" \
99	-d '{
100	"model": "doubao-seedance-1-5-pro-251215",
101	"content": [
102	{
103	"type": "text",
104	"text": "男人叫住女人说：\"你记住，以后不可以用手指指月亮。\""
105	}
106	],
107	"generate_audio": true,
108	"ratio": "16:9",
109	"duration": 5
110	}'
111	```
112
113	### 查询任务状态
114
115	```bash
116	curl -X GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/cgt-2025xxxx \
117	-H "Content-Type: application/json" \
118	-H "Authorization: Bearer $ARK_API_KEY"
119	```
120
121	### Python SDK 示例
122
123	```python
124	import os
125	from volcenginesdkarkruntime import Ark
126
127	client = Ark(
128	api_key=os.environ.get("ARK_API_KEY"),
129	base_url="https://ark.cn-beijing.volces.com/api/v3",
130	timeout=1800,
131	)
132
133	# 创建文生视频任务
134	task = client.content.generations.tasks.create(
135	model="doubao-seedance-1-5-pro-251215",
136	content=[{"type": "text", "text": "一只小猫对着镜头打哈欠"}],
137	ratio="16:9",
138	duration=5,
139	)
140	print(f"Task ID: {task.id}")
141
142	# 查询任务状态
143	result = client.content.generations.tasks.get(task.id)
144	print(f"Status: {result.status}")
145	if result.status == "succeeded":
146	print(f"Video URL: {result.content.video_url}")
147	```
148
149	### 视频参数速查
150
151	\| 参数 \| 取值 \| 默认值 \| 说明 \|
152	\|------\|------\|--------\|------\|
153	\| `resolution` \| `480p` / `720p` / `1080p` \| 1.5pro/lite: `720p`, 1.0pro: `1080p` \| 分辨率 \|
154	\| `ratio` \| `16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive` \| 文生: `16:9`, 图生: `adaptive` \| 宽高比 \|
155	\| `duration` \| 2~12 秒（1.5pro 支持 -1 自动） \| `5` \| 视频时长 \|
156	\| `seed` \| -1 ~ 2^32-1 \| `-1` (随机) \| 随机种子 \|
157	\| `camera_fixed` \| `true` / `false` \| `false` \| 固定摄像头 \|
158	\| `watermark` \| `true` / `false` \| `false` \| 水印 \|
159	\| `generate_audio` \| `true` / `false` \| `true` \| 有声视频(仅1.5pro) \|
160	\| `draft` \| `true` / `false` \| `false` \| 样片模式(仅1.5pro) \|
161	\| `service_tier` \| `default` / `flex` \| `default` \| flex为离线模式,半价 \|
162
163	## References
164
165	- `api-create-task.md` - 创建视频生成任务 API 完整参数说明
166	- `api-query-task.md` - 查询视频生成任务 API
167	- `api-query-task-list.md` - 查询视频生成任务列表 API
168	- `api-cancel-delete-task.md` - 取消或删除视频生成任务 API
169	- `authentication.md` - Base URL、鉴权方式和 API Key 配置
170	- `sdk-examples.md` - Python/Go/Java SDK 使用示例
171	- `openai-sdk-compat.md` - 兼容 OpenAI SDK 调用方式
172	- `prompt-guide.md` - Seedance 提示词使用技巧
173	- `error-codes.md` - 错误码参考

People who liked this also viewed

6 picks

Type

seedance1.5-api

58stars3forks

View on GitHub

How to install seedance1.5-api?

algoderiv/agent-skills/seedance1.5-api

$npx -y skills add algoderiv/agent-skills --skill seedance1.5-api

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Seedance 1.5 API Skill
2
3	Seedance 是字节跳动豆包大模型团队推出的视频生成基础模型系列，通过火山方舟（Volcano Ark）平台提供 API 服务。本技能涵盖 Seedance 1.5 pro、1.0 pro、1.0 pro fast、1.0 lite 全系列模型的视频生成 API 使用方法。
4
5	> 注意: Seedance 2.0 目前仅支持控制台体验中心体验，暂不支持 API 调用。
6
7	## When to Use This Skill
8
9	This skill should be triggered when:
10	- 调用 Seedance API 生成视频（文生视频、图生视频）
11	- 使用火山方舟平台的视频生成 API
12	- 需要了解 Seedance 模型的参数配置（分辨率、宽高比、时长等）
13	- 编写 Seedance 视频生成的提示词（prompt）
14	- 使用 Python/Go/Java SDK 调用 Seedance
15	- 处理视频生成任务的创建、查询、取消
16	- 调试 Seedance API 的错误码
17
18	## Quick Reference
19
20	### API Base URL
21
22	```
23	https://ark.cn-beijing.volces.com/api/v3
24	```
25
26	### 鉴权方式
27
28	```bash
29	Authorization: Bearer $ARK_API_KEY
30	```
31
32	### 模型 ID 列表
33
34	\| 模型 \| Model ID \| 能力 \|
35	\|------\|----------\|------\|
36	\| Seedance 1.5 pro \| `doubao-seedance-1-5-pro-251215` \| 文生视频、首帧图生视频、首尾帧图生视频、有声视频、样片模式 \|
37	\| Seedance 1.0 pro \| `doubao-seedance-1-0-pro-250528` \| 文生视频、首帧图生视频、首尾帧图生视频 \|
38	\| Seedance 1.0 pro fast \| `doubao-seedance-1-0-pro-fast-250528` \| 文生视频、首帧图生视频 \|
39	\| Seedance 1.0 lite t2v \| `doubao-seedance-1-0-lite-t2v` \| 文生视频 \|
40	\| Seedance 1.0 lite i2v \| `doubao-seedance-1-0-lite-i2v` \| 首帧/首尾帧/参考图(1-4张)图生视频 \|
41
42	### 核心 API 端点
43
44	\| 操作 \| 方法 \| 端点 \|
45	\|------\|------\|------\|
46	\| 创建视频生成任务 \| `POST` \| `/contents/generations/tasks` \|
47	\| 查询视频生成任务 \| `GET` \| `/contents/generations/tasks/{id}` \|
48	\| 查询任务列表 \| `GET` \| `/contents/generations/tasks?page_num=&page_size=&filter.status=` \|
49	\| 取消/删除任务 \| `DELETE` \| `/contents/generations/tasks/{id}` \|
50
51	### 快速开始 - 文生视频（curl）
52
53	```bash
54	curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
55	-H "Content-Type: application/json" \
56	-H "Authorization: Bearer $ARK_API_KEY" \
57	-d '{
58	"model": "doubao-seedance-1-5-pro-251215",
59	"content": [
60	{
61	"type": "text",
62	"text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
63	}
64	],
65	"ratio": "16:9",
66	"duration": 5,
67	"resolution": "720p",
68	"watermark": false
69	}'
70	```
71
72	### 快速开始 - 图生视频（首帧）
73
74	```bash
75	curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
76	-H "Content-Type: application/json" \
77	-H "Authorization: Bearer $ARK_API_KEY" \
78	-d '{
79	"model": "doubao-seedance-1-5-pro-251215",
80	"content": [
81	{"type": "text", "text": "老人缓缓戴上眼镜，微笑"},
82	{
83	"type": "image_url",
84	"image_url": {"url": "https://example.com/image.jpg"},
85	"role": "first_frame"
86	}
87	],
88	"ratio": "16:9",
89	"duration": 5
90	}'
91	```
92
93	### 快速开始 - 有声视频（Seedance 1.5 pro）
94
95	```bash
96	curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
97	-H "Content-Type: application/json" \
98	-H "Authorization: Bearer $ARK_API_KEY" \
99	-d '{
100	"model": "doubao-seedance-1-5-pro-251215",
101	"content": [
102	{
103	"type": "text",
104	"text": "男人叫住女人说：\"你记住，以后不可以用手指指月亮。\""
105	}
106	],
107	"generate_audio": true,
108	"ratio": "16:9",
109	"duration": 5
110	}'
111	```
112
113	### 查询任务状态
114
115	```bash
116	curl -X GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/cgt-2025xxxx \
117	-H "Content-Type: application/json" \
118	-H "Authorization: Bearer $ARK_API_KEY"
119	```
120
121	### Python SDK 示例
122
123	```python
124	import os
125	from volcenginesdkarkruntime import Ark
126
127	client = Ark(
128	api_key=os.environ.get("ARK_API_KEY"),
129	base_url="https://ark.cn-beijing.volces.com/api/v3",
130	timeout=1800,
131	)
132
133	# 创建文生视频任务
134	task = client.content.generations.tasks.create(
135	model="doubao-seedance-1-5-pro-251215",
136	content=[{"type": "text", "text": "一只小猫对着镜头打哈欠"}],
137	ratio="16:9",
138	duration=5,
139	)
140	print(f"Task ID: {task.id}")
141
142	# 查询任务状态
143	result = client.content.generations.tasks.get(task.id)
144	print(f"Status: {result.status}")
145	if result.status == "succeeded":
146	print(f"Video URL: {result.content.video_url}")
147	```
148
149	### 视频参数速查
150
151	\| 参数 \| 取值 \| 默认值 \| 说明 \|
152	\|------\|------\|--------\|------\|
153	\| `resolution` \| `480p` / `720p` / `1080p` \| 1.5pro/lite: `720p`, 1.0pro: `1080p` \| 分辨率 \|
154	\| `ratio` \| `16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive` \| 文生: `16:9`, 图生: `adaptive` \| 宽高比 \|
155	\| `duration` \| 2~12 秒（1.5pro 支持 -1 自动） \| `5` \| 视频时长 \|
156	\| `seed` \| -1 ~ 2^32-1 \| `-1` (随机) \| 随机种子 \|
157	\| `camera_fixed` \| `true` / `false` \| `false` \| 固定摄像头 \|
158	\| `watermark` \| `true` / `false` \| `false` \| 水印 \|
159	\| `generate_audio` \| `true` / `false` \| `true` \| 有声视频(仅1.5pro) \|
160	\| `draft` \| `true` / `false` \| `false` \| 样片模式(仅1.5pro) \|
161	\| `service_tier` \| `default` / `flex` \| `default` \| flex为离线模式,半价 \|
162
163	## References
164
165	- `api-create-task.md` - 创建视频生成任务 API 完整参数说明
166	- `api-query-task.md` - 查询视频生成任务 API
167	- `api-query-task-list.md` - 查询视频生成任务列表 API
168	- `api-cancel-delete-task.md` - 取消或删除视频生成任务 API
169	- `authentication.md` - Base URL、鉴权方式和 API Key 配置
170	- `sdk-examples.md` - Python/Go/Java SDK 使用示例
171	- `openai-sdk-compat.md` - 兼容 OpenAI SDK 调用方式
172	- `prompt-guide.md` - Seedance 提示词使用技巧
173	- `error-codes.md` - 错误码参考

People who liked this also viewed

6 picks

Type