OpenAI/Sora2-I2V-Pro
图生视频模型
异步提交任务
接口
https://api.modelverse.cn/v1/tasks/submit
输入
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型名称,此处为 openai/sora-2/image-to-video-pro |
| input.first_frame_url | string | 是 | 视频首帧图片 URL,可为 URL 或 Base64 |
| input.prompt | string | 否 | 提示词,用于指导视频生成 |
| parameters.resolution | string | 否 | 生成视频的分辨率。 可选值: - 720p- 1080p默认为 720p |
| parameters.duration | int | 否 | 视频生成时长(秒),可选值 4, 8, 12,默认为 4 |
请求示例
⚠️ 如果您使用 Windows 系统,建议使用 Postman 或其他 API 调用工具。
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "openai/sora-2/image-to-video-pro",
"input": {
"first_frame_url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg",
"prompt": "The image is coming to life"
},
"parameters": {
"resolution": "720p",
"duration": 4
}
}'输出
| 参数 | 类型 | 描述 |
|---|---|---|
| output.task_id | string | 异步任务的唯一标识 |
| request_id | string | 请求的唯一标识 |
响应示例
{
"output": {
"task_id": "task_id"
},
"request_id": "request_id"
}查询任务状态
接口
https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>
请求示例
curl --location 'https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>' \
--header 'Authorization: <YOUR_API_KEY>'输出
| 参数 | 类型 | 描述 |
|---|---|---|
| output.task_id | string | 异步任务的唯一标识 |
| output.task_status | string | 任务状态:Pending,Running,Success,Failure |
| output.urls | array | 视频结果的 URL 列表 |
| output.submit_time | integer | 任务提交时间戳 |
| output.finish_time | integer | 任务完成时间戳 |
| output.error_message | string | 失败时返回的错误信息 |
| usage.duration | integer | 任务执行时长(秒) |
| request_id | string | 请求的唯一标识 |
响应示例
{
"output": {
"task_id": "task_id",
"task_status": "Success",
"urls": ["https://xxxxx/xxxx.mp4"],
"submit_time": 1756959000,
"finish_time": 1756959050
},
"usage": {
"duration": 4
},
"request_id": ""
}