Skip to content

创建视频

创建视频

POST /v1/videos

OpenAI 兼容的视频生成接口。

参考文档: https://platform.openai.com/docs/api-reference/videos/create

请求头 (Headers)

参数名类型必选描述示例
Authorizationstring鉴权令牌Bearer ********************

请求体 (Request Body)

Content-Type: multipart/form-data

字段类型必选描述
modelstring模型名称
promptstring提示词
secondsstring生成秒数
input_referencestring参考图片文件

请求体示例

json
{
  "model": "sora-2",
  "prompt": "cute cat dance",
  "seconds": "8",
  "input_reference": "string"
}

返回响应 (Responses)

200 - 成功创建视频任务

字段类型描述
idstring视频 ID
objectstring对象类型
modelstring使用的模型
statusstring任务状态
progressinteger进度百分比
created_atinteger创建时间戳
secondsstring视频时长
completed_atinteger完成时间戳
expires_atinteger过期时间戳
sizestring视频尺寸
errorany
metadataobject额外元数据

响应示例

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 - 请求参数错误

字段类型描述
errorobject
error.messagestring错误信息
error.typestring错误类型
error.paramstring (nullable)相关参数
error.codestring (nullable)错误代码

响应示例

json
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Released under the MIT License.