Skip to main content
POST
/
v1
/
predictions
curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "sora-2",
  "function": "video",
  "input": {
    "prompt": "A cinematic shot of a majestic lion in the savannah at golden hour",
    "aspect_ratio": "16:9",
    "resolution": "720P",
    "duration": 4
  }
}
'
{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

​
Overview

OpenAI Sora 2 (sora-2) supports:
  • Text-to-video — prompt (up to 32,000 characters)
  • Reference-guided generation — optional first_frame_url
Output is 720P only.

​
Input parameters

FieldRequiredDefaultNotes
promptYes—Max 32,000 characters
aspect_ratioNo16:916:9 or 9:16
resolutionNo720P720P only
durationNo44, 8, or 12 seconds
first_frame_urlNo—Optional reference URL to guide generation

Authorizations

​
Authorization
string
header
required

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
default:sora-2
required

Model ID. Use sora-2 for this endpoint.

Available options:
sora-2
Example:

"sora-2"

​
function
enum<string>
required

Task type. Must be video for video generation.

Available options:
video
Example:

"video"

​
input
object
required
​
webhook
string<uri>

Optional HTTPS callback URL when the task completes, fails, or is cancelled.

Response

Async task created

​
data
object
required