LUMA-REFRAME
The Reframe Image model adjusts an image’s composition to fit different aspect ratios while keeping the main subject centered. It ensures the visual balance and quality remain consistent across formats.
Avg Run Time: 25.000s
Model Slug: reframe-image
Playground
Input
Enter a URL or choose a file from your computer.
Invalid URL.
(Max 50MB)
Output
Example Result
Preview and download your result.

API & SDK
Create a Prediction
Send a POST request to create a new prediction. This will return a prediction ID that you'll use to check the result. The request should include your model inputs and API key.
Get Prediction Result
Poll the prediction endpoint with the prediction ID until the result is ready. The API uses long-polling, so you'll need to repeatedly check until you receive a success status.
Readme
Overview
reframe-image — Image-to-Image AI Model
Developed by Luma as part of the luma-reframe family, reframe-image is an image-to-image AI model that adjusts an image’s composition to fit different aspect ratios while keeping the main subject centered and preserving visual balance. This solves the common challenge of repurposing visuals for social media, ads, or websites without losing quality or cropping key elements. Ideal for developers seeking an AI image editor API, it ensures consistent outputs across formats like portrait to landscape.
Luma's reframe-image leverages advanced composition controls from the luma-reframe family, enabling seamless adaptation for multi-platform content creation. Users upload an input image and select target aspect ratios, generating reframed versions rapidly.
Technical Specifications
What Sets reframe-image Apart
reframe-image stands out in the image-to-image AI model landscape by prioritizing subject-centered reframing, a repeatable operation unique to Luma's workflow that maintains visual coherence unlike generic resizers. This enables creators to build consistent asset libraries without manual editing.
It supports a wide range of aspect ratios including Ultra Wide (21:9), Widescreen (16:9), Square (1:1), Portrait (3:4), Vertical (9:16), and Ultra Tall (9:21), matching Luma's professional-grade controls. Developers benefit from fast processing integrated into Luma image-to-image pipelines, ideal for automated workflows.
Outputs maintain high fidelity with resolutions up to 1080p or 4K upscaling, drawing from Luma's Ray models for realistic detail preservation during reframing. This differentiates it for edit images with AI tasks requiring no quality loss across formats.
- Subject-centric adaptation: Automatically centers and balances the main subject, preventing awkward crops common in standard tools.
- Multi-aspect ratio support: Handles 7+ ratios for versatile image-to-image AI model applications like social media optimization.
- Seamless workflow integration: Part of Luma's extend-modify-reframe chain for iterative image editing.
Key Considerations
- Ensure the main subject is clearly distinguishable in the input image for optimal centering and reframing results
- For best quality, use high-resolution source images with minimal background clutter
- Avoid images where the subject is partially occluded or blends into the background, as this can reduce subject detection accuracy
- There is a trade-off between speed and output quality; higher quality settings may increase processing time
- When reframing to extreme aspect ratios, be aware that significant outpainting may introduce artifacts or less realistic background extensions
- Prompt engineering (if supported) can help guide the model to prioritize certain elements or styles during reframing
Tips & Tricks
How to Use reframe-image on Eachlabs
Access reframe-image through Eachlabs Playground for instant testing, API for production-scale Luma image-to-image integrations, or SDK for custom apps. Upload your input image, specify target aspect ratio like 9:16 vertical, and generate high-fidelity outputs up to 4K. Processing is fast, delivering centered, balanced results ready for any platform.
---Capabilities
- Automatically adjusts image composition to fit a wide range of aspect ratios while centering the main subject
- Performs content-aware outpainting to fill in missing areas when expanding beyond the original image bounds
- Maintains high perceptual quality and visual consistency across different formats
- Supports batch processing for efficient handling of large image sets
- Adapts to various content types, including portraits, products, and landscapes
- Reduces the need for manual cropping and retouching in multi-format publishing workflows
What Can I Use It For?
Use Cases for reframe-image
Content creators repurposing photos for Instagram and TikTok can upload a landscape product shot and reframe it to vertical (9:16), keeping the item centered for engaging stories without redesigning visuals.
Marketers building e-commerce campaigns use reframe-image to adapt banner images: input a 16:9 ad creative and output square (1:1) versions for Facebook, ensuring brand elements stay prominent and balanced for higher click-through rates.
Developers integrating an AI image editor API for apps feed user-uploaded portraits into reframe-image with a parameter like "reframe to ultra wide 21:9, center face," generating widescreen profiles instantly for dynamic web layouts.
Designers handling automated image editing API tasks for client portfolios reframe complex compositions, such as "adjust this event photo to portrait 3:4, preserve group focus," streamlining multi-format deliverables without Photoshop sessions.
Things to Be Aware Of
- Some users report that the model performs best with images where the subject is clearly separated from the background
- In cases of extreme aspect ratio changes, the outpainted areas may sometimes appear less realistic or contextually inconsistent
- Processing speed is generally fast on modern GPUs, but batch jobs with high-resolution images may require significant memory and compute resources
- Community feedback highlights the model’s reliability for standard aspect ratios (e.g., 1:1, 16:9, 4:5), but notes occasional artifacts with panoramic or ultra-tall formats
- Positive reviews emphasize the reduction in manual editing time and the consistency of subject centering
- Some users mention that fine details in the background may be lost or altered during aggressive reframing
- The model’s performance may vary depending on the complexity of the scene and the prominence of the main subject
Limitations
- May struggle with images where the main subject is ambiguous, heavily occluded, or blends into the background
- Outpainted regions in highly altered aspect ratios can sometimes introduce visual artifacts or unrealistic elements
- Not optimal for scenarios requiring precise manual control over every aspect of the reframed composition
Pricing
Pricing Type: Dynamic
Photon Flash 1 custom pricing
Pricing Rules
| Model | Price |
|---|---|
| photon-flash-1 | $0.01 |
| photon-1 | $0.03 |
Related AI Models
You can seamlessly integrate advanced AI capabilities into your applications without the hassle of managing complex infrastructure.
