Hoppa till huvudinnehåll
I takt med att AI används allt mer har olika AI-program gradvis blivit vanliga. AI har successivt fördjupats i alla aspekter av människors arbetsliv och vardag. Branscherna som AI omfattar blir också fler och fler, från det ursprungliga skrivandet till sjukvård och utbildning, och nu till video. Luma är en professionell plattform för högkvalitativ videogenerering. Användare behöver bara ladda upp material för att automatiskt generera högkvalitativa videor enligt olika stilar och effekter. Denna AI-videogenerator har utvecklats av teammedlemmar från välkända teknikföretag, med målet att låta alla enkelt skapa enastående videor utan komplexa redigeringsverktyg. Luma erbjuder dock inte officiellt något API. AceDataCloud erbjuder en uppsättning API:er för Luma som simulerar integration med Suno officiellt, vilket gör det möjligt att enkelt och snabbt generera önskade videor.

​
Ansökan och användning

För att använda Luma Videos Generation API ska du först hämta din API-token i Ace Data Cloud-konsolen och spara den för senare användning. Om du ännu inte har loggat in eller registrerat dig omdirigeras du automatiskt till inloggningssidan för att registrera och logga in, och när det är klart återgår du automatiskt till den aktuella sidan. En API-token kan anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst. Vid första ansökan får du kostnadsfri kredit för att testa gratis; när krediten inte räcker till kan du fylla på det gemensamma saldot i konsolen.
📘 Fullständig dokumentation: Luma Videos Generation API →

​
Grundläggande användning

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

Den genererade koden är följande:

Huvudsakliga begärandeparametrar:
  • prompt: Prompten för att generera video.
  • aspect_ratio: Videons bildförhållande, standard är 16:9.
  • end_image_url: Valfritt, anger slutbildrutan.
  • enhancement: Valfritt, omkopplare för skärpeförbättring.
  • loop: Om en loopande video ska genereras, standard är false.
  • timeout: Valfritt, antal sekunder för timeout.
  • callback_url: Asynkron callback-adress.
  • async: Valfritt, när det sätts till true returnerar gränssnittet omedelbart task_id, utan att callback_url behöver anges, och resultatet hämtas sedan genom polling via motsvarande gränssnitt för uppgiftsfrågor.
Du kan klicka på knappen ”Try” för att direkt testa API:et. Vänta 1–2 minuter, så blir resultatet följande:
Här kan vi se att vi nu har fått den relaterade informationen om denna video, inklusive video-ID, videolänk, videons omslagsbild och annat innehåll. Fältbeskrivningarna är följande:
  • success: Om genereringen lyckades, true om den lyckades, annars false
  • task_id: Det unika ID:t för videogenereringsuppgiften här
  • video_id: Det unika ID:t för videon som produceras av videogenereringsuppgiften här
  • prompt: Nyckelorden för videogenereringsuppgiften här
  • video_url: Länken till resultatvideon för videogenereringsuppgiften här
  • video_height: Höjden på den genererade videons omslagsbild
  • video_width: Bredden på den genererade videons omslagsbild
  • state: Statusen för videogenereringsuppgiften här, completed om uppgiften är klar.
  • thumbnail_url: Länken till den genererade videons omslagsbild
  • thumbnail_width: Bredden på den genererade videons omslagsbild
  • thumbnail_height: Höjden på den genererade videons omslagsbild

​
Anpassad generering med start- och slutbildruta

Om du vill generera en video genom att anpassa videons start- och slutbildruta kan du ange bildlänkarna för start- och slutbildrutorna: Vid denna tidpunkt kan fältet start_image_url för videons startbildruta ta emot följande bild som videons startbildruta: Startbildruta Därefter kan vi ange följande innehåll för att anpassa videogenerering baserat på start- och slutbildruta samt nyckelord:
  • action: Beteendet för videogenereringsuppgiften, vanligtvis vanlig generering generate och utökad generering extend, standard är generate.
  • start_image_url: Anger startbildrutan för den genererade videon.
  • end_image_url: Anger slutbildrutan för den genererade videon.
  • prompt: Nyckelordsinnehållet för att generera video.
Exempel på ifyllnad är följande:

När ifyllningen är klar genereras följande kod automatiskt:

