Luma Video Generation
Generiere KI-Videos über die Luma Dream Machine API von AceDataCloud.
Einrichtung: Siehe Authentifizierung zur Token-Einrichtung.
Schnellstart
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"}'
Asynchron: Siehe async task polling. Abfrage über
POST /luma/tasksmit{"task_id": "..."}.
Workflows
1. Text-zu-Video
Erzeuge ein Video direkt aus einer Textbeschreibung.
POST /luma/videos
{
"prompt": "a timelapse of flowers blooming in a garden",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
2. Bild-zu-Video
Verwende Start- und/oder Endreferenzbilder, um die Generierung zu steuern.
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. Video verlängern
Setze ein bestehendes Video mit einer neuen Aufforderung fort.
POST /luma/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "the camera continues forward through the forest"
}
Seitenverhältnisse
| Verhältnis | Anwendungsfall |
|---|---|
16:9 | Querformat (Standard) — YouTube, TV |
9:16 | Hochformat — TikTok, Instagram Stories |
1:1 | Quadratisch — Soziale Medien |
4:3 | Klassisch — Präsentationen |
21:9 | Ultrabreit — Kinofilme |
Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
prompt | string | — | Textbeschreibung des Videos (erforderlich) |
action | string | "generate" | "generate" oder "extend" |
aspect_ratio | string | "16:9" | Seitenverhältnis des Videos |
loop | bool | false | Nahtlose Schleife erstellen |
enhancement | bool | true | Prompt für bessere Ergebnisse verbessern |
start_image_url | string | — | Referenzbild für das erste Bild |
end_image_url | string | — | Referenzbild für das letzte Bild |
video_id | string | — | ID des zu verlängernden Videos (Alternative zu video_url) |
video_url | string | — | URL des zu verlängernden Videos (Alternative zu video_id) |
timeout | number | — | Timeout in Sekunden für die API-Rückgabe |
callback_url | string | — | Webhook-URL für asynchrone Benachrichtigungen |
Fallstricke
enhancement: true(Standard) verbessert die Prompt-Qualität, kann aber deine Absicht verändern – setze sie auffalsefür wörtliche Prompts- Start-/Endbild-URLs müssen öffentlich zugänglich sein
loop: trueerzeugt ein nahtloses Schleifenvideo – gut für Hintergründe und soziale Medien- Zum Verlängern wird entweder
video_idodervideo_urlaus einer zuvor abgeschlossenen Generierung benötigt - Die Videogenerierung dauert je nach Komplexität 1–5 Minuten
- Sowohl Start- als auch Endbilder sind optional – du kannst nur eines für eine teilweise Steuerung verwenden
MCP:
pip install mcp-luma| Gehostet:https://luma.mcp.acedata.cloud/mcp| Siehe alle MCP-Server