Create Video Generation Task

Overview

new sora2 Pro Public Models sora2-pro-720p,sora2-pro-1080p,sora2-pro-true-1080p

Endpoint

POST /v1/video/generations

Header Parameters

Name	Type	Required	Description	Example
Authorization	string	No		Bearer {your_token}

Request Body Parameters

Field	Type	Required	Title	Description
model	string	Yes	Model name	Optional values: sora2-landscape-4s, sora2-landscape-8s, sora2-landscape-12s, sora2-portrait-4s, sora2-portrait-8s, sora2-portrait-12s, sora2-pro-720p, sora2-pro-1080p
prompt	string	Yes	prompt
image_url	string	Yes	reference URL	must be public URLimage URL
aspect_ratio	string	No	Ratio	"16:9", "9:16"
duration	string	No	description	4, 8, 12, 16, 20

Request Examples

Example 1

{"model": "sora2-portrait-12s",
 "prompt": " ",
 "image_url": "https://example.com/image.jpg" // Optional values}

curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "sora2-portrait-12s",
 "prompt": " ",
 "image_url": "https://example.com/image.jpg" // Optional values}'

Response Fields

Field	Type	Required	Title	Description
id	string	Yes	task ID
object	string	Yes	Task type
model	string	Yes	Model name
status	string	Yes	Status
progress	string	Yes
created_at	string	Yes	Created time
seconds	string	Yes	duration

Response Examples

Example 1

{
  "id": "gen_xxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "sora2",
  "status": "queued",
  "progress": 0,
  "created_at": 1770405483,
  "seconds": "12"
}