Motsvarande kod:
Det erhållna resultatet är följande:
Det slutliga resultatet liknar det ovanstående. Den genererade videons startbildruta innehåller bilden som vi skickade in. Det går naturligtvis också att samtidigt skicka in bildlänkar för start- och slutbildrutor för att generera en video, du behöver bara lägga till ytterligare en slutbildruta ovanpå det tidigare innehållet. Bildinformationen för slutbildrutan är följande: Slutbildruta Exempel på ifyllnad är följande:

Slutligen erhålls följande resultat:
Resultatet liknar det ovan, och den genererade videon innehåller både bilden för den första bildrutan och den sista bildrutan, vilket slutför genereringen av en video med anpassade första och sista bildrutor.

​
Videoutvidgningsfunktion

Om du vill fortsätta generera den skapade videon kan du ange parametern action till extend och ange ID:t eller videolänken för videon som behöver fortsätta genereras. Video-ID:t och videolänken hämtas enligt den grundläggande användningen, som visas i bilden nedan:

Vid denna tidpunkt kan du se att videons ID är:
Observera att video_id och video_url i videon här är ID:t och videolänken för den genererade videon. Om du inte vet hur man genererar en video kan du läsa den grundläggande användningen ovan för att generera en video.
För att fortsätta generera en video måste du ladda upp videolänken eller videons ID. Nedan demonstreras hur man använder video-ID:t för utvidgning. Därefter måste vi fylla i nyckelord för att anpassa den genererade videon, och följande innehåll kan anges:
  • action: Beteendet för att utvidga videon vid denna tidpunkt, vilket här ska vara extend.
  • prompt: Nyckelord för videon som behöver utvidgas.
  • video_url: Länken till videon som behöver utvidgas.
  • video_id: Det unika ID:t för videon som behöver utvidgas.
  • end_image_url: Bildlänken för den sista bildrutan som kan anges vid utvidgning av videon, valfri parameter.
Ett exempel på ifyllning är följande:

Efter ifyllning genereras följande kod automatiskt:

Motsvarande Python-kod:
Klicka på kör, så kan du se att följande resultat erhålls:
Det kan ses att videon utvidgas baserat på videon som behöver utvidgas, och resultatinnehållet överensstämmer med det ovan, vilket också implementerar funktionen för fortsatt generering av låtar. Naturligtvis kan vi också ange videons länk för att generera en utvidgning, fyll i följande information:

Efter körning erhålls följande resultat:
Baserat på resultatet kan man se att videoutvidgningsfunktionen även kan implementeras genom videolänken. Slutligen kan vi också ange en bild för den sista bildrutan i den utvidgade videon för utvidgning. Nedan finns bildinformationen för den sista bildrutan: Sista bildruta Lägg sedan till bildinformationen för den sista bildrutan på grundval av ovanstående, enligt följande:

Efter att ha klickat på kör erhålls följande information:
Det kan ses att en bild för den sista bildrutan också kan anges för utvidgning på grundval av videoutvidgningen ovan.

​
Asynkron återuppringning

Eftersom Luma tar relativt lång tid att generera videor, ungefär 1–2 minuter, kommer HTTP-begäran att fortsätta hålla anslutningen om API:t inte svarar under lång tid, vilket leder till ytterligare förbrukning av systemresurser. Därför tillhandahåller detta API även stöd för asynkron återuppringning. Den övergripande processen är: när klienten initierar en begäran anges dessutom ett fält callback_url. Efter att klienten har initierat API-begäran returnerar API:et omedelbart ett resultat som innehåller fältet task_id, vilket representerar ID:t för den aktuella uppgiften. När uppgiften är slutförd skickas resultatet av den genererade musiken i form av POST JSON till den callback_url som klienten har angett, vilket också inkluderar fältet task_id, så att uppgiftsresultatet kan kopplas samman via ID:t. Nedan använder vi ett exempel för att förstå hur det fungerar i praktiken. Först är Webhook-återanrop en tjänst som kan ta emot HTTP-begäranden. Utvecklare bör ersätta den med URL:en till sin egen HTTP-server. För att underlätta demonstrationen används här en offentlig exempelwebbplats för Webhook, https://webhook.site/. Öppna webbplatsen 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 ange fältet callback_url som ovanstående Webhook-URL och samtidigt fylla i prompt, som visas i bilden:

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