luma-video

Luma 動画生成

AceDataCloud の Luma Dream Machine API を通じて AI 動画を生成します。

初回セットアップ

1. clawhub install @acedatacloud/luma で公式 Skill をインストールします。ClawHub の公開元が @acedatacloud であることを確認してください。
2. AceDataCloud → Applications にサインインし、General application を開いて、Luma のアクセス権、残高、現在の料金を確認します。API キーをコピーするか、Manage Keys → Create を選択して別のキーを作成します。Bearer を除いたキーの値をコピーしてください。platform-... の管理トークンはサービス API キーではありません。
3. Allowed APIs の制限を有効にする場合は、/luma/videos と /luma/tasks を含めてください。以下の高度なワークフローでは、追加のルートを呼び出す場合があります。
4. OpenClaw Gateway のホストで、~/.openclaw/.env に ACEDATACLOUD_API_TOKEN=your_api_key_here を記述し、Gateway を再起動して新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
5. 以下の クイックスタート を実行します。このワークフローがタスク ID を返した場合は、同じタスクが完了するまで照会してください。進行状況を確認するためだけに、同じ課金対象のリクエストを再送信しないでください。

キーのセットアップ、初回実行、トラブルシューティングの図解 · トークンの詳細

クイックスタート

curl -X POST https://api.acedata.cloud/luma/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a drone flying over a mountain lake at sunrise", "action": "generate", "async": true}'

非同期: 非同期タスクのポーリングを参照してください。{"id": "..."} を指定して POST /luma/tasks でポーリングします。

ワークフロー

1. テキストから動画を生成

テキストの説明だけを使って動画を生成します。

POST /luma/videos
{
  "prompt": "a timelapse of flowers blooming in a garden",
  "action": "generate",
  "aspect_ratio": "16:9",
  "loop": false,
  "enhancement": true
}

2. 画像から動画を生成

開始画像や終了画像、またはその両方の参照画像を使って生成をガイドします。

POST /luma/videos
{
  "prompt": "the scene comes alive with gentle wind",
  "action": "generate",
  "start_image_url": "https://example.com/scene.jpg",
  "end_image_url": "https://example.com/scene-end.jpg",
  "aspect_ratio": "16:9"
}

3. 動画を延長

新しいプロンプトを使って既存の動画を続けます。

POST /luma/videos
{
  "action": "extend",
  "video_id": "existing-video-id",
  "prompt": "the camera continues forward through the forest"
}

アスペクト比

比率	用途
16:9	横向き（デフォルト）— YouTube、テレビ
9:16	縦向き — TikTok、Instagram ストーリーズ
1:1	正方形 — ソーシャルメディア
4:3	クラシック — プレゼンテーション
21:9	ウルトラワイド — 映画風

パラメーター

パラメーター	型	デフォルト	説明
prompt	string	—	動画のテキスト説明（必須）
action	string	"generate"	"generate" または "extend"
aspect_ratio	string	"16:9"	動画のアスペクト比
loop	bool	false	シームレスなループを作成
enhancement	bool	true	より良い結果が得られるようプロンプトを強化
start_image_url	string	—	最初のフレームの参照画像
end_image_url	string	—	最後のフレームの参照画像
video_id	string	—	延長する動画の ID（video_url の代替）
video_url	string	—	延長する動画の URL（video_id の代替）
timeout	number	—	API がデータを返すまでのタイムアウト時間（秒）
callback_url	string	—	非同期通知用の Webhook URL

注意点

• enhancement: true（デフォルト）はプロンプトの品質を高めますが、意図を変える場合があります。プロンプトを文字どおりに反映させるには false に設定してください。
• 開始画像と終了画像の URL は、一般にアクセスできる必要があります。
• loop: true はシームレスにループする動画を作成します。背景やソーシャルメディアに適しています。
• 延長するには、以前の生成が完了した動画の video_id または video_url が必要です。
• 動画の生成には、複雑さに応じて 1〜5 分かかります。
• 開始画像と終了画像はどちらも任意です。部分的なガイドとして、どちらか一方だけを使用することもできます。

MCP: pip install mcp-luma | ホスト型: https://luma.mcp.acedata.cloud/mcp | すべての MCP サーバーを参照