---
updatedAt: 2026-07-10T19:01:19.000Z
agentTools:
projectIndex: https://docs.lumalabs.ai/llms.txt
---
# Reframe
### Looking for the latest Luma API?
Create and manage API access in the [Luma API Platform](https://platform.lumalabs.ai/). For current API guides and reference, visit the [Luma Agents API documentation](https://docs.agents.lumalabs.ai/).
### Now available in API & SDKs
| Models | Max Duration | Max Size |
| :------------- | :----------- | :------- |
| ray-2 | 10s | 100 mb |
| ray-flash-2 | 30s | 100 mb |
| photon-1 | n/a | 10 mb |
| photon-flash-1 | n/a | 10 mb |
### API Reference
[image](https://docs.lumalabs.ai/reference/reframeimage)
[video](https://docs.lumalabs.ai/reference/reframevideo)
### Basic Usage
* by default one can just pass the url of image/video to reframe with
* model
* target aspect ratio
* it fits the image horizontally and vertically and make a new video/image
* optionally provide prompts on how to steer what content goes into the reframed new area
* target width and height are standard based on chosen aspect ratio
### Pricing
Same as cost of the models (ray-2, ray-flash-2, photon-1, photon-flash-1)
[learn more](https://docs.agents.lumalabs.ai/guides/pricing/)
### Advanced Usage
```javascript Photon (Image)
aspect_ratio_map = {
"1:1": [1536, 1536],
"4:3": [1792, 1344],
"3:4": [1344, 1792],
"16:9": [2048, 1152],
"9:16": [1152, 2048],
"21:9": [2432, 1024],
"9:21": [1024, 2432],
}
```
```javascript Ray (Video)
aspect_ratio_map = {
"1:1": [1024, 1024],
"4:3": [1152, 864],
"3:4": [864, 1152],
"16:9": [1280, 720],
"9:16": [720, 1280],
"21:9": [1552, 656],
"9:21": [656, 1552],
}
```
grid\_position\_x, grid\_position\_y, x\_start, x\_end, y\_start, y\_end, resized\_width, resized\_height are in pixel values.