Luma Ray video production

Route the job before writing a request. Luma currently exposes similarly named products with incompatible models, schemas, credentials, prices, and data terms. For new API integrations, use the Luma Agents API and ray-3.2; treat the older Dream Machine API as a legacy compatibility surface.

Volatile facts were verified from first-party Luma sources on 2026-07-10. Recheck the model page, schema, price, account limits, and applicable agreement before any paid or sensitive run.

Separate the three surfaces

Current developer surface: Luma Agents API

• Base URL: https://agents.lumalabs.ai/v1
• Credential: LUMA_AGENTS_API_KEY, sent as a Bearer token; current keys begin luma-api-.
• Model: ray-3.2.
• Generation types: video, video_edit, video_reframe on POST /v1/generations; poll GET /v1/generations/{id}.
• Current response header: X-API-Version: 2026-04-01. It is informational; do not send it as a request version.
• Current official Python package: luma-agents (from luma_agents import Luma). TypeScript, Go, CLI, and raw HTTP are also documented.

Use this surface for all new code. Sources: Agents quickstart, models, API reference.