OpenAI 兼容 API 概览
使用 OpenAI Videos 和 Video Studio 素材库完成 Seedance 2.0 工作流
OpenAI 兼容栏目包含四个 /v1/videos 视频接口和十一个 /api/video-studio/assets/ecloud/* 素材库接口。两组接口使用同一个 NewAPI Bearer API Key，可以完成素材上传、状态轮询、视频生成、Remix 和结果下载。
服务地址与认证
服务地址为 https://jieyun.cc。所有请求使用 Authorization: Bearer <API_KEY>。素材空间按 API Key 隔离，素材创建和视频生成应使用同一把 Key。
视频接口
| 方法 | 路径 | 说明 |
|---|---|---|
POST | /v1/videos | 创建 Seedance 2.0 视频任务 |
GET | /v1/videos/{task_id} | 查询任务状态和结果 |
POST | /v1/videos/{video_id}/remix | 基于已有任务创建 Remix 任务 |
GET | /v1/videos/{task_id}/content | 下载或代理读取已完成视频 |
素材库接口
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/video-studio/assets/ecloud | 列出当前 API Key 的素材组 |
POST | /api/video-studio/assets/ecloud/upload-and-save | 上传文件并创建素材组 |
GET | /api/video-studio/assets/ecloud/{groupId} | 查询素材组和组内素材 |
PATCH | /api/video-studio/assets/ecloud/{groupId} | 修改素材组名称和封面 |
DELETE | /api/video-studio/assets/ecloud/{groupId} | 删除素材组 |
POST | /api/video-studio/assets/ecloud/{groupId}/upload-and-save | 向素材组追加文件 |
DELETE | /api/video-studio/assets/ecloud/{groupId}/assets/{assetId} | 删除组内素材 |
POST | /api/video-studio/assets/ecloud/import-url | 导入单个 URL 或 base64 图片 |
POST | /api/video-studio/assets/ecloud/import-urls | 批量导入 URL，最多 50 条 |
POST | /api/video-studio/assets/ecloud/liveness/sessions | 创建真人素材授权会话 |
POST | /api/video-studio/assets/ecloud/liveness/groups/sync | 同步真人素材组 |
素材库使用统一的 data/error/request_id 响应包装，视频接口使用 OpenAI 风格的视频对象。完整字段和限制见 Video Studio 素材库概览。
支持模型
| 模型 | 分辨率 | 说明 |
|---|---|---|
doubao-seedance-2-0-260128 | 480p、720p、1080p | 标准模型 |
doubao-seedance-2-0-fast-260128 | 480p、720p | Fast 模型，不支持 1080p |
未填写 resolution 时，Seedance 2.0 的计费和场景选择默认按 720p 处理。
创建要求
POST /v1/videos仅接受application/json，不接受 multipart 文件字段。model和非空prompt必填。- 图片、视频和音频必须通过服务端可访问的 HTTP/HTTPS URL 引用。
- 顶层字段使用严格白名单；
content、priority、input_reference等不支持字段会返回unsupported_field。 - 创建请求通常返回
200；网关已接收但仍需异步确认时可能返回202。
最小请求
curl -X POST "https://jieyun.cc/v1/videos" \
-H "Authorization: Bearer $VIDEO_GEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-260128",
"prompt": "雨后的未来城市，镜头缓慢向前推进",
"seconds": "8",
"resolution": "720p",
"ratio": "16:9"
}'创建成功后保存响应中的 id。id 与兼容字段 task_id 相同，不会暴露上游真实任务 ID。
任务状态
| status | 说明 |
|---|---|
queued | 已排队 |
in_progress | 生成中 |
completed | 已完成 |
failed | 失败 |
unknown | 未知状态 |
completed 和 failed 是终态。建议从 2 秒轮询间隔开始，并逐步增加到 5-10 秒。成功后读取 result_url 或 metadata.url，也可以调用内容接口下载视频。
素材接入流程
- 使用素材库创建或导入参考素材。
- 轮询素材状态，等待其变为
Active。 - 读取可访问的素材 URL。
- 将图片 URL 放入
image、images，或将多模态 URL 放入metadata.content。 - 创建视频任务并保存公开任务
id。 - 轮询
/v1/videos/{task_id}，完成后读取结果或下载内容。
素材上传、URL 导入和真人素材接入详见 Video Studio 素材库概览。
最后更新于