模型接口API文档
视频模型
Doubao Seedance 创建任务、查询任务、素材库和内容获取接口
视频模型主要收录 Doubao Seedance 2.0 相关接口。这里作为总览入口，完整的请求参数、响应结构和调试面板请进入下方单独接口页查看。
视频任务
创建视频生成任务
提交统一任务风格的视频生成请求。
查询视频生成任务
查询统一任务风格的视频任务状态。
OpenAI 风格创建视频任务
兼容 OpenAI/Sora 风格的视频创建入口。
查询 OpenAI 风格视频任务
查询通过 OpenAI 风格入口提交的任务。
基于已有视频重混
基于已有视频或任务结果创建重混任务。
代理获取视频内容
通过网关代理获取生成后的视频内容。
素材库
上传素材并创建素材组
上传素材文件并创建新的素材组。
追加上传到已有素材组
向已有素材组追加上传素材文件。
获取当前用户素材组列表
查询当前用户拥有的素材组。
获取素材组详情
查询指定素材组和组内素材。
修改素材组名称或封面
更新素材组展示名称或封面。
删除素材组
删除素材组并软删除本地归属关系。
删除素材组内单个素材
删除某个素材组里的单个素材。
导入单个公网素材 URL
把单个公网 URL 登记进素材库。
批量导入公网素材 URL
批量导入公网图片、视频或音频 URL。
任务流程
- 使用
POST /v1/video/generations或POST /v1/videos创建任务。 - 保存返回的任务 ID。
- 使用对应查询接口轮询任务状态。
- 任务完成后，通过结果字段或
/v1/videos/{task_id}/content获取视频内容。 - 如需续写、风格变换或重编辑，可使用
/v1/videos/{video_id}/remix。
素材库流程
- 使用
POST /v1/api/video-studio/assets/ecloud/upload-and-save上传文件并创建素材组，或使用导入 URL 接口创建素材组。 - 保存返回的
groupId和素材assetId。 - 后续追加上传、查询详情、修改、删除都会先校验
groupId是否属于当前 Token 对应用户。 - 当前 Token 所属分组下需要存在已配置
video_studio_asset_base_url的可用渠道。
模型选择
| 模型 ID | 适用场景 |
|---|---|
doubao-seedance-2-0-260128 | 标准视频生成任务。 |
doubao-seedance-2-0-fast-260128 | Fast 视频生成任务，速度取向以模型名称和页面展示为准。 |
接口路径
| 方法 | 路径 | 页面 |
|---|---|---|
| POST | /v1/video/generations | 创建视频生成任务 |
| GET | /v1/video/generations/{task_id} | 查询视频生成任务 |
| POST | /v1/videos | OpenAI 风格创建视频任务 |
| GET | /v1/videos/{task_id} | 查询 OpenAI 风格视频任务 |
| POST | /v1/videos/{video_id}/remix | 基于已有视频重混 |
| GET | /v1/videos/{task_id}/content | 代理获取视频内容 |
| POST | /v1/api/video-studio/assets/ecloud/upload-and-save | 上传素材并创建素材组 |
| POST | /v1/api/video-studio/assets/ecloud/{groupId}/upload-and-save | 追加上传到已有素材组 |
| GET | /v1/api/video-studio/assets/ecloud | 获取当前用户素材组列表 |
| GET | /v1/api/video-studio/assets/ecloud/{groupId} | 获取素材组详情 |
| PATCH | /v1/api/video-studio/assets/ecloud/{groupId} | 修改素材组名称或封面 |
| DELETE | /v1/api/video-studio/assets/ecloud/{groupId} | 删除素材组 |
| DELETE | /v1/api/video-studio/assets/ecloud/{groupId}/assets/{assetId} | 删除素材组内单个素材 |
| POST | /v1/api/video-studio/assets/ecloud/import-url | 导入单个公网素材 URL |
| POST | /v1/api/video-studio/assets/ecloud/import-urls | 批量导入公网素材 URL |
最后更新于