快速开始
接入火山兼容 API、OpenAI 兼容 API 与对应素材库接口
Video Gen API 提供火山兼容与 OpenAI 兼容两套接口栏目，每套栏目都包含视频生成和素材库接口。视频生成均使用 Bearer Token，并采用“创建任务、轮询状态、读取结果”的异步模式；素材库接口的认证方式以各自页面说明为准。
火山兼容 API
包含 Seedance 视频生成与 Action 风格素材库接口。
OpenAI 兼容 API
包含 OpenAI Videos 视频生成与素材库 REST 接口。
在线 API 调试
在接口页填写服务地址和 Token，直接构造并发送请求。
常见问答
官方链路核验、请求标识、分辨率与内容风控处理。
接入流程
1. 准备服务地址与 Token
火山兼容接口与 OpenAI 兼容接口共用 Base URL：https://jieyun.cc。接口路径已经包含 /api 或 /v1，不要重复添加路径；请求头使用 Authorization: Bearer $VIDEO_GEN_API_KEY。
2. 创建视频任务
根据参数体系选择 POST /v1/video/generations 或 POST /v1/videos，保存响应中的 id 或 task_id。
3. 轮询任务
建议每 3 到 5 秒查询一次。进入 completed、succeeded 或 failed 后停止轮询。
4. 获取结果
完成后读取 result_url 或 metadata.url。OpenAI 协议还可以调用 /v1/videos/{task_id}/content 获取视频内容。
选择哪套协议
| 场景 | 推荐协议 | 创建接口 |
|---|---|---|
| Seedance 参数、参考图/参考视频、分辨率与画幅比 | 火山兼容 API | POST /v1/video/generations |
| OpenAI Videos/Sora 客户端迁移 | OpenAI 兼容 API | POST /v1/videos |
| 基于已有视频继续生成 | OpenAI 兼容 API | POST /v1/videos/{video_id}/remix |
保护凭证
不要把 API Token 写入浏览器前端、公开仓库或截图。生产环境应从服务端环境变量读取。
最后更新于