Skip to main content
Mit der zunehmenden Anwendung von KI haben sich verschiedene KI-Programme allmählich verbreitet. KI hat sich zunehmend in alle Aspekte des Arbeits- und Lebensalltags der Menschen integriert. Die Branchen, die von KI betroffen sind, werden ebenfalls immer vielfältiger, von anfänglichem Schreiben über Gesundheitswesen und Bildung bis hin zu Videos. Luma ist eine professionelle Plattform zur Generierung hochwertiger Videos. Benutzer müssen lediglich Materialien hochladen, um automatisch hochwertige Videos in verschiedenen Stilen und Effekten zu erstellen. Dieser KI-Video-Generator wurde von einem Teammitglied eines bekannten Technologieunternehmens entwickelt, mit dem Ziel, dass jeder ohne komplexe Bearbeitungswerkzeuge mühelos herausragende Videos erstellen kann. Allerdings bietet Luma offiziell keine API an. AceDataCloud stellt eine API für Luma zur Verfügung, die die offizielle Suno-Integration simuliert und es ermöglicht, schnell und einfach die gewünschten Videos zu generieren.

​
Antrag und Nutzung

Um die Luma Videos Generation API zu nutzen, müssen Sie zunächst Ihr API-Token im Ace Data Cloud Dashboard abrufen und für zukünftige Verwendung aufbewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um alle Dienste der Plattform zu nutzen, ohne dass für jeden Dienst separat ein Antrag gestellt werden muss. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent zur kostenlosen Nutzung; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.
📘 Vollständige Dokumentation: Luma Videos Generation API →

​
Grundlegende Nutzung

Um ein Video zu generieren, können Sie beliebigen Text eingeben. Wenn ich beispielsweise ein Video über Astronauten, die zwischen dem Weltraum und einem Vulkan pendeln, generieren möchte, kann ich Astronauts shuttle from space to volcano eingeben, wie im Bild gezeigt:

Der generierte Code sieht wie folgt aus:

Wichtige Anfrageparameter:
  • prompt: Der Hinweistext zur Generierung des Videos.
  • aspect_ratio: Das Seitenverhältnis des Videos, standardmäßig 16:9.
  • end_image_url: Optional, um das Endbild anzugeben.
  • enhancement: Optional, Schalter zur Verbesserung der Klarheit.
  • loop: Ob ein Schleifenvideo generiert werden soll, standardmäßig false.
  • timeout: Optional, Zeitüberschreitung in Sekunden.
  • callback_url: Asynchrone Rückrufadresse.
  • async: Optional, wenn auf true gesetzt, gibt die Schnittstelle sofort task_id zurück, ohne dass callback_url bereitgestellt werden muss. Anschließend kann das Ergebnis über die entsprechende Abfrage-Schnittstelle abgefragt werden.
Sie können auf die Schaltfläche „Try“ klicken, um die API direkt zu testen. Warten Sie 1-2 Minuten, das Ergebnis sieht wie folgt aus:
Hier sehen wir, dass wir die relevanten Informationen zu diesem Video erhalten haben, einschließlich Video-ID, Video-Link, Video-Vorschaubild und mehr. Die Feldbeschreibung ist wie folgt:
  • success: Ob die Generierung erfolgreich war, wenn erfolgreich, dann true, andernfalls false
  • task_id: Die eindeutige ID dieser Video-Generierungsaufgabe
  • video_id: Die eindeutige ID des Videos, das aus dieser Video-Generierungsaufgabe erstellt wurde
  • prompt: Die Schlüsselwörter dieser Video-Generierungsaufgabe
  • video_url: Der Link zum Ergebnisvideo dieser Video-Generierungsaufgabe
  • video_height: Die Höhe des generierten Vorschaubildes des Videos
  • video_width: Die Breite des generierten Vorschaubildes des Videos
  • state: Der Status dieser Video-Generierungsaufgabe, wenn die Aufgabe abgeschlossen ist, dann completed.
  • thumbnail_url: Der Link zum generierten Vorschaubild des Videos
  • thumbnail_width: Die Breite des generierten Vorschaubildes des Videos
  • thumbnail_height: Die Höhe des generierten Vorschaubildes des Videos

​
Benutzerdefinierte Start- und Endbilder generieren

Wenn Sie ein Video durch benutzerdefinierte Start- und Endbilder generieren möchten, können Sie die Links zu den Bildern der Start- und Endbilder eingeben: In diesem Fall kann das Startbild im Feld start_image_url mit folgendem Bild als Startbild des Videos übergeben werden: Startbild Als Nächstes möchten wir basierend auf den Start- und Endbildern sowie den Schlüsselwörtern ein Video benutzerdefiniert generieren. Wir können die folgenden Inhalte angeben:
  • action: Die Aktion der Video-Generierungsaufgabe, normalerweise ist es die normale Generierung generate und die erweiterte Generierung extend, standardmäßig generate.
  • start_image_url: Gibt das Startbild des zu generierenden Videos an.
  • end_image_url: Gibt das Endbild des zu generierenden Videos an.
  • prompt: Die Schlüsselwörter zur Generierung des Videos.
Ein Beispiel für die Eingabe sieht wie folgt aus:

Nach dem Ausfüllen wurde automatisch der folgende Code generiert:

Der entsprechende Code:
Das erhaltene Ergebnis sieht wie folgt aus:
Das letztendlich erhaltene Ergebnis ist ähnlich wie das oben, das generierte Video-Startbild enthält das Bild, das wir übergeben haben. Natürlich können auch gleichzeitig Links zu Start- und Endbildern übergeben werden, um ein Video zu generieren. Sie müssen lediglich ein Endbild hinzufügen, das die Bildinformationen wie folgt enthält: Endbild Ein Beispiel für die Eingabe sieht wie folgt aus:

