Skip to main content
Con l’espansione dell’uso dell’AI, vari programmi AI sono diventati sempre più comuni. L’AI è gradualmente penetrata in ogni aspetto della vita lavorativa e quotidiana delle persone. Inoltre, i settori coinvolti nell’AI stanno aumentando, passando dalla scrittura iniziale, all’istruzione medica, fino ad arrivare ora ai video. Luma è una piattaforma professionale di generazione video di alta qualità, dove gli utenti devono solo caricare il materiale per generare automaticamente video di alta qualità in base a diversi stili ed effetti. Questo generatore di video AI è stato sviluppato da membri di un team proveniente da noti gruppi tecnologici, con l’obiettivo di consentire a chiunque di creare facilmente video eccezionali senza strumenti di editing complessi. Tuttavia, Luma non fornisce ufficialmente un’API; AceDataCloud offre un set di API di Luma, simulando l’integrazione con l’ufficiale Suno, per generare video desiderati in modo semplice e veloce.

​
Richiesta e utilizzo

Per utilizzare l’API di Generazione Video Luma, prima vai al Pannello di Controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta offre un credito gratuito, per un’esperienza senza costi; se il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API di Generazione Video Luma →

​
Utilizzo di base

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

Il codice generato è il seguente:

Parametri principali della richiesta:
  • prompt: la parola chiave per generare il video.
  • aspect_ratio: il rapporto di aspetto del video, predefinito 16:9.
  • end_image_url: opzionale, specifica il fotogramma finale.
  • enhancement: opzionale, interruttore per il miglioramento della chiarezza.
  • loop: se generare un video in loop, predefinito false.
  • timeout: opzionale, numero di secondi di timeout.
  • callback_url: indirizzo di callback asincrono.
  • async: opzionale, impostato su true per restituire immediatamente task_id, senza fornire callback_url, quindi utilizzare l’interfaccia di query del compito corrispondente per ottenere i risultati.
Puoi cliccare sul pulsante “Try” per testare direttamente l’API, attendere 1-2 minuti e il risultato sarà il seguente:
Possiamo vedere che in questo momento abbiamo ottenuto le informazioni relative a questo video, inclusi video ID, link video, copertina video e altro. La spiegazione dei campi è la seguente:
  • success: se la generazione è avvenuta con successo, se sì è true, altrimenti false
  • task_id: l’ID unico di questo compito di generazione video
  • video_id: l’ID unico del video generato da questo compito di generazione video
  • prompt: la parola chiave di questo compito di generazione video
  • video_url: il link al video risultante di questo compito di generazione video
  • video_height: l’altezza dell’immagine di copertura del video generato
  • video_width: la larghezza dell’immagine di copertura del video generato
  • state: lo stato di questo compito di generazione video, se il compito è completato sarà completed.
  • thumbnail_url: il link all’immagine di copertura del video generato
  • thumbnail_width: la larghezza dell’immagine di copertura del video generato
  • thumbnail_height: l’altezza dell’immagine di copertura del video generato

​
Generazione di fotogrammi personalizzati

Se desideri generare un video utilizzando fotogrammi personalizzati, puoi inserire i link delle immagini per i fotogrammi iniziali e finali: In questo caso, il campo start_image_url può ricevere le seguenti immagini come fotogramma iniziale del video: Fotogramma iniziale Successivamente, per generare un video personalizzato in base ai fotogrammi iniziali e finali e alle parole chiave, puoi specificare i seguenti contenuti:
  • action: l’azione del compito di generazione video, solitamente generazione normale generate e generazione estesa extend, predefinita generate.
  • start_image_url: specifica il fotogramma iniziale del video generato.
  • end_image_url: specifica il fotogramma finale del video generato.
  • prompt: il contenuto delle parole chiave per generare il video.
Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato è il seguente:

Il codice corrispondente:
Il risultato ottenuto è il seguente:
Il risultato finale è simile a quello precedente, il fotogramma iniziale del video generato include l’immagine che abbiamo fornito; ovviamente, è possibile anche fornire i link delle immagini per i fotogrammi iniziali e finali per generare il video, basta aggiungere un’immagine per il fotogramma finale sulla base di quanto sopra, le informazioni dell’immagine finale sono le seguenti: Fotogramma finale Esempio di compilazione:

Ultimamente si è giunti ai seguenti risultati:
Il risultato è simile a quanto sopra, il video generato contiene sia l’immagine del primo fotogramma che quella dell’ultimo fotogramma, completando così la personalizzazione dei fotogrammi iniziali e finali per generare il video.

​
Funzione di estensione video

Se si desidera continuare a generare il video creato, è possibile impostare il parametro action su extend e inserire l’ID del video o il link del video da continuare a generare. L’ID del video e il link del video possono essere ottenuti in base all’uso di base, come mostrato nell’immagine sottostante:

A questo punto, si può vedere che l’ID del video è:
Nota: qui l’ video_id e il video_url sono l’ID e il link del video generato. Se non sai come generare un video, puoi fare riferimento all’uso di base sopra per generare un video.
Per continuare a generare il video, è necessario caricare il link del video o l’ID del video. Di seguito viene mostrato come utilizzare l’ID del video per l’estensione. Successivamente, dobbiamo compilare le parole chiave per personalizzare la generazione del video, specificando i seguenti contenuti:
  • action: in questo caso, l’azione di estensione del video, che deve essere extend.
  • prompt: le parole chiave per estendere il video.
  • video_url: il link del video da estendere.
  • video_id: l’ID unico del video da estendere.
  • end_image_url: il link dell’immagine del fotogramma finale da specificare per l’estensione, parametro opzionale.
Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato automaticamente è il seguente:

Codice Python corrispondente:
Cliccando su Esegui, si può notare che si ottiene un risultato, come segue:
Si può notare che il video è stato esteso sulla base del video da estendere, il contenuto del risultato è coerente con quanto sopra, realizzando così la funzione di continuazione della generazione della canzone. Naturalmente, possiamo anche specificare il link del video per effettuare l’estensione, compilando le seguenti informazioni:

Dopo l’esecuzione, si ottiene il seguente risultato:
Dal risultato si può vedere che anche utilizzando il link del video è possibile realizzare la funzione di estensione del video. Infine, possiamo anche specificare un’immagine del fotogramma finale per l’estensione del video. Di seguito sono riportate le informazioni sull’immagine del fotogramma finale: Fotogramma finale Successivamente, sulla base di quanto sopra, aggiungiamo le informazioni sull’immagine del fotogramma finale, come segue:

Cliccando su Esegui, si ottiene la seguente informazione:
Si può notare che, sulla base dell’estensione del video precedente, è possibile anche specificare un’immagine del fotogramma finale per l’estensione.

​
Callback asincrona

Poiché il tempo di generazione del video Luma è relativamente lungo, circa 1-2 minuti, se l’API non risponde per lungo tempo, la richiesta HTTP manterrà la connessione, causando un consumo aggiuntivo di risorse di sistema. Pertanto, questa API offre anche supporto per callback asincroni. Il processo complessivo è il seguente: quando il client avvia una richiesta, specifica un campo callback_url aggiuntivo. Dopo che il client ha avviato la richiesta API, l’API restituirà immediatamente un risultato, contenente un campo task_id, che rappresenta l’ID del compito attuale. Quando il compito è completato, il risultato della generazione musicale verrà inviato al callback_url specificato dal client in formato POST JSON, includendo anche il campo task_id, in modo che il risultato del compito possa essere associato tramite l’ID. Di seguito, vediamo un esempio per capire come operare concretamente. Innanzitutto, il callback Webhook è un servizio in grado di ricevere richieste HTTP, e gli sviluppatori dovrebbero sostituirlo con l’URL del server HTTP che hanno creato. Qui, per comodità di dimostrazione, utilizziamo un sito Web pubblico di esempio per Webhook https://webhook.site/, aprendo questo sito si ottiene un URL Webhook, come mostrato nell’immagine:

Copia questo URL e puoi usarlo come Webhook; l’esempio qui è https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Successivamente, possiamo impostare il campo callback_url sull’URL Webhook sopra menzionato, riempiendo anche il prompt, come mostrato nell’immagine:

Cliccando su Esegui, possiamo notare che si ottiene immediatamente un risultato, come segue:
Dopo un momento, possiamo osservare il risultato della canzone generata su https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, come mostrato nell’immagine: Il contenuto è il seguente:
Possiamo vedere che nel risultato c’è un campo task_id, e gli altri campi sono simili a quelli sopra, tramite questo campo è possibile realizzare l’associazione del compito.