Luma動画生成
AceDataCloudのLuma Dream Machine APIを使用してAI動画を生成します。
セットアップ: トークン設定については認証を参照してください。
クイックスタート
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", "callback_url": "https://api.acedata.cloud/health"}'
非同期: 非同期タスクポーリングを参照してください。
POST /luma/tasksに{"task_id": "..."}を送信してポーリングします。
ワークフロー
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サーバー を参照