Das Ergebnis lautet wie folgt:
Das Ergebnis ist ähnlich wie oben, das generierte Video enthält sowohl das erste als auch das letzte Bild, was die benutzerdefinierte Erstellung von Anfangs- und Endbildern zur Videoerstellung abschließt.

​
Videoerweiterungsfunktion

Wenn Sie das generierte Video weiter erstellen möchten, können Sie den Parameter action auf extend setzen und die ID oder den Link des Videos eingeben, die Video-ID und der Video-Link können basierend auf der grundlegenden Nutzung abgerufen werden, wie im folgenden Bild gezeigt:

Hier können Sie die Video-ID sehen:
Hinweis: Hier sind die video_id und video_url des Videos nach der Erstellung, wenn Sie nicht wissen, wie man ein Video erstellt, können Sie sich auf die grundlegende Nutzung oben beziehen, um ein Video zu erstellen.
Um das Video weiter zu erstellen, müssen Sie den Video-Link oder die Video-ID hochladen. Im Folgenden wird die Verwendung der Video-ID zur Erweiterung demonstriert. Als nächstes müssen wir Schlüsselwörter ausfüllen, um das Video benutzerdefiniert zu erstellen, und können die folgenden Inhalte angeben:
  • action: In diesem Fall die Aktion zur Erweiterung des Videos, hier sollte es extend sein.
  • prompt: Die Schlüsselwörter, die das Video erweitern sollen.
  • video_url: Der Link des Videos, das erweitert werden soll.
  • video_id: Die eindeutige ID des Videos, das erweitert werden soll.
  • end_image_url: Der Link zum Bild des Endbildes, das für die Erweiterung angegeben werden kann, optional.
Das ausgefüllte Beispiel sieht wie folgt aus:

Nach dem Ausfüllen wird automatisch der folgende Code generiert:

Entsprechender Python-Code:
Wenn Sie auf Ausführen klicken, können Sie ein Ergebnis erhalten, wie folgt:
Es ist zu erkennen, dass dieses Video auf dem benötigten erweiterten Video basiert, der Inhalt des Ergebnisses ist identisch mit dem oben, was die Funktion zur weiteren Erstellung von Songs realisiert. Natürlich können wir auch den Link des Videos angeben, um die Erweiterung zu erstellen, indem wir die folgenden Informationen ausfüllen:

Nach dem Ausführen erhalten Sie das folgende Ergebnis:
Anhand des Ergebnisses ist zu erkennen, dass auch die Funktion zur Erweiterung des Videos basierend auf dem Video-Link realisiert werden kann. Zuletzt können wir auch ein Endbild für das erweiterte Video angeben, um die Erweiterung durchzuführen. Hier sind die Informationen zum Endbild: Endbild Als nächstes fügen wir auf der Grundlage der obigen Informationen die Endbildinformationen hinzu, wie folgt:

Wenn Sie auf Ausführen klicken, erhalten Sie die folgenden Informationen:
Es ist zu erkennen, dass auf der Grundlage des oben erweiterten Videos auch ein Endbild angegeben werden kann, um die Erweiterung durchzuführen.

​
Asynchrone Rückrufe

Da die Erstellung von Videos mit Luma relativ lange dauert, etwa 1-2 Minuten, wird die HTTP-Anfrage bei langem Warten auf eine Antwort die Verbindung aufrechterhalten, was zu einem zusätzlichen Verbrauch von Systemressourcen führt. Daher bietet diese API auch Unterstützung für asynchrone Rückrufe. Der gesamte Prozess ist: Wenn der Client eine Anfrage stellt, gibt er zusätzlich ein Feld callback_url an. Nachdem der Client die API-Anfrage gestartet hat, gibt die API sofort ein Ergebnis zurück, das ein Feld mit der task_id-Information enthält, das die aktuelle Aufgaben-ID darstellt. Wenn die Aufgabe abgeschlossen ist, wird das Ergebnis der Musikgenerierung in Form von POST JSON an die vom Client angegebene callback_url gesendet, wobei auch das Feld task_id enthalten ist, sodass die Aufgabenergebnisse über die ID miteinander verknüpft werden können. Lassen Sie uns anhand eines Beispiels verstehen, wie dies konkret funktioniert. Zunächst ist der Webhook-Callback ein Dienst, der HTTP-Anfragen empfangen kann. Entwickler sollten die URL ihres eigenen eingerichteten HTTP-Servers ersetzen. Hier verwenden wir zur Demonstration eine öffentliche Webhook-Beispielwebsite https://webhook.site/, auf der Sie eine Webhook-URL erhalten können, wie im Bild gezeigt:

Kopieren Sie diese URL, um sie als Webhook zu verwenden. Das Beispiel hier ist https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Als Nächstes können wir das Feld callback_url auf die oben genannte Webhook-URL setzen und prompt ausfüllen, wie im Bild gezeigt:

Klicken Sie auf Ausführen, und Sie werden sofort ein Ergebnis erhalten, wie folgt:
Warten Sie einen Moment, und wir können das Ergebnis des generierten Songs auf https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13 beobachten, wie im Bild gezeigt: Der Inhalt lautet:
Man kann sehen, dass im Ergebnis ein Feld task_id vorhanden ist, und die anderen Felder sind ähnlich wie oben, sodass die Aufgaben über dieses Feld verknüpft werden können.