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 伺服器