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 angeAstronauts shuttle from space to volcano, som visas nedan:


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 tilltrueför att omedelbart få tillbakatask_id, utan att behöva angecallback_url, och sedan kan du använda motsvarande uppgiftsfråge-API för att hämta resultatet.
- success: Om genereringen var framgångsrik, om framgång, då
true, annarsfalse - 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 bildstart_image_url ta emot följande bild som den första bilden i videon:
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
generateoch utvidgad genereringextend, standard ärgenerate. - 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:

Videoutvidgningsfunktion
Om du vill fortsätta generera videon kan du ställa in parameternaction 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:

Observera att videon härFö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:video_idochvideo_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.
- 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.



Därefter lägger vi till information om sista bildrutan på ovanstående grund, specifikt som följer:

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 extracallback_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:

callback_url till ovanstående Webhook-URL, samtidigt som vi fyller i prompt, som visas i bilden:

Innehållet är som följer:
task_id fält, och de andra fälten liknar de som nämndes ovan, genom detta fält kan uppdraget kopplas ihop.
