models/Luma Labs/Luma Ray 2

Luma Ray 2

video

Ray2 is a large-scale video generative model capable of creating realistic visuals with natural, coherent motion.

Luma Ray 2 (luma/luma-dream-machine-ray-2) is a video model from Luma Labs. Pricing via AIgateway: $0.500 per second. Call it via https://api.aigateway.sh/v1/videos/generations — set model="luma/luma-dream-machine-ray-2". Best for: Ads, Storyboards, Demos.

slug · luma/luma-dream-machine-ray-2provider · Luma Labs

Use this model

model: luma/luma-dream-machine-ray-2

curl https://api.aigateway.sh/v1/videos/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"luma/luma-dream-machine-ray-2","prompt":"a slow drone shot over a mountain lake"}'

curl https://api.aigateway.sh/v1/videos/generations \ -H "Authorization: Bearer $AIGATEWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"luma/luma-dream-machine-ray-2","prompt":"a drone shot of a mountain lake"}'

Capabilities

Strengths

Text-to-video generation
Cinematic motion

Use cases

AdsStoryboardsDemos

Pricing

Per video second$0.500

You pay pass-through · 5% applied at credit top-up, not per-call.

Try in playground →Compare API reference See usage ranking →

Collections

More video models →More from Luma Labs →Frontier models →Free-tier models →

API schema

Call Luma Ray 2 from any OpenAI SDK

POST https://api.aigateway.sh/v1/videos/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json

{
  "model": "luma/luma-dream-machine-ray-2",
  "prompt": "A drone shot of a mountain lake at golden hour",
  "duration": 5,          // seconds
  "aspect_ratio": "16:9"
}

// Response is an async job — poll /v1/jobs/<id> until status === "completed".

Response

json

{
  "id": "job_abc123",
  "status": "queued",        // queued | processing | completed | failed
  "model": "luma/luma-dream-machine-ray-2",
  "created": 1776947082
}

// After completion:
{
  "id": "job_abc123",
  "status": "completed",
  "result": {
    "url": "https://media.aigateway.sh/video/abc123.mp4",
    "duration": 5,
    "resolution": "1920x1080"
  }
}

Quickstart

# See docs at https://aigateway.sh/docs

Errors

401authentication_errorInvalid or missing API key

402insufficient_creditsWallet empty (PAYG only)

404not_foundUnknown model or endpoint

429rate_limit_errorOver per-minute limit — see Retry-After header

500server_errorUpstream provider failed (retryable)

503service_unavailableUpstream saturated (retryable)

Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Luma Ray 2?

Ray2 is a large-scale video generative model capable of creating realistic visuals with natural, coherent motion. It is a video model from Luma Labs, accessible via AIgateway's OpenAI-compatible API at slug luma/luma-dream-machine-ray-2.

How much does Luma Ray 2 cost via AIgateway?

Pass-through pricing plus a 5% platform fee applied at top-up. See the pricing panel on this page for exact rates.

How do I call Luma Ray 2 from my code?

Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "luma/luma-dream-machine-ray-2". The request and response shapes match OpenAI exactly.

Does Luma Ray 2 support streaming, tool calling, vision, and JSON mode?

Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.

What are the best use cases for Luma Ray 2?

Ads, Storyboards, Demos. Key strengths: Text-to-video generation; Cinematic motion.

Can I bring my own Luma Labs API key (BYOK)?

Yes. Attach a Luma Labs key in your AIgateway dashboard and this model flips to pass-through — you pay Luma Labs directly and AIgateway waives the 5% platform fee on those calls.