POST
OpenAI 视频接口

简介

OpenAI 视频接口与 OpenAI 官方 /v1/videos API 对齐,返回标准的视频对象(object: "video")格式,适合已经接入 OpenAI Videos API 的客户端。当前主要面向 Sora 2 系列模型,并支持 Remix(基于已有视频重新生成)。 服务端同时提供查询、Remix 与内容代理接口:

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

提交任务

POST https://api.gzyzhuai.com/v1/videos 支持 application/jsonmultipart/form-data 两种请求体。JSON 方式:
图生视频可传图片:

请求参数

string
必填
模型标识,如 sora-2
string
视频生成提示词,描述画面动作与场景
string
默认值:"\"4\""
时长(秒),Sora 2 支持 4812
string
默认值:"720x1280"
分辨率:720x1280(竖屏)、1280x720(横屏)
string
参考图片(URL 或 Base64),用于图生视频;multipart 上传时字段名也是 input_reference

提交响应

提交成功后返回视频对象,结构如下:

Remix

基于已有视频重新生成,可作为”视频生视频”使用:
参数与提交接口一致(prompt 必填),响应同样是视频任务对象,成功后的查询结果里会带 remixed_from_video_id

查询任务

GET /v1/videos/{task_id}
响应结构与上面提交响应相同(object: "video"),status 取值: 轮询建议:每 5 秒一次,直到 completedfailed

获取视频

视频内容通过 GET /v1/videos/{task_id}/content 获取,返回视频文件本体(video/mp4),详见 视频内容获取

相关接口

视频内容获取

GET /v1/videos/{task_id}/content 获取视频文件

视频生成总览

异步流程与入口选择