Technical profile
What developers should know
Generation contract
The Dream Machine video endpoint defaults to ray-2 and also lists ray-flash-2. A request can include a text prompt, aspect ratio, loop setting, keyframes, resolution, duration, concepts, and a callback URL.[1]
Resolution and duration are separate controls
The documented request schema lists 540p, 720p, 1080p, and 4K resolution values, plus five- and nine-second durations. Availability or cost for a particular combination should be checked at request time rather than inferred from the enum alone.[1]
Asynchronous workflow
Creating a generation returns a generation object, while callback delivery can report dreaming, completed, or failed states. Integrations should make callbacks idempotent and preserve failure details for retry decisions.[1]
Choose the artifact
Official checkpoints
Use the exact documented model or endpoint identifier and record input assets, parameters, output metadata, and failure states for reproducible media workflows.[1]
Validate the requested resolution and duration combination with the current API, use an authenticated callback endpoint, and make completion handling idempotent because status delivery can be retried.[1]