/luma

name: luma
description: >-
  The Luma Dream Machine craft skill — generate cinematic AI video shots (Ray3: text-to-video,
  image-to-video, keyframes, character reference, Modify V2V, HDR) with draft-first economics and
  the right rights. Use when someone wants to generate video with Luma/Dream Machine/Ray3, animate
  a still into video, keep a character consistent across shots, restyle real footage, control
  credit burn, pick a Luma model or plan, or build a multi-shot AI brand film. Uses the DREAM
  framework. Reads ai-video + brand-profile + short-form-video-script first. The agent writes shot
  briefs and can drive the API where connected; the HUMAN judges every clip; WoopSocial publishes.
  Generations are shots not films (no native audio); Draft Mode first, HDR only for finals; verify
  tiers in-app. Never use unpermitted likeness, generate fake-event footage, or state credit rates
  as fact. Distinct from ai-video, veo-3/kling/runway, flux (the stills this animates),
  heygen/synthesia, and capcut.
version: 1.0.0

luma

The **cinematic video-generation tool skill** — define the shot, reference with stills + frames, economize with drafts, assemble the sequence, and mind the rights. The agent briefs (and can drive the API where connected); the **human judges every clip**; **WoopSocial publishes**. (Ships with `tools/integrations/luma.md`.)

The POV: shots, not films — and drafts, not gambles

Dream Machine's 2026 edge is per-shot cinematic quality: Ray3 was the first "reasoning" video model (it interprets, generates, self-evaluates, retries), with 16-bit HDR, keyframes, character reference, and Modify (restyle real footage, keep the performance). The top-1% operator holds four truths the marketing softens. **(1) Generations are shots, not films:** 5–10 seconds each, Extend degrades past the initial clip — a brand film is a shot list, generated shot-by-shot and **assembled in an editor** with **sound added in post** (no native audio; that's Veo/Kling territory). **(2) Draft first, always:** iterate cheap in Draft Mode, Hi-Fi master only the winner — because HDR at 1080p runs ~16× standard credits and monthly credits expire at reset. **(3) Variance is real:** the same prompt differs run-to-run more than half the time (independent testing) — so client-grade consistency comes from **references** (still-first image-to-video, character reference on base Ray3, keyframes), never from luck. **(4) The rights fine print:** free = watermarked non-commercial, the commercial floor is the Plus-level plan (tier tables genuinely conflict — verify in-app), and **Luma keeps a marketing license on your generations** — the clause client work needs to know about.

Read these first

1. **ai-video** — the model-agnostic router/craft above the video tools. 2. **brand-profile** + **design-and-templates** (the brand feel) + **short-form-video-script** (the beats).

The framework: DREAM

(Depth: `references/the-dream-framework.md`.)

• **D — Define the shot:** a director's shot brief (subject + action + setting + light + mood + camera move);

one shot per generation; vague prompts pay the variance tax.

• **R — Reference with stills + frames:** still-first image-to-video (brand-true frames from flux/Photon);

keyframes for transitions; character reference (Ray3) for identity; Modify for real footage; never an unpermitted likeness.

• **E — Economize with drafts:** Draft Mode → Hi-Fi the winner; ~3 attempts per usable clip budgeted; HDR only

for graded finals; credits expire — plan sessions.

• **A — Assemble the sequence:** shots → capcut (pace to the beats), sound in post (ai-music-and-sound),

keyframe-matched cuts; drift review on sets.

• **M — Mind the rights:** commercial tier confirmed; Luma's license-back understood (Enterprise for NDA);

AI-disclosure (EU AI Act; C2PA); then the human judges and WoopSocial publishes.

The reality (verify-quarterly)

2026 Luma: **Ray3** (reasoning model; 16-bit HDR + EXR; keyframes; character reference; visual annotation; Modify V2V) · **Ray3.14** (Jan 2026 — native 1080p, ~4× faster, ~3× cheaper at 720p; **drops character reference + HDR**) · a newer Ray already on the official pricing page (the line moves) · **Photon** (images) · **Luma Agents** (multi-model bundle incl. Veo/Kling/ElevenLabs — worth it if you'd pay for 2–3 bundled models; overpaying for one) · official Python SDK (create → poll → download); **API credits are a separate wallet.** Economics: Draft→Hi-Fi is the signature workflow; HDR 1080p ≈ 16× standard 720p; ~3 attempts/usable clip; monthly credits expire, top-ups roll over; Trustpilot skews negative on billing. Rights: free = non-commercial; commercial floor = Plus-level (~$30/mo; **tier tables conflict — two plan generations coexist; verify in-app**); Luma's marketing license-back; Enterprise = data-privacy guarantee. Variance: same prompt differs >50% of runs (goenhance). Sora's consumer shutdown (Apr 2026) made Luma a migration target. **Attribute all; verify-quarterly.** Full detail: `references/luma-2026-reality.md`. The model table, shot-brief pattern, the sequence workflow, the credit worksheet, and two worked examples: `references/shot-patterns-and-templates.md`.

Honest scope (never violate)

• **The agent** briefs shots, plans references/keyframes/credits, and drives the SDK **where connected** (exact

human steps otherwise; no unreviewed auto-publish); the **human judges every clip** (no fabricated "that shot works"; drift reviews on sets); **WoopSocial publishes** the exports — it does **not** generate or edit video.

• **Rights spine:** free tier never for client/commercial work; verify the current tier in-app; Luma's

license-back disclosed to clients where relevant; Enterprise for NDA; counsel for high-stakes (not legal advice). **Likeness/misinformation:** no unpermitted real-person likeness (real or AI lookalike); **no photoreal fake-event footage of real entities** ("satire" doesn't launder defamatio