Sora-2

视频模型，此接口与submit调用方式不同，与openai 官方接口调用方式一致，模型功能无差异。

异步提交任务

接口

https://api.modelverse.cn/v1/videos

输入

参数	类型	是否必选	描述
model	string	是	模型名称，此处为 sora-2
prompt	string	是	提示词，用于指导视频生成
size	string	否	生成视频的尺寸。 可选的分辨率： - 720x1280 - 1280x720
duration	string	否	视频生成时长（秒），可选值 4, 8, 12
input_reference	string	否	首帧图

请求示例

⚠️ 如果您使用 Windows 系统，建议使用 Postman 或其他 API 调用工具。

curl -X POST "https://api.modelverse.cn/v1/videos" \
 -H "Authorization: Bearer $OPENAI_API_KEY" \
 -H "Content-Type: multipart/form-data" \
 -F prompt="She turns around and smiles, then slowly walks out of the frame." \
 -F model="sora-2" \
 -F size="1280x720" \
 -F seconds="8" \
 -F input_reference="@sample_720p.jpeg;type=image/jpeg"

输出

参数	类型	描述
id	string	异步任务的唯一标识
object	string	类型
model	string	模型名称
status	string	任务状态,queued, in_progress, completed, and failed
progress	int	任务进度
size	string	分辨率
seconds	string	时长

响应示例

{
 "id": "video_456",
 "object": "video",
 "model": "sora-2",
 "status": "queued",
 "progress": 0,
 "created_at": 1712698600,
 "size": "720x1280",
 "seconds": "8"
}

查询任务状态

接口

https://api.modelverse.cn/v1/videos/<task_id>

请求示例

curl --location 'https://api.modelverse.cn/v1/videos/video_6982fa1cd4f081908b619dc53cfc2435' \
-H "Authorization: Bearer $OPENAI_API_KEY"

输出

参数	类型	描述
id	string	异步任务的唯一标识
object	string	类型
model	string	模型名称
status	string	任务状态,queued, in_progress, completed, and failed
progress	int	任务进度
size	string	分辨率
seconds	string	时长

响应示例（成功）

{
 "id": "video_456",
 "object": "video",
 "model": "sora-2",
 "status": "queued",
 "progress": 0,
 "created_at": 1712698600,
 "size": "720x1280",
 "seconds": "8"
}

响应示例（失败）

{
 "error": {
 "message": "error",
 "type": "invalid_request_error",
 "param": null,
 "code": null
 }
}

下载视频

接口

https://api.modelverse.cn/v1/videos/<task_id>/content

请求示例

curl --location 'https://api.modelverse.cn/v1/videos/<task_id>/content' \
-H "Authorization: Bearer $OPENAI_API_KEY"
--output video.mp4

正常返回

返回二进制流

异常返回

{
 "error": {
 "message": "task is not completed yet, current status: Pending",
 "type": "invalid_request_error"
 }
}

remix

接口

https://api.modelverse.cn/v1/videos/<task_id>/remix

请求示例

curl -X POST "https://api.modelverse.cn/v1/videos/<task_id>/remix" \
 -H "Authorization: Bearer $OPENAI_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{
 "prompt": "赛博朋克风格"
 }'

正常返回

{
 "id": "video_456",
 "object": "video",
 "model": "sora-2",
 "status": "queued",
 "progress": 0,
 "created_at": 1712698600,
 "size": "720x1280",
 "seconds": "8",
 "remixed_from_video_id": "video_123"
}

异常返回

{
 "error": {
 "message": "Invalid param: prompt is required",
 "type": "invalid_request_error",
 "param": "6217f8ed-396d-434a-9b78-96775c0d2f99",
 "code": "param_error"
 }
}