Sign in

v31

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-01-07133341.7 KB
Generations
Video
Reframe

Reframe a video

Reframe a video by its ID

post/generations/video/reframe

Request body

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

The model used for the reframe video

promptstring

The prompt of the generation

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

The aspect ratio of the generation

grid_position_xinteger

The x position of the image in the grid

grid_position_yinteger

The y position of the image in the grid

x_startinteger

The x start of the crop bounds

x_endinteger

The x end of the crop bounds

y_startinteger

The y start of the crop bounds

y_endinteger

The y end of the crop bounds

resized_widthinteger

Resized width of source video

resized_heightinteger

Resized height of source 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

Example request

{
  "aspect_ratio": "16:9"
}

Response

Video reframed

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"
      }
    }
  }
}