Luma API
Video modification and transformation powered by Luma's Dream Machine model.
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "luma-modify-video",
"video_url": "https://cdn.runapi.ai/public/samples/video.mp4",
"prompt": "Transform this office walkthrough video into a cyberpunk aesthetic with neon lighting, keeping the original camera movement."
}'import { LumaClient } from "@runapi.ai/luma";
const client = new LumaClient();
const result = await client.modifyVideo.run({
model: "luma-modify-video",
video_url: "https://cdn.runapi.ai/public/samples/video.mp4",
prompt: "Transform this office walkthrough video into a cyberpunk aesthetic with neon lighting, keeping the original camera movement.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Luma\LumaClient;
$client = new LumaClient();
$result = $client->modifyVideo->run([
'model' => 'luma-modify-video',
'video_url' => 'https://cdn.runapi.ai/public/samples/video.mp4',
'prompt' => 'Transform this office walkthrough video into a cyberpunk aesthetic with neon lighting, keeping the original camera movement.',
]);require "runapi/luma"
client = RunApi::Luma::Client.new
result = client.modify_video.run(
model: "luma-modify-video",
video_url: "https://cdn.runapi.ai/public/samples/video.mp4",
prompt: "Transform this office walkthrough video into a cyberpunk aesthetic with neon lighting, keeping the original camera movement."
)npx skills add runapi-ai/luma -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorLuma Dream Machine's video modification model retransforms existing footage with new visual styles or scene changes while preserving the source clip's motion and temporal structure.
- Più varianti per diversi livelli di velocità / qualità
- Il model skill include documentazione, schema e note di setup
- Funziona con workflow di sviluppo app
- Le generazioni fallite non vengono addebitate
Prezzi
Dettagli tecnici
| ID modello | luma-modify-video |
| Provider | Luma |
| Modalità | video |
| Tipo di task | asynchronous |
| Unità di fatturazione | call |
| API endpoint | /api/v1/luma/modify_video |
| Licenza commerciale | Sì — inclusa via API |
| Stato del catalogo | Operativo |
Installa lo skill Luma per lo sviluppo di app
Carica documentazione del modello, schema, note prezzi e passaggi di setup nel tuo workspace di codice.
# Install the model skill for app development workflows
npx skills add runapi-ai/luma -gInstall the Luma skill for this app: 1. Add runapi-ai/luma with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Dal model skill al primo risultato in quattro passaggi
Scegli il modello
Seleziona modello e variante adatti al tipo di output, al livello qualità e alla latenza target.
Configura
Imposta la tua chiave RunAPI e installa il model skill nel workspace di codice.
Implementa
Usa le istruzioni dello skill per aggiungere la feature modello dentro la tua applicazione.
Ricevi
Interroga per task ID, usa streaming dove supportato o gestisci il callback webhook.
Che cos'è l'API Luma?
Luma AI's Dream Machine model modifies existing video by retransforming visual style while preserving motion. Through RunAPI, it shares unified API access and per-call billing.
Perché usare l'API Luma tramite RunAPI
Un’unica autenticazione, tutti i provider
Una sola chiave RunAPI sblocca l’intero catalogo. Niente account separati, niente rotazione delle chiavi per integrazione.
Prezzi e billing unificati
Prezzi per chiamata in USD, fatturati mensilmente. Le generazioni fallite non vengono addebitate.
Skill con schema
Schema tipizzati e note di setup sono inclusi nel model skill, così l'implementazione parte dal contratto corretto.
Domande frequenti
What is video modification?
Luma's modify-video endpoint takes existing footage and retransforms its visual style and content based on a text prompt, while preserving the original motion and camera dynamics.
Does it preserve the original motion?
Yes — camera movement, subject motion, and temporal structure from the source video are maintained. Only the visual style and appearance change.
What styles can I apply?
Any style describable in text — cinematic, anime, painterly, noir, retro, futuristic, and more. The prompt controls the transformation direction.
What input video formats are supported?
MP4 is the primary supported format. Source clips should be within the size and duration limits specified in the API docs.
How does Luma compare to Runway Aleph?
Both transform existing footage from prompts. Luma focuses on style transfer via the Dream Machine architecture. Runway Aleph emphasizes frame-level continuity preservation.
Da quale variante dovrei iniziare?
Scegli la variante più economica che soddisfa il tuo livello di qualità. La maggior parte dei team inizia con la variante veloce e passa alla pro per la produzione.
C’è un piano gratuito?
I nuovi account ricevono le prime chiamate gratuite su ogni modello. Dopo, paghi per chiamata.
Trasmettete i risultati in streaming?
Dove lo streaming è disponibile, RunAPI trasmette end-to-end.
Come vengono addebitati i fallimenti?
Le generazioni non riuscite non vengono addebitate.
Gli output vengono memorizzati nella cache?
Gli output generati vengono salvati e recuperabili tramite ID del task. Gli input non vengono memorizzati nella cache.
Posso usarlo a fini commerciali?
Sì — l’uso commerciale è incluso per ogni variante, salvo che una licenza del modello lo limiti esplicitamente; in tal caso è indicato nella pagina della variante.
E i limiti di rate limit?
I rate limit per chiave scalano in base al tier di utilizzo. Vedi la pagina prezzi per i limiti aggiornati.
Dove posso segnalare problemi?
Apri un issue nel repo GitHub pubblico oppure scrivi al supporto.
Se ti piace l'API Luma, prova questi
Inizia a sviluppare con l'API Luma.
- modify_video