HiAPI
ray-3.2 图像转视频模型详情页 Hero 图:暖奶油底色上,右侧玻璃胶片带与光轨延展出虹彩立体字 ray-3.2,左侧留出通透光晕,蓝青与珊瑚粉点缀。

Luma

Ray 3.2

ray-3.2/text-to-video

Luma's cinematic video generation model, with native support for HDR and EXR export, suited to atmospheric establishing shots, advertising, and early-stage concept films for film and television; prompt adherence is stable under structured shot instructions

Pricing

ray-3.2/text-to-video per video

Specifications Unit Price
540P $0.2145
720P $0.429
1080P $1.7145

Overview

Ray 3.2 is Luma's text-to-video model for cinematic short clips. With just a text prompt, it generates 5-second or 10-second clips at 540p, 720p, or 1080p, and supports six aspect ratios: 16:9, 9:16, 1:1, 4:3, 3:4, and 21:9. It responds reliably to structured, specific shot and subject descriptions, and performs especially well on atmospheric, environment-focused shots. It suits developers and creative teams that need to quickly produce concept films, storyboard previews, and social short videos, and can be integrated into generation workflows by calling it through the unified HiAPI.ai API.

Key Highlights

  • Shot-level description control — It follows structured, specific shot blocking and subject descriptions closely, while results degrade under vague, open-ended instructions.
  • Cinematic visual style tuning — Its visual style and physical realism lean cinematic, making it well suited to atmospheric empty shots and environment footage.
  • Multiple aspect ratios and resolutions — Output supports six ratios spanning landscape, portrait, square, and widescreen, at resolutions up to 1080p and durations of 5 or 10 seconds.

Capabilities

Direct text-to-video generation: Enter a prompt of up to 6,000 characters to produce a short clip with no source footage required, ideal for quickly validating shot ideas from scratch.

Selectable duration and resolution: Clip duration can be 5 or 10 seconds, and resolution covers 540p, 720p, and 1080p, so you can choose specs separately for draft and final-output stages.

Six aspect ratios in one model: It supports 16:9, 9:16, 1:1, 4:3, 3:4, and 21:9, so the same prompt can directly produce landscape, portrait, or widescreen versions to fit different placements.

Cinematic and atmospheric shots: Its visual style and physical realism lean cinematic, and it is relatively stable on environment shots such as atmospheric empty shots and scene backgrounds.

Use Cases

  • Film or advertising teams creating concept films and storyboard previews — Describe shot blocking and scene atmosphere in text to produce 5- to 10-second clips as early-stage visual references for creative and client discussions.
  • Content teams generating atmospheric empty shots and background assets — Describe lighting, environment, and mood to produce environment shot assets for transitions, background screens, and atmosphere building in video editing.
  • Marketers quickly producing social short videos — Choose portrait or landscape aspect ratios by placement and directly generate 5- to 10-second clips suited to each platform for social media and ad placements.
  • Developers generating shot assets in batches — Submit generation tasks in batches by prompt through the unified HiAPI.ai API and feed shot assets into your own content production or asset library workflows.

Limitations and Selection Advice

Clips are capped at 10 seconds and 1080p, so it is not suited to long takes or direct high-resolution master output. Third-party evaluations show that temporal consistency and motion quality are not its strongest areas, and shots with continuous motion or multiple interacting subjects require multiple generation rounds and filtering. Results depend on structured, specific prompts, and performance degrades under vague or open-ended instructions. If your needs involve long-form narrative, fine-grained motion control, or image-driven generation, evaluate other models or combine this with an image-to-video pipeline.

Frequently asked questions

View all FAQs →
  • What inputs does Ray 3.2 image-to-video need?

    Two are required: prompt (1–6000 characters) and the first frame image_url. Optional are end_image_url as the last frame and resolution (540p, 720p or 1080p, default 540p). In the Playground you can upload a local image directly.

  • Can I set the video length?

    No. Every image-to-video clip is 5 seconds and the request has no duration field. For a 10-second shot, use Ray 3.2 text-to-video, which supports 5 and 10 seconds.

  • What decides the output aspect ratio?

    The first frame; there is no aspect_ratio field. The output snaps to the closest of 16:9, 9:16, 1:1, 4:3, 3:4 and 21:9, trimming the edges when the ratios differ. The desert example here starts from a roughly 3:2 image (1024×687) and comes back at 4:3, 1104×832; the iced espresso example starts from a 9:16 image and stays 9:16 with virtually nothing trimmed. To control the ratio exactly, crop the first frame to one of those six ratios first.

  • How do first and last frames work?

    Pass the first frame in image_url and the last in end_image_url; the video moves from one to the other, so the prompt only needs to describe the change in between. The closer the two images are in camera position, light and subject placement, the smoother the transition; when the framing differs the model adds camera movement to bridge it, as in the peony example here.

Related Models

View all models →

Same Type