Seedance 视频生成 API
高性能 AI 视频生成 API,支持文生视频、图生视频、视频续写、音频驱动等多模态输入组合。满血不排队,支持真人生成。
Base URL
https://ucar.wang
📌 鉴权方式:同汛沛API,HMAC-SHA256签名认证。请求头
X-Api-Key + X-Timestamp + X-Sign。⚠️ 素材库说明:支持真人生成,但视频/图片素材必须先上传至素材库才能使用。上传后获取
asset://<ID> 引用ID。模型列表
ant-2-text-2-video
标准文生视频,质量优先。支持纯文本/图片首尾帧/参考图/图片+音频。
ant-2-fast-text-2-video
快速文生视频,适合快速预览。不支持1080p。
ant-2-video-2-video
含参考视频时必须使用,支持全组合多模态输入(支持1080p)。
ant-2-fast-video-2-video
含视频快速版,缩短生成时间。
鉴权说明
| Header | 说明 |
|---|---|
| X-Api-Key | API密钥ID(ak-开头) |
| X-Timestamp | Unix时间戳秒,误差5分钟内 |
| X-Sign | HMAC-SHA256(api_key + timestamp, api_secret) |
| Content-Type | application/json(POST请求) |
创建视频生成任务
POST
/api/v1/sd?action=create
发起生成请求
| 字段 | 类型 | 说明 |
|---|---|---|
| model必填 | string | 模型ID,含视频必须选v2v |
| prompt必填 | string | 主提示词,有content也需非空 |
| metadata.ratio可选 | string | adaptive/16:9/4:3/1:1/3:4/9:16/21:9,默认16:9 |
| metadata.duration可选 | number | 4~15秒或-1智能,默认5 |
| metadata.resolution可选 | string | 480p/720p/1080p(仅标准V2V),默认720p |
| metadata.generate_audio可选 | boolean | 是否生成音频,默认true |
| metadata.watermark可选 | boolean | 是否加水印,默认true |
| metadata.content可选 | array | 多模态容器,元素定义见下 |
纯文本生成
curl https://ucar.wang/api/v1/sd?action=create \
-H "X-Api-Key: ak-your-key" \
-H "X-Timestamp: 1700000000" \
-H "X-Sign: your-hmac-signature" \
-H "Content-Type: application/json" \
-d '{
"model": "ant-2-text-2-video",
"prompt": "一只猫咪在草地上奔跑,阳光明媚,电影级质感",
"metadata": {
"ratio": "16:9",
"duration": 5,
"resolution": "720p",
"generate_audio": true,
"watermark": false
}
}'
查询任务状态
GET
/api/v1/sd?action=task&task_id={task_id}
查询进度
状态流转:queued(解析中)→ in_progress(生成中)→ completed(已完成)/ failed(失败)。推荐轮询间隔5秒。
素材库 API
POST
/api/v1/files
上传素材
提供公网URL让系统拉取入库。上传后返回 asset://ID 引用。
| 参数 | 类型 | 说明 |
|---|---|---|
| url必填 | url | 素材公网URL |
| asset_type必填 | string | Image/Video/Audio |
| filename可选 | string | 文件名 |
GET
/api/v1/files/{file_id}
查询素材
通过file_id查询素材的状态和处理进度。
GET
/api/v1/files
素材列表
分页查询已上传的所有素材。
DELETE
/api/v1/files/{file_id}
删除素材
删除不再使用的素材文件。
错误码
| 状态码 | 含义 |
|---|---|
| 401 | 认证失败 |
| 400 | 参数错误 |
| 429 | 调用超限 |
| 500 | 服务内部错误 |