POST
统一视频接口

简介

统一视频接口是 yunzhuai 提供的多模型视频生成入口,通过 POST /v1/video/generations 提交任务、GET /v1/video/generations/{task_id} 查询状态。Sora 2、Veo、阿里万相、豆包 Seedance 1.x 等模型都可以通过此入口调用。 重要提示:视频生成是异步任务,提交后需要轮询查询接口直到状态变为 succeededfailed
更推荐按模型协议族选择入口(如 Seedance 2.0 走Seedance 官方接口),详见 视频生成总览

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

提交视频任务

POST https://api.gzyzhuai.com/v1/video/generations

请求参数

string
必填
模型标识,支持的模型及功能如下:Sora 2 系列sora-2 - 文生视频、图生视频、视频生视频(Remix) 谷歌 Veo 系列veo-3.0-fast-generate-001veo-3.0-generate-previewveo-3.1-fast-generate-previewveo-3.1-generate-preview 阿里万相系列wan2.5-t2v-preview(文生)、wan2.5-i2v-preview(图生,首帧) 豆包 Seedance 系列doubao-seedance-1-0-lite-t2v-250428doubao-seedance-1-0-lite-i2v-250428doubao-seedance-1-0-pro-250528doubao-seedance-1-5-pro-251215doubao-seedance-1-5-pro-251215-noAudio
string
视频生成提示词。注意:豆包 Seedance 系列模型不需要此字段,提示词直接写在 metadata.content 数组的 text 字段中
string
图生视频时的参考图片(支持 URL 或 Base64)
array
多张参考图片(URL 或 Base64 数组),部分模型用于首尾帧/多参考图场景
string
视频尺寸,不同模型格式不同(如 720x12801280x7201920*1080
integer
默认值:"5"
视频时长(秒),不同模型支持范围不同
string|integer
视频时长(秒)的另一种写法,Sora 2 使用(如 "4""8"
object
渠道/模型透传参数(如参考图列表、负向提示词、外部任务 ID 等),部分模型通过 metadata.content 传入多媒体内容(见下方模型专用参数)

模型专用参数

不同模型使用不同的专用参数,按模型系列分类说明:
string|integer
默认值:"4"
视频时长(秒),支持:4812
string
默认值:"720x1280"
视频分辨率,支持:720x1280(竖屏)、1280x720(横屏)
string
参考图片(URL 或 Base64),用于图生视频;也可以通过 multipart/form-data 上传,字段名同为 input_reference

提交示例

文生视频
图生视频(首帧)

提交响应

提交成功会返回任务 ID 及初始状态(字段随渠道略有差异):

查询视频任务

GET {{base_url}}/v1/video/generations/{task_id} 根据任务 ID 查询任务状态与结果。
string
必填
由提交任务接口返回的任务 ID

使用示例

任务状态

完成时的响应示例

响应里会伴随 task_idstatusformaturl(成功时)等字段;不同渠道可能附带额外字段,请以 status 为准。

失败时响应示例

轮询示例

建议每 5 秒轮询一次,成功或失败即停止:

相关接口

视频生成总览

异步流程、入口选择与状态对照

视频内容获取

通过 GET /v1/videos/{task_id}/content 获取视频文件本体