Skip to main content
Med den ökande användningen av AI har olika AI-program gradvis blivit vanliga. AI har gradvis trängt in i alla aspekter av människors arbetsliv. Och branscherna som involverar AI blir allt fler, från den ursprungliga skrivningen, till medicinsk utbildning, och nu till video. Luma är en professionell plattform för videoproduktion av hög kvalitet, där användare bara behöver ladda upp material för att automatiskt generera högkvalitativa videor baserat på olika stilar och effekter. Denna AI-videoproducent har utvecklats av teammedlemmar från kända teknikföretag, med målet att göra det möjligt för alla att enkelt skapa fantastiska videor utan komplicerade redigeringsverktyg. Men Luma erbjuder officiellt ingen API, AceDataCloud tillhandahåller en uppsättning Luma API:er som simulerar integrationen med Suno officiellt, vilket gör det enkelt och snabbt att generera önskade videor.

Ansökan och användning

För att använda Luma Videos Generation API, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du kan spara för framtida bruk. Om du inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan där du uppmanas att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token kan användas för att anropa alla tjänster på plattformen, utan att behöva ansöka om varje tjänst separat. Första gången du ansöker får du en gratis kvot för att prova; om kvoten är otillräcklig kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: Luma Videos Generation API →

Grundläggande användning

För att generera en video kan du ange en text, till exempel om jag vill generera en video om astronauter som färdas mellan rymden och vulkaner, kan jag ange Astronauts shuttle from space to volcano, som visas nedan:

Den genererade koden ser ut som följer:

Huvudsakliga begärningsparametrar:
  • prompt: Frågan för att generera videon.
  • aspect_ratio: Videons bredd-höjd-förhållande, standard 16:9.
  • end_image_url: Valfritt, specificera slutbild.
  • enhancement: Valfritt, skärpeförbättringsbyte.
  • loop: Om videon ska vara en loop, standard false.
  • timeout: Valfritt, tidsgräns i sekunder.
  • callback_url: Asynkron återkopplingsadress.
  • async: Valfritt, sätt till true för att omedelbart få tillbaka task_id, utan att behöva ange callback_url, och sedan kan du använda motsvarande uppgiftsfråge-API för att hämta resultatet.
Du kan klicka på “Try” knappen för att direkt testa API:et, vänta 1-2 minuter, resultatet blir följande:
Vi kan se att vi nu har fått information om denna video, inklusive video-ID, videolänk, videoförhandsvisning och så vidare. Fälten förklaras nedan:
  • success: Om genereringen var framgångsrik, om framgång, då true, annars false
  • task_id: Det unika ID:t för denna videogenereringsuppgift
  • video_id: Det unika ID:t för videon som genererades av denna uppgift
  • prompt: Nyckelordet för denna videogenereringsuppgift
  • video_url: Länken till resultatvideon för denna videogenereringsuppgift
  • video_height: Höjden på den genererade videoförhandsvisningsbilden
  • video_width: Bredden på den genererade videoförhandsvisningsbilden
  • state: Statusen för denna videogenereringsuppgift, om uppgiften är slutförd, då completed.
  • thumbnail_url: Länken till den genererade videoförhandsvisningsbilden
  • thumbnail_width: Bredden på den genererade videoförhandsvisningsbilden
  • thumbnail_height: Höjden på den genererade videoförhandsvisningsbilden

Anpassad generering av första och sista bild

Om du vill generera en video genom att anpassa första och sista bild, kan du ange länkarna till bilderna: I detta fall kan fältet för videons första bild start_image_url ta emot följande bild som den första bilden i videon: Första bild Därefter vill vi anpassa videon baserat på första och sista bild, samt nyckelord, kan vi specificera följande innehåll:
  • action: Beteendet för videogenereringsuppgiften, vanligtvis är det vanlig generering generate och utvidgad generering extend, standard är generate.
  • start_image_url: Specificera den första bilden för den genererade videon.
  • end_image_url: Specificera den sista bilden för den genererade videon.
  • prompt: Nyckelordet för att generera videon.
Exempel på ifyllning nedan:

När du har fyllt i det, genereras koden automatiskt som följer:

