OpenAI 兼容 API 概览

OpenAI 兼容栏目包含五个 /v1/videos 视频接口和十一个 /api/video-studio/assets/ecloud/* 素材库接口。两组接口使用同一个 NewAPI Bearer API Key，可以完成素材上传、状态轮询、视频生成、取消和结果下载。

服务地址与认证

服务地址为 https://jieyun.cc。所有请求使用 Authorization: Bearer <API_KEY>。素材空间按 API Key 隔离，素材创建和视频生成应使用同一把 Key。

视频接口

方法	路径	说明
`POST`	`/v1/videos`	创建 Seedance 2.0 视频任务
`GET`	`/v1/videos/{task_id}`	查询任务状态和结果
`DELETE`	`/v1/videos/{task_id}`	取消排队中的视频任务
`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`	失败
`cancelled`	已取消
`unknown`	未知状态

completed、failed 和 cancelled 是终态。建议从 2 秒轮询间隔开始，并逐步增加到 5-10 秒。成功后读取 result_url 或 metadata.url，也可以调用内容接口下载视频。

仅 queued 任务可以使用 DELETE /v1/videos/{task_id} 取消。取消成功返回状态为 cancelled 的视频对象；运行中或终态任务不会被删除。

错误码

请求校验失败时，接口使用顶层 error 对象返回错误码和消息。视频任务也可能在创建成功后异步失败，因此客户端必须同时检查 HTTP 状态和任务对象的 status。

完整错误码、错误响应结构和异步任务失败示例见错误码。

素材接入流程

使用素材库创建或导入参考素材。
轮询素材状态，等待其变为 Active。
读取可访问的素材 URL。
将图片 URL 放入 image、images，或将多模态 URL 放入 metadata.content。
创建视频任务并保存公开任务 id。
轮询 /v1/videos/{task_id}，完成后读取结果或下载内容。

素材上传、URL 导入和真人素材接入详见 Video Studio 素材库概览。

目录