1.概述

OpenAI推出的最新文本到视频生成模型，能够根据简短提示生成带同步语音和音效、物理更准确且更可控的短视频，并在输出中加入可见水印以防滥用。

通过本接口创建视频生成任务，获得视频id字段后，在创建视频再创作任务、查询任务状态、下载视频文件接口中通过url添加video_id使用。

模型列表：

  • sora-2

2.请求说明

  • 请求方法: POST
  • 请求地址
  https://gateway.theturbo.ai/v1/videos

3.请求参数

3.1 Head参数

参数名称 类型 必填 说明 示例值
Content-Type string 是 设置请求头类型，必须为multipart/form-data multipart/form-data; boundary=------------------------y0QNRDhXQUE3yHQi7DEbLz
Authorization string 是 身份验证所需的 API_KEY，格式Bearer $YOUR_API_KEY Bearer $YOUR_API_KEY

3.2 Body 参数 (application/json)

参数名称 类型 必填 说明 示例
model string 是 要使用的模型 ID。详见概述列出的可用版本，如 sora-2。 sora-2
prompt string 是 用于描述要生成的视频的文本提示。 A calico cat playing a piano on stage
input_reference string 否 可选的图像参考，用于指导生成。必须和生成视频分辨率保持一致。
content string 否 生成视频的时长（秒）。默认 4秒。 4
size number 否 生成视频分辨率，格式为 宽 x 高。默认 720x1280。sora-2目前只支持720x1280和1280x720。 720x1280

4.请求示例 

  curl -X POST https://gateway.theturbo.ai/v1/videos \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-F "model=sora-2" \
	-F "prompt=A calico cat playing a piano on stage" \
	-F "seconds=4" \
	-F "size=720x1280"
  
  curl -X POST https://gateway.theturbo.ai/v1/videos \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-F "model=sora-2" \
	-F "input_reference=@input.png" \
	-F "prompt=A calico cat playing a piano on stage" \
	-F "seconds=4" \
	-F "size=720x1280"

5.响应示例 

  {
	"id": "video_68f7441dd5f0819096687ce9bde11dd9",
	"object": "video",
	"created_at": 1761035293,
	"status": "queued",
	"completed_at": null,
	"error": null,
	"expires_at": null,
	"model": "sora-2",
	"progress": 0,
	"remixed_from_video_id": null,
	"seconds": "4",
	"size": "720x1280"
}