Luma Ray 2 I2V
Playground
Try it on WavespeedAI!Luma Ray 2 turns images into high-quality videos at multiple output sizes with advanced prompt optimization for precise control. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Luma Ray 2 Image-to-Video
Transform images into premium cinematic videos with Luma Ray 2 — the flagship image-to-video model from Luma Labs. Delivering the highest quality output with exceptional detail, natural motion, and sophisticated camera work, Ray 2 is the choice for professional content creation.
Looking for faster generation? Try Luma Ray 2 Flash I2V for speed-optimized output.
Why It Looks Great
- Premium quality: Luma’s highest-fidelity image-to-video generation.
- Exceptional detail: Preserves and enhances fine details from source images.
- Natural motion: Creates believable, physically accurate movements.
- Lifestyle mastery: Excels at everyday scenes with warmth and authenticity.
- 720p HD output: Sharp, professional-quality video in landscape or portrait.
- Extended duration: Generate up to 10 seconds of video.
- Prompt Enhancer: Built-in tool to refine your motion descriptions.
Parameters
| Parameter | Required | Description |
|---|---|---|
| image | Yes | Source image to animate (upload or public URL). |
| prompt | Yes | Text description of the motion and atmosphere you want. |
| size | No | Output dimensions: 1280×720 (landscape) or 720×1280 (portrait). Default: 1280×720. |
| duration | No | Video length: 5 or 10 seconds. Default: 5. |
How to Use
- Upload your image — drag and drop or paste a public URL.
- Write your prompt — describe the motion, ambient details, and atmosphere.
- Use Prompt Enhancer (optional) — click to enrich your description.
- Choose size — select landscape (1280×720) or portrait (720×1280).
- Set duration — choose 5 or 10 seconds.
- Run — click the button to generate.
- Download — preview and save your video.
Pricing
Per 5-second billing based on duration.
| Duration | Calculation | Cost |
|---|---|---|
| 5 seconds | 5 ÷ 5 × $0.40 | $0.40 |
| 10 seconds | 10 ÷ 5 × $0.40 | $0.80 |
Size Options
| Size | Orientation | Best For |
|---|---|---|
| 1280×720 | Landscape | YouTube, presentations, cinematic content |
| 720×1280 | Portrait | TikTok, Instagram Reels, Stories, mobile |
Best Use Cases
- Lifestyle Content — Create warm, authentic scenes of everyday life.
- Professional Production — Generate client-ready video for commercial use.
- Ambient Scenes — Animate peaceful, atmospheric environments.
- Marketing & Advertising — Produce premium video from product photography.
- Final Deliverables — Maximum quality for projects where output matters.
Example Prompts
- “Laundry day on a quiet balcony, colorful clothes swaying in the breeze, a woman watering her plants, soft ambient light, distant birds chirping”
- “Morning coffee ritual, steam rising from cup, gentle hand movements, warm kitchen light”
- “Cat stretching lazily on a sunlit windowsill, dust particles floating, peaceful afternoon”
- “Street musician playing guitar, fingers moving on strings, passersby walking, urban atmosphere”
- “Chef garnishing a dish, precise hand movements, professional kitchen, steam and focus”
Model Comparison
| Model | Cost (5s) | Speed | Best For |
|---|---|---|---|
| Ray 2 I2V | $0.40 | Standard | Maximum quality, final deliverables |
| Ray 2 Flash I2V | $0.20 | Fast | Rapid iteration, dreamy content |
| Ray 1.6 I2V | $0.20 | Standard | Cinematic, dramatic content |
Pro Tips for Best Results
- Ray 2 excels at lifestyle and ambient scenes — describe sensory details.
- Include ambient sounds in prompts: “birds chirping”, “distant traffic”, “wind rustling”.
- Describe subtle movements: “swaying in the breeze”, “steam rising”, “gentle movements”.
- Use for final deliverables — test concepts with Ray 2 Flash first.
- Combine multiple action elements for richer, more dynamic scenes.
- Perfect for content that needs warmth, authenticity, and natural feeling.
Notes
- Duration options are 5 or 10 seconds.
- If using a URL, ensure it is publicly accessible.
- Ray 2 delivers Luma’s highest quality — ideal for professional work.
- Premium pricing reflects superior output quality.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/luma/ray-2-i2v" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"size": "1280*720",
"duration": 5
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | Yes | - | The image for generating the output. | |
| prompt | string | Yes | - | The positive prompt for the generation. | |
| size | string | No | 1280*720 | 1280*720, 720*1280 | The size of the generated media in pixels (width*height). |
| duration | integer | No | 5 | 5, 10 | The duration of the generated media in seconds. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |