Ray3.2

Introduction

Reframing takes a finished clip and places it on a new canvas, then extends the scene to fill whatever space the original didn't cover. It's how one horizontal master becomes a vertical cut for social or a square cut for a feed, without cropping away the subject, because Ray 3.2 generates the new edges rather than trimming the old ones.

This is a different operation from editing . Editing reworks the look and holds the source aspect ratio. Reframing keeps the look and changes the canvas. This guide covers the reframe request and settings.sourcePosition for placing the source inside a larger frame.

The request

A reframe is a video request with the clip in inputs.video and a new width and height at a different aspect ratio. The prompt describes what should fill the extended area, so the model continues the scene instead of guessing.

[
  {
    "taskType": "videoInference",
    "taskUUID": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "model": "luma:ray@3.2",
    "positivePrompt": "Extend the scene into a tall vertical frame, continuing the sky above and the sea below the lighthouse naturally, matching the source light and motion.",
    "width": 720,
    "height": 1280,
    "inputs": {
      "video": "https://example.com/lighthouse.mp4"
    }
  }
]

{
  "data": [
    {
      "taskType": "videoInference",
      "taskUUID": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "videoUUID": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "videoURL": "https://vm.runware.ai/video/os/a14d18/ws/2/vi/2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e.mp4"
    }
  ]
}

Repurposing across aspect ratios

The same 16:9 source reframes to whatever target you need. To a 9:16 canvas the model paints sky above and sea below. To a 1:1 canvas it continues the scene out to the sides. The lighthouse and its motion stay put while the surroundings grow to fit.

Width and height come from Ray's supported pairs, the same set the generation guide uses, so a reframe lands on a real output size at 360p through 1080p.

Positioning the source

By default the source sits centered in the new canvas. settings.sourcePosition overrides that, placing the source at an exact spot and size given as fractions of the canvas. Shrink the source below full size and the model extends the scene all the way around it, which turns reframing into frame extension.

The four fields are x and y for the source's position and width and height for its size, each a fraction of the canvas. The values below put the source in the middle 60% and let the model fill the border all around.

"settings": {
  "sourcePosition": { "x": 0.2, "y": 0.2, "width": 0.6, "height": 0.6 }
}

Shifting x and y biases where the new space opens. Push the source toward one edge and the model fills the opposite side. Both clips below use the same lighthouse and the same 1920 × 1080 canvas, changing only the source's position:

Raising x to 0.4 pushes the source flush against the right edge, so the new canvas opens on the left and the prompt's extra sea fills it. Raising y to 0.4 pushes it to the bottom, opening the top for more sky.

Tips

1. Name what fills the new space. A reframe prompt should describe the surroundings to extend, so the model continues the scene rather than inventing something unrelated.

2. Keep the subject off the edges you're extending. Reframing has the most room to work when the subject sits clear of the sides being grown.

3. Reach for sourcePosition to extend, not just convert. Shrinking the source on a same-aspect canvas turns reframing into frame extension, adding scenery around the original.

4. Reframe as a final step. Lock the look with editing first, then reframe the result, so you're extending footage that already looks right.