Motsvarande kod:
Resultatet blir följande:
Det slutliga resultatet liknar det ovan, den genererade videons första bild innehåller den bild vi angav, och självklart kan vi också ange länkar till både första och sista bild för att generera videon, vi behöver bara lägga till en sista bildlänk ovanpå det som redan finns, informationen om sista bilden är följande: Sista bild Exempel på ifyllning nedan:

Slutligen får vi följande resultat:
Resultatet är liknande det ovan, den genererade videon innehåller både första och sista bildrutan, vilket också slutför anpassningen av första och sista bildrutor för att generera videon.

Videoutvidgningsfunktion

Om du vill fortsätta generera videon kan du ställa in parametern action till extend och ange ID:t eller videolänken för den video som ska fortsätta genereras. Videons ID och videolänk kan hämtas enligt grundläggande användning, som visas i bilden nedan:

Vid det här laget kan vi se att videons ID är:
Observera att videon här video_id och video_url är ID:t och länken för den genererade videon. Om du inte vet hur man genererar en video kan du hänvisa till den grundläggande användningen ovan för att generera videon.
För att fortsätta generera videon måste du ladda upp videolänken eller videons ID. Nedan visas hur man använder videons ID för att göra en utvidgning. Vi måste fylla i nyckelord för att anpassa den genererade videon, så vi kan specificera följande innehåll:
  • action: Detta är beteendet för att utvidga videon, vilket här ska vara extend.
  • prompt: Nyckelordet för att utvidga videon.
  • video_url: Länken till videon som ska utvidgas.
  • video_id: Det unika ID:t för videon som ska utvidgas.
  • end_image_url: Länken till bilden för sista bildrutan som kan specificeras för att utvidga videon, valfri parameter.
Exempel på ifyllning:

När ifyllningen är klar genereras koden automatiskt som följer:

Motsvarande Python-kod:
När du klickar på körning kan du se att du får ett resultat som följer:
Det kan ses att videon är en utvidgning av den video som behöver utvidgas, resultatinnehållet är detsamma som ovan, vilket också realiserar funktionen för fortsatt generering av låtar. Självklart kan vi också specificera videolänken för att göra en utvidgning, fyll i följande information:

När du kör det får du följande resultat:
Enligt resultatet kan vi se att videoutvidgning också kan realiseras baserat på videolänken. Slutligen kan vi också specificera en bild för sista bildrutan i den utvidgade videon för att göra en utvidgning. Här är informationen om sista bildrutan: Sista bildrutan Därefter lägger vi till information om sista bildrutan på ovanstående grund, specifikt som följer:

När du klickar på körning får du följande information:
Det kan ses att på grundval av den utvidgade videon ovan kan vi också specificera en bild för sista bildrutan för att göra en utvidgning.

Asynkron återkoppling

Eftersom Luma-genereringen av videor tar relativt lång tid, cirka 1-2 minuter, om API:et inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning. Därför erbjuder detta API också stöd för asynkron återkoppling. Det övergripande flödet är: När klienten initierar en begäran, specificerar den ett extra callback_url fält. Efter att klienten har initierat API-begäran kommer API:t omedelbart att returnera ett resultat som innehåller ett task_id fält, vilket representerar det aktuella uppdragets ID. När uppdraget är slutfört kommer resultatet av musiken att skickas till klientens angivna callback_url i POST JSON-format, vilket också inkluderar task_id fältet, så att uppdragets resultat kan kopplas ihop med ID:t. Nedan går vi igenom ett exempel för att förstå hur man gör detta. Först är Webhook-återkopplingen en tjänst som kan ta emot HTTP-begäran, utvecklaren bör ersätta med URL:en till sin egen uppsatta HTTP-server. Här för att underlätta demonstration använder vi en offentlig Webhook-exempelsida https://webhook.site/, öppna denna webbplats för att få en Webhook-URL, som visas i bilden:

Kopiera denna URL, så kan den användas som Webhook, exemplet här är https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Därefter kan vi ställa in fältet callback_url till ovanstående Webhook-URL, samtidigt som vi fyller i prompt, som visas i bilden:

Klicka på kör, och vi kan se att vi omedelbart får ett resultat, som följer:
Vänta en stund, så kan vi observera resultatet av den genererade låten på https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, som visas i bilden: Innehållet är som följer:
Vi kan se att resultatet innehåller ett task_id fält, och de andra fälten liknar de som nämndes ovan, genom detta fält kan uppdraget kopplas ihop.