Seedance 接口调用说明

生产地址：https://example.ai
实测模型：dreamina-seedance-2-0-260128（以令牌实际可用模型为准）

📌

HTTP
Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json

创建任务

💡

HTTP
POST /api/v3/contents/generations/tasks

必填：model、content。

💡

JSON
{
"model": "dreamina-seedance-2-0-260128",
"content": [
{ "type": "text", "text": "一只橘猫在窗边晒太阳，镜头缓慢推进" }
],
"resolution": "480p",
"ratio": "16:9",
"duration": 4,
"generate_audio": false,
"watermark": false
}

成功：

📌

JSON
{
"id": "task_Nn57pCILIrC5HHZ6fCkUuJ41NQE1qr6Y"
}

请求参数

参数	类型	必填	说明
model	string	是	控制台里的模型名
content	array	是	文本 / 图 / 视频 / 音频，见下一节
resolution	string	否	480p / 720p / 1080p / 4k。2.0 Fast 通常只有 480p、720p
ratio	string	否	16:9 9:16 1:1 4:3 3:4 21:9 adaptive。首尾帧建议 adaptive
duration	int	否	输出时长（秒）。1.0：2–12；1.5：4–12；2.0：4–15
generate_audio	bool	否	是否生成有声视频
watermark	bool	否	是否加水印
camera_fixed	bool	否	固定镜头。1.5 支持；2.0 不支持 frames / seed
seed	int	否	随机种子。1.0 / 1.5 可用
return_last_frame	bool	否	完成后是否返回尾帧
callback_url	string	否	任务完成回调地址
service_tier	string	否	服务档位
priority	int	否	优先级
draft	bool	否	样片模式
tools	array	否	工具配置
execution_expires_after	int	否	任务过期秒数
frames	int	否	帧数。2.0 不支持

📌

resolution / ratio / duration / seed / camera_fixed / watermark 也可以写在提示词末尾，例如 --rs 720p --rt 16:9 --dur 5。推荐直接放在 JSON 里。

content[ ]

type	结构	role	用途
text	{ "type": "text", "text": "..." }	—	提示词
image_url	{ "type": "image_url", "image_url": { "url": "..." }, "role": "..." }	first_frame / last_frame / reference_image	图
video_url	{ "type": "video_url", "video_url": { "url": "..." }, "role": "reference_video" }	reference_video	参考视频
audio_url	{ "type": "audio_url", "audio_url": { "url": "..." } }	—	参考音频

📌

url 可以是公网 https://...，或 Base64：data:image/png;base64,...。大文件请用公网 URL。

📌

三种图生场景互斥，不要混用：

图生视频-首帧：1 张图，role 为 first_frame 或不填
图生视频-首尾帧：2 张图，必须分别标 first_frame / last_frame
全模态参考：图 / 视频 / 音频的 role 用 reference_image / reference_video
2.0 不可单独只传音频，至少还要有一张图或一段视频。

查询任务

📌

HTTP
GET /api/v3/contents/generations/tasks/{id}

💡

JSON
{
"id": "task_Nn57pCILIrC5HHZ6fCkUuJ41NQE1qr6Y",
"model": "dreamina-seedance-2-0-260128",
"status": "running",
"resolution": "480p",
"duration": 4,
"ratio": "16:9"
}

status	含义
queued	排队
running	进行中
succeeded	成功
failed	失败
cancelled	取消

完成后成片在 content.video_url。失败时带 error.message。

列出任务

📌

HTTP
GET /api/v3/contents/generations/tasks?page_num=1&page_size=20

参数	默认	说明
参数	默认	说明
page_num	1	页码，最大 500
page_size	20	每页条数，最大 500
filter.status	—	queued / running / succeeded / failed / cancelled
filter.model	—	按模型名过滤
filter.service_tier	—	按档位过滤
filter.task_ids	—	多个 ID，逗号分隔或重复传参

只返回当前账号近 7 天的任务。

📌

JSON
{
"items": [ { "id": "task_xxxxxxxx", "status": "running" } ],
"total": 1
}

curl

📌

BASH

BASE=https://91model.ai
KEY=sk-xxxxxxxx

#创建
curl -sS "KEY"
-H "Content-Type: application/json"
-d '{
"model": "dreamina-seedance-2-0-260128",
"content": [
{ "type": "text", "text": "一只橘猫在窗边晒太阳，镜头缓慢推进" }
],
"resolution": "480p",
"ratio": "16:9",
"duration": 4,
"generate_audio": false,
"watermark": false
}'

#查询
curl -sS "KEY"

Seedance 视频生成 API 调用文档（火山官方Seedance 原生格式）

Seedance 接口调用说明#

创建任务#

请求参数#

content[ ]#

查询任务#

列出任务#