Vai al contenuto principale
Con l’espansione delle applicazioni dell’IA, vari programmi di IA sono gradualmente diventati popolari. L’IA è gradualmente penetrata in ogni aspetto del lavoro e della vita delle persone. E i settori coinvolti dall’IA sono sempre più numerosi, dalla scrittura iniziale, alla medicina e all’istruzione, fino ai video di oggi. Luma è una piattaforma professionale di generazione video di alta qualità; gli utenti devono solo caricare i materiali per generare automaticamente video di alta qualità in base a diversi stili ed effetti. Questo generatore video IA è sviluppato da membri del team provenienti da note aziende tecnologiche, con l’obiettivo di consentire a tutti di creare facilmente video eccellenti senza strumenti di editing complessi. Tuttavia, Luma ufficialmente non fornisce un’API; AceDataCloud fornisce un set di API Luma, simulando l’integrazione ufficiale di Suno, che consente di generare in modo comodo e rapido i video desiderati.

​
Richiesta e utilizzo

Per utilizzare Luma Videos Generation API, prima vai alla console di Ace Data Cloud per ottenere il tuo API Token, da conservare come riserva. Se non hai ancora effettuato l’accesso o non ti sei registrato, verrai automaticamente reindirizzato alla pagina di accesso che ti inviterà a registrarti e ad accedere; al termine tornerai automaticamente alla pagina corrente. Un solo API Token può richiamare tutti i servizi della piattaforma, senza doverne richiedere uno separatamente per ogni servizio. Alla prima richiesta verrà assegnato un credito gratuito, che può essere utilizzato per una prova gratuita; quando il credito è insufficiente, puoi ricaricare il saldo universale nella console.
📘 Documentazione completa: Luma Videos Generation API →

​
Utilizzo di base

Per il video che desideri generare, puoi inserire liberamente un testo, ad esempio se voglio generare un video su astronauti che viaggiano tra lo spazio e un vulcano, posso inserire Astronauts shuttle from space to volcano, come mostrato nell’immagine:

Il codice generato è il seguente:

Principali parametri della richiesta:
  • prompt: il prompt per generare il video.
  • aspect_ratio: rapporto larghezza-altezza del video, predefinito 16:9.
  • end_image_url: facoltativo, specifica il fotogramma finale.
  • enhancement: facoltativo, interruttore di miglioramento della nitidezza.
  • loop: se generare un video in loop, predefinito false.
  • timeout: facoltativo, numero di secondi di timeout.
  • callback_url: indirizzo di callback asincrono.
  • async: facoltativo, quando impostato su true l’interfaccia restituisce immediatamente task_id, senza la necessità di fornire callback_url; successivamente il risultato viene ottenuto tramite polling attraverso l’interfaccia di query dell’attività corrispondente.
Puoi fare clic direttamente sul pulsante «Try» per testare l’API; attendi 1-2 minuti e il risultato sarà il seguente:
Si può vedere che a questo punto abbiamo ottenuto le informazioni relative a questo video, inclusi ID del video, link del video, copertina del video e altri contenuti. La descrizione dei campi è la seguente:
  • success: se la generazione ha avuto successo; se ha avuto successo è true, altrimenti è false
  • task_id: l’ID univoco dell’attività di generazione video in questo caso
  • video_id: l’ID univoco del video prodotto dall’attività di generazione video in questo caso
  • prompt: le parole chiave dell’attività di generazione video in questo caso
  • video_url: il link al video risultante dell’attività di generazione video in questo caso
  • video_height: l’altezza dell’immagine di copertina del video dopo la generazione
  • video_width: la larghezza dell’immagine di copertina del video dopo la generazione
  • state: lo stato dell’attività di generazione video in questo caso; se l’attività è completata è completed.
  • thumbnail_url: il link all’immagine di copertina del video dopo la generazione
  • thumbnail_width: la larghezza dell’immagine di copertina del video dopo la generazione
  • thumbnail_height: l’altezza dell’immagine di copertina del video dopo la generazione

​
Generazione personalizzata con fotogrammi iniziale e finale

Se desideri generare un video tramite fotogrammi iniziale e finale personalizzati, puoi inserire i link alle immagini dei fotogrammi iniziale e finale: A questo punto, nel campo start_image_url del fotogramma iniziale del video puoi passare la seguente immagine come fotogramma iniziale del video: Fotogramma iniziale Successivamente, per generare un video personalizzato in base ai fotogrammi iniziale e finale e alle parole chiave, puoi specificare i seguenti contenuti:
  • action: il comportamento dell’attività di generazione video, solitamente generazione normale generate e generazione estesa extend, il valore predefinito è generate.
  • start_image_url: specifica il fotogramma iniziale del video da generare.
  • end_image_url: specifica il fotogramma finale del video da generare.
  • prompt: il contenuto delle parole chiave per generare il video.
L’esempio di compilazione è il seguente:

Dopo aver completato la compilazione, il codice viene generato automaticamente come segue:

