Appearance
创建视频
创建视频
POST/v1/videosOpenAI 兼容的视频生成接口。
参考文档: https://platform.openai.com/docs/api-reference/videos/create
请求头 (Headers)
| 参数名 | 类型 | 必选 | 描述 | 示例 |
|---|---|---|---|---|
Authorization | string | 否 | 鉴权令牌 | Bearer ******************** |
请求体 (Request Body)
Content-Type: multipart/form-data
| 字段 | 类型 | 必选 | 描述 |
|---|---|---|---|
| model | string | 否 | 模型名称 |
| prompt | string | 否 | 提示词 |
| seconds | string | 否 | 生成秒数 |
| input_reference | string | 否 | 参考图片文件 |
请求体示例
json
{
"model": "sora-2",
"prompt": "cute cat dance",
"seconds": "8",
"input_reference": "string"
}返回响应 (Responses)
200 - 成功创建视频任务
| 字段 | 类型 | 描述 |
|---|---|---|
| id | string | 视频 ID |
| object | string | 对象类型 |
| model | string | 使用的模型 |
| status | string | 任务状态 |
| progress | integer | 进度百分比 |
| created_at | integer | 创建时间戳 |
| seconds | string | 视频时长 |
| completed_at | integer | 完成时间戳 |
| expires_at | integer | 过期时间戳 |
| size | string | 视频尺寸 |
| error | any | |
| metadata | object | 额外元数据 |
响应示例
json
{
"id": "string",
"object": "string",
"model": "string",
"status": "string",
"progress": 0,
"created_at": 0,
"seconds": "string",
"completed_at": 0,
"expires_at": 0,
"size": "string",
"error": {
"message": "string",
"code": "string"
},
"metadata": {}
}400 - 请求参数错误
| 字段 | 类型 | 描述 |
|---|---|---|
| error | object | |
| error.message | string | 错误信息 |
| error.type | string | 错误类型 |
| error.param | string (nullable) | 相关参数 |
| error.code | string (nullable) | 错误代码 |
响应示例
json
{
"error": {
"message": "string",
"type": "string",
"param": "string",
"code": "string"
}
}