使用 Bearer API Key 鉴权
所有对外 API 请求均需携带客户 API Key。请勿将 Key 暴露在浏览器或公开代码中。
Authorization: Bearer YOUR_API_KEY视频、素材和人物授权接口均使用同一客户 Key；Gateway 会在服务端替换为对应上游 Key。
SEEDANCE WORKSPACE视频生成
创建视频
提交文本或素材引用，任务与上游结果将保存到你的工作区。
任务预览
待提交✦
生成结果将在这里展示最近任务
正在加载任务...
视频任务
视频有效期为24小时，请尽快下载保存。
| 任务 | 模型 | 规格 | 状态 | 创建时间 | |
|---|---|---|---|---|---|
| 正在加载任务... | |||||
素材库
上传文件后自动创建素材记录，可直接作为视频任务参考素材。
上传素材
读取服务状态...素材组
用于归类素材正在加载素材...
人物授权
创建上游人物授权会话，发送 H5 链接给被授权人完成确认。
◉
暂未创建授权会话
创建会话后，授权链接和确认操作会显示在这里。
调用记录
仅展示当前 API Key 的最近调用、上游状态和耗时。
| 时间 | 接口 | 结果 | 上游状态 | 耗时 | Request ID |
|---|---|---|---|---|---|
| 正在加载调用记录... | |||||
API 文档
本工作台不暴露上游 Key；系统对外 API 仍使用分配给你的客户 API Key。
创建视频任务
POST /api/v3/contents/generations/tasks
{
"model": "doubao-seedance-2.0",
"content": [{ "type": "text", "text": "一只猫在窗边晒太阳" }],
"generate_audio": true,
"ratio": "16:9",
"duration": 5,
"watermark": false
}可在 content 中追加 asset://<asset_id> 作为图片、视频或音频参考素材。
查询任务状态
GET /api/v3/contents/generations/tasks/{task_id}?beta=true
{
"id": "task_xxx",
"status": "succeeded",
"content": { "video_url": "https://.../video.mp4" }
}生成中建议每 15 至 20 秒查询一次。任务完成后从 content.video_url 读取视频地址。
上传并创建素材
先创建素材组，然后上传文件并使用返回的 upload_id 创建素材记录。
POST /v1/materials/uploads
Content-Type: multipart/form-data
file=@./reference.png
asset_type=ImagePOST /v1/materials
{
"group_id": "group_xxx",
"asset_name": "reference.png",
"asset_type": "Image",
"upload_id": "upload_xxx"
}客户管理
创建客户时生成一个客户 API Key；视频和素材上游 Key 仅加密保存在服务端。
新建客户 Key
一次性展示✦
创建客户后显示可交付的 API Key-同一个 Key 可调用视频、素材和任务查询接口。
已配置客户
| 客户 | 视频上游 Key | 素材上游 Key | 状态 | 创建时间 |
|---|---|---|---|---|
| 正在加载客户... | ||||