v31

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-01-07133341.7 KB

Generations

Create a generation

Initiate a new generation with the provided prompt

post/generations/video

Request body

generation_type'video'

promptstring

The prompt of the generation

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

The aspect ratio of the generation

loopboolean

Whether to loop the video

callback_urlstring uri

The callback URL of the generation, a POST request with Generation object will be sent to the callback URL when the generation is dreaming, completed, or failed

model'ray-2' | 'ray-flash-2' required

The video model used for the generation

Example request

{
  "summary": "Text to video",
  "value": {
    "prompt": "A serene lake surrounded by mountains at sunset",
    "aspect_ratio": "16:9",
    "loop": true
  }
}

Response

Generation created

idstring uuid

The ID of the generation

generation_type'video' | 'image'

state'queued' | 'dreaming' | 'completed' | 'failed'

The state of the generation

failure_reasonstring

The reason for the state of the generation

created_atstring date-time

The date and time when the generation was created

modelstring

The model used for the generation

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "state": "completed",
  "failure_reason": null,
  "created_at": "2023-06-01T12:00:00Z",
  "assets": {
    "video": "https://example.com/video.mp4"
  },
  "model": "ray-2",
  "request": {
    "prompt": "A serene lake surrounded by mountains at sunset",
    "aspect_ratio": "16:9",
    "loop": true,
    "keyframes": {
      "frame0": {
        "type": "image",
        "url": "https://example.com/image.jpg"
      },
      "frame1": {
        "type": "generation",
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  }
}