Ray 2 T2V | Powerful Text-to-Video API

luma /

Luma Ray 2 is a Text-to-Video model that creates high-quality videos from text prompts, with advanced prompt optimization and support for various video sizes. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-video

Input

Enable Safety Checker

Idle

$0.4per run·~25 / $10

ExamplesView all

2D animation of a cat astronaut flying through candy-colored galaxies, playful transitions

Sunset beach walk with a golden retriever, wide landscape shots, handheld closeups of sand and waves

A glowing deer walking through a bioluminescent forest, dreamlike fog, soft glowing particles floating

Crystal castles rising from the ocean, moonlight reflections, dramatic orchestral vibe

A robot discovering an abandoned Earth, desaturated colors, overgrown skyscrapers, lonely soundtrack

Felt-texture bunny baking cupcakes in a cozy forest kitchen, top-down and close-up shots, pastel tones

Aerial drone shot over Icelandic waterfalls, dramatic cliffs, slow-motion eagle soaring above

Claymation-style fox exploring a mushroom village, cheerful music, warm lighting

Macro shots of insects on flowers, light dew, gentle breeze, ambient forest sounds

An astronaut floating silently in deep space, tethered to a sleek, white spaceship. The Earth is a beautiful, bright marble in the background. The reflection of distant nebulae can be seen in her helmet visor. Cinematic, breathtaking view, realistic, style of "Gravity" (2013 movie). -camera rotate counter-clockwise

Related Models

ray-3.2/image-to-video

image-to-video

ray-3.2/text-to-video

text-to-video

uni-v1/edit

image-to-image

uni-v1/text-to-image

text-to-image

modify-video

video-to-video

ray-2-i2v

image-to-video

README

Luma Ray 2 — Text-to-Video

Luma Ray 2 Text-to-Video is Luma AI's powerful text-to-video generation model that creates stunning, high-quality videos from text descriptions. Generate smooth, visually striking 720p videos with excellent motion coherence — perfect for creative content and professional projects.

Why It Stands Out

High-quality generation: Produces detailed videos with smooth, natural motion.
HD 720p output: Generate crisp videos in landscape (1280×720) or portrait (720×1280).
Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
Style versatility: Handles various styles from 2D animation to photorealistic scenes.
Flexible duration: Choose between 5 or 10 second video lengths.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the video you want to generate.
size	No	Output resolution: 1280×720 or 720×1280 (default: 1280×720).
duration	No	Video length: 5 or 10 seconds (default: 5).

How to Use

Write a prompt describing the scene, action, and style you want. Use the Prompt Enhancer for AI-assisted optimization.
Select size — choose landscape (1280×720) or portrait (720×1280).
Set duration — choose 5 or 10 seconds.
Click Run and wait for your video to generate.
Preview and download the result.

Best Use Cases

2D Animation — Create playful animated content with vibrant styles.
Social Media Content — Generate platform-optimized videos for TikTok, Reels, and Shorts.
Marketing & Advertising — Produce eye-catching promotional videos and ad creatives.
Creative Projects — Bring imaginative concepts to life with unique visual styles.
Music Videos — Generate dynamic visuals for songs and audio tracks.

Pricing

Duration	Price
5 seconds	$0.40
10 seconds	$0.80

Pro Tips for Best Quality

Be detailed in your prompt — describe subject, action, environment, and style.
Specify animation style if desired (e.g., "2D animation," "3D render," "photorealistic").
Include mood keywords like "playful," "dramatic," "whimsical," or "cinematic."
Describe transitions and motion for more dynamic results.
Choose portrait (720×1280) for mobile-first platforms like TikTok.

Notes

Processing time varies based on duration and current queue load.
Please ensure your prompts comply with content guidelines.

Accessibility:This website uses AI models provided by third parties.

Ray 2 T2v API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/luma/ray-2-t2v with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Ray 2 T2v below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/luma/ray-2-t2v" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1280*720",
    "duration": 5
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("luma/ray-2-t2v", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "size": "1280*720",
        "duration": 5
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "luma/ray-2-t2v",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1280*720",
    "duration": 5
}
)

print(output["outputs"][0])  # → URL of the generated output

Ray 2 T2v API — Frequently asked questions

What is the Ray 2 T2v API?

Ray 2 T2v is a Luma model for video generation, exposed as a REST API on WaveSpeedAI. Luma Ray 2 is a Text-to-Video model that creates high-quality videos from text prompts, with advanced prompt optimization and support for various video sizes. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Ray 2 T2v API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/luma/luma-ray-2-t2v.

How much does Ray 2 T2v cost per run?

Ray 2 T2v starts at $0.40 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Ray 2 T2v accept?

Key inputs: `prompt`, `duration`, `size`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/luma/luma-ray-2-t2v.

How long does Ray 2 T2v take to generate?

Average end-to-end generation time on WaveSpeedAI is around 100 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Ray 2 T2v outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Luma). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.