Il codice corrispondente:
Il risultato ottenuto è il seguente:
Il risultato finale ottenuto è simile a quello sopra; il fotogramma iniziale del video generato include l’immagine che abbiamo passato. Naturalmente, puoi anche passare contemporaneamente i link alle immagini dei fotogrammi iniziale e finale per generare il video; devi solo aggiungere un’immagine del fotogramma finale sulla base di quanto sopra. Le informazioni dell’immagine del fotogramma finale sono le seguenti: Fotogramma finale L’esempio di compilazione è il seguente:

Infine si ottiene il seguente risultato:
Il risultato è simile a quello sopra, il video generato contiene contemporaneamente le immagini del primo e dell’ultimo fotogramma, completando così la generazione di un video con primo e ultimo fotogramma personalizzati.

​
Funzionalità di estensione video

Se si desidera continuare a generare il video creato, è possibile impostare il parametro action su extend e inserire l’ID o il link del video che deve continuare a essere generato. L’ID del video e il link del video si ottengono in base all’utilizzo di base, come mostrato nell’immagine seguente:

A questo punto è possibile vedere che l’ID del video è:
Nota, qui video_id e video_url nel video sono l’ID e il link del video generato. Se non sai come generare un video, puoi fare riferimento all’utilizzo di base sopra per generare il video.
Per continuare a generare il video, è necessario caricare il link del video o l’ID del video. Di seguito viene mostrato l’utilizzo dell’ID del video per l’estensione. Successivamente dobbiamo compilare le parole chiave per personalizzare la generazione del video, ed è possibile specificare i seguenti contenuti:
  • action: il comportamento di estensione del video in questo momento, qui dovrebbe essere extend.
  • prompt: le parole chiave del video da estendere.
  • video_url: il link del video da estendere e generare.
  • video_id: l’ID univoco del video da estendere e generare.
  • end_image_url: il link dell’immagine dell’ultimo fotogramma che può essere specificato per il video generato tramite estensione, parametro facoltativo.
Un esempio di compilazione è il seguente:

Dopo aver completato la compilazione, il codice viene generato automaticamente come segue:

Il codice Python corrispondente:
Fare clic su Esegui, e si può scoprire che si otterrà un risultato come segue:
Si può vedere che questo video viene esteso sulla base del video che deve essere esteso. Il contenuto del risultato è coerente con quello sopra, realizzando così la funzionalità di continuazione della generazione della canzone. Naturalmente, possiamo anche specificare il link del video per la generazione tramite estensione, compilando le seguenti informazioni:

Dopo l’esecuzione si ottiene il seguente risultato:
Dal risultato si può vedere che la funzionalità di estensione video può essere realizzata anche tramite il link del video. Infine, possiamo anche specificare un’immagine dell’ultimo fotogramma nel video esteso per l’estensione. Di seguito sono riportate le informazioni dell’immagine dell’ultimo fotogramma: Ultimo fotogramma Successivamente, aggiungere le informazioni dell’immagine dell’ultimo fotogramma sulla base di quanto sopra, nello specifico come mostrato di seguito:

Dopo aver fatto clic su Esegui si ottengono le seguenti informazioni:
Si può vedere che, sulla base dell’estensione video sopra, è anche possibile specificare un’immagine dell’ultimo fotogramma per l’estensione.

​
Callback asincrono

Poiché il tempo di generazione del video di Luma è relativamente lungo, richiedendo circa 1-2 minuti, se l’API non risponde per molto tempo, la richiesta HTTP manterrà continuamente la connessione, causando un consumo aggiuntivo di risorse di sistema, pertanto questa API fornisce anche il supporto per i callback asincroni. Il flusso complessivo è: quando il client avvia una richiesta, specifica inoltre un campo callback_url; dopo che il client ha avviato la richiesta API, l’API restituisce immediatamente un risultato, contenente le informazioni del campo task_id, che rappresenta l’ID dell’attività corrente. Quando l’attività è completata, il risultato della generazione della musica verrà inviato tramite POST JSON al callback_url specificato dal client, includendo anch’esso il campo task_id, in modo che il risultato dell’attività possa essere associato tramite l’ID. Di seguito capiremo come operare concretamente attraverso un esempio. Innanzitutto, il callback Webhook è un servizio in grado di ricevere richieste HTTP; gli sviluppatori dovrebbero sostituirlo con l’URL del server HTTP che hanno configurato personalmente. Per comodità di dimostrazione, qui viene utilizzato un sito di esempio Webhook pubblico https://webhook.site/; aprendo questo sito è possibile ottenere un URL Webhook, come mostrato nell’immagine:

Copia questo URL e potrà essere utilizzato come Webhook; l’esempio qui è https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13。 Successivamente, possiamo impostare il campo callback_url sull’URL Webhook sopra indicato e compilare contemporaneamente prompt, come mostrato nell’immagine:

Fai clic su esegui e potrai notare che viene immediatamente ottenuto un risultato, come segue:
Dopo aver atteso qualche istante, possiamo osservare il risultato della generazione della canzone su https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, come mostrato nell’immagine: Il contenuto è il seguente:
Si può vedere che nel risultato è presente un campo task_id; gli altri campi sono simili a quelli sopra, e tramite questo campo è possibile realizzare l’associazione dell’attività.