Eachlabs | AI Workflows for app builders
reframe-image

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.

Advanced Controls

Output

Example Result

Preview and download your result.

Preview
Unsupported conditions - pricing not available for this input format

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

Table of Contents
Overview
Technical Specifications
Key Considerations
Tips & Tricks
Capabilities
What Can I Use It For?
Things to Be Aware Of
Limitations

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

ModelPrice
photon-flash-1$0.01
photon-1$0.03