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": "gen4.5",
  "function": "video",
  "input": {
    "prompt": "A cinematic shot of a majestic lion in the savannah at golden hour",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}
'
{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

​
Overview

Runway Gen-4.5 (gen4.5) supports:
  • Text-to-video — prompt only
  • Image-to-video — optional first_frame_url as the initial frame

​
Input parameters

FieldRequiredDefaultNotes
promptYes—Text prompt for video generation
aspect_ratioNo1:116:9, 9:16, 4:3, 3:4, 1:1, 21:9
durationNo55 or 10 seconds
first_frame_urlNo—Optional first-frame image URL

Authorizations

​
Authorization
string
header
required

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
default:gen4.5
required

Model ID. Use gen4.5 for this endpoint.

Available options:
gen4.5
Example:

"gen4.5"

​
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