Luma API
Dream Machineを使ったビデオ修正・変換向けにLuma APIにアクセスできます。
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": "このオフィスウォークスルー動画をサイバーパンク風のネオンライトに変換し、元のカメラの動きを維持してください。"
}'
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: "このオフィスウォークスルー動画をサイバーパンク風のネオンライトに変換し、元のカメラの動きを維持してください。",
});
<?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' => 'このオフィスウォークスルー動画をサイバーパンク風のネオンライトに変換し、元のカメラの動きを維持してください。',
]);
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: "このオフィスウォークスルー動画をサイバーパンク風のネオンライトに変換し、元のカメラの動きを維持してください。"
)
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の動画修正モデルは、ソースクリップのモーションと時系列構造を保持しながら、新しい視覚スタイルやシーン変更で既存の映像を変換します。
- 品質とレイテンシ目標に合わせたモデルバリアント
- 統合 API key
- Model skill に docs、schema、セットアップメモを同梱
- 失敗した生成は課金されません
料金
仕様
| モデル ID | luma-modify-video |
| プロバイダー | Luma |
| モダリティ | video |
| タスク種別 | asynchronous |
| 課金 | call |
| Endpoint | /api/v1/luma/modify_video |
| 商用利用 | はい |
| カタログステータス | 稼働中 |
アプリ開発用に Luma skill をインストール
モデル docs、schema、料金メモ、セットアップ手順をコード作業環境に読み込みます。
# 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 key を使います。
skill をインストール
機能実装の前に model skill をコード作業環境へ追加します。
出力を受け取る
task ID でポーリングするか、生成完了時の callback を処理します。
Luma の位置づけ
Luma AIのDream Machineモデルはモーションを保持しながら視覚スタイルを変換することで既存の動画を修正します。RunAPI経由では、統合されたAPIアクセスと呼び出し単位の課金を共有します。
RunAPI 経由で Luma を使う理由
1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
Skill-ready
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
予測しやすい請求
呼び出し前に従量料金を確認できます。
よくある質問
動画修正とは何ですか?
Lumaのmodify-videoエンドポイントは既存の映像を受け取り、元のモーションとカメラの動態を保持しながら、テキストプロンプトに基づいてその視覚スタイルとコンテンツを変換します。
元のモーションは保持されますか?
はい — カメラの動き、被写体のモーション、ソース動画の時系列構造が維持されます。変わるのは視覚スタイルと外観のみです。
どのようなスタイルを適用できますか?
テキストで表現できるあらゆるスタイル — シネマチック、アニメ、絵画風、ノワール、レトロ、フューチャリスティックなど。プロンプトで変換の方向を制御します。
サポートされている入力動画フォーマットは?
MP4が主要なサポートフォーマットです。ソースクリップはAPIドキュメントに記載されたサイズと尺の制限内にしてください。
LumaとRunway Alephはどう違いますか?
どちらもプロンプトから既存の映像を変換します。LumaはDream Machineアーキテクチャによるスタイル転送に焦点を当てています。Runway Alephはフレームレベルの連続性の保持を重視しています。
このモデルはどう呼び出しますか?
model skill をインストールし、RunAPI key とセットアップメモに従ってください。
失敗した生成は課金されますか?
失敗した生成は課金されません
アプリケーションから呼び出せますか?
はい。コード作業環境に model skill をインストールし、モデル機能を追加するときに利用してください。
Luma で構築を開始。
- modify_video