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 cursor
Luma 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.
- عدة إصدارات لمستويات مختلفة من السرعة / الجودة
- يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
- يعمل مع workflows موجهة لتطوير التطبيقات
- لا يتم احتساب رسوم على عمليات التوليد الفاشلة
التسعير
التفاصيل الفنية
| معرّف النموذج | luma-modify-video |
| المزوّد | Luma |
| الوسيط | video |
| نوع المهمة | asynchronous |
| وحدة الفوترة | call |
| API endpoint | /api/v1/luma/modify_video |
| ترخيص تجاري | نعم — مشمول عبر API |
| حالة الكتالوج | جاهز للتشغيل |
ثبّت skill Luma لتطوير التطبيقات
حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.
# Install the model skill for app development workflows
npx skills add runapi-ai/luma -g
Install 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.
من model skill إلى أول نتيجة في أربع خطوات
اختر النموذج
اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.
الإعداد
اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.
التنفيذ
استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.
الاستلام
استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.
ما هي Luma API؟
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.
لماذا تستخدم Luma API عبر RunAPI
مصادقة واحدة لكل مزود
مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.
تسعير وفوترة موحّدان
تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.
Skill مع schemas
تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.
أسئلة شائعة
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.
أي نسخة ينبغي أن أبدأ بها؟
اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.
هل توجد خطة مجانية؟
تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.
هل تدعمون البث المباشر للنتائج؟
حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.
كيف يتم احتساب الرسوم عند الفشل؟
لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.
هل يتم تخزين المخرجات مؤقتًا؟
يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.
هل يمكنني الاستخدام تجاريًا؟
نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.
ماذا عن حدود المعدل؟
تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.
أين يمكنني الإبلاغ عن المشاكل؟
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.
إذا أعجبتك Luma API، فجرّب هذه الخيارات
ابدأ البناء باستخدام Luma API.
- modify_video