sora视频接口
开发中
POST
https://xibapi.com/v1/videos
Sora视频生成接口文档
接口地址
POST /v1/videos功能说明
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 推荐 | application/json（文生视频）或 multipart/form-data（图生视频） |
请求参数
文生视频
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，详见下方模型列表 |
| prompt | string | 是 | 文本提示词 |
| style | string | 否 | 视频风格 |
| storyboard | boolean | 否 | 是否启用故事板解析 |
| trim | boolean | 否 | 是否裁剪视频（去除首尾0.5s） |
图生视频
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称 |
| prompt | string | 是 | 文本提示词 |
| image | File | 是 | 参考图片文件（multipart/form-data） |
| style | string | 否 | 视频风格 |
| trim | boolean | 否 | 是否裁剪视频 |
支持的模型
| 模型名称 | 说明 |
|---|---|
| sora-2-landscape-10s | Sora 2 横屏 10秒 |
| sora-2-portrait-10s | Sora 2 竖屏 10秒 |
| sora-2-landscape-15s | Sora 2 横屏 15秒 |
| sora-2-portrait-15s | Sora 2 竖屏 15秒 |
| sora-2-pro-landscape-25s | Sora 2 Pro 横屏 25秒 |
| sora-2-pro-portrait-25s | Sora 2 Pro 竖屏 25秒 |
| sora-2-pro-landscape-hd-15s | Sora 2 Pro 横屏 HD 15秒 |
| sora-2-pro-portrait-hd-15s | Sora 2 Pro 竖屏 HD 15秒 |
请求示例
文生视频
图生视频
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 任务ID |
| object | string | 对象类型，固定值：video |
| model | string | 使用的模型名称 |
| status | string | 任务状态：queued（排队中）、processing（处理中）、completed（已完成）、failed（失败） |
| progress | number | 任务进度，0-100 |
| created_at | number | 创建时间戳（秒） |
| completed_at | number | 完成时间戳（秒，仅completed状态返回） |
响应示例
提交成功（排队中）
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "sora-2-landscape-10s",
"status": "queued",
"progress": 0,
"created_at": 1709876543
}任务完成
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "sora-2-landscape-10s",
"status": "completed",
"progress": 100,
"created_at": 1709876543,
"completed_at": 1709876600
}查询任务状态
接口地址
GET /v1/videos/{task_id}请求示例
响应参数
注意事项
1.
application/json 格式提交2.
multipart/form-data 格式提交，图片通过 image 字段上传3.
GET /v1/videos/{task_id} 查询任务进度和结果请求参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-05-26 05:29:49