Sign in

v12

OpenAPI 3.1.02026-08-031000506.8 KB
Video

Ray 2

Older model with natural motion.

post/generate/video/luma/ray-2

Headers

X-Webhook-URLstring uri

URL to receive a POST request when the job completes. The webhook will receive the job data including results.

Request body

promptstring required
start_imagestring uri nullable

Can be an external URL, base64 data URI, or uploaded asset URL.

aspect_ratio'1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '21:9' | '9:21'
loopboolean
widthinteger

Width in pixels. Ray 2 derives output resolution from the shorter side; valid short sides are 540, 720, or 1080. Default 960.

heightinteger

Height in pixels. Ray 2 derives output resolution from the shorter side; valid short sides are 540, 720, or 1080. Default 540.

Response

The resulting job data. This will be returned in a pending state until the job is completed. See /jobs/{id} for retrieving the results.

job_idstring uuid required
status'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' required
created_atstring date-time required
{"stackTrail":"paths:/generate/video/luma/ray-2:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/video/luma/ray-2:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}