Integrazione e utilizzo dell'API Luma Tasks

La principale funzionalità dell’API Luma Tasks è quella di interrogare lo stato di esecuzione di un’attività utilizzando l’ID dell’attività generato dall’API Luma Videos Generation. Questo documento fornirà una descrizione dettagliata dell’integrazione dell’API Luma Tasks, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l’API Luma Tasks, puoi facilmente interrogare lo stato di esecuzione delle attività dell’API Luma Videos Generation.

Processo di richiesta

Per utilizzare l’API Luma Videos Generation, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo token API, da conservare per uso futuro.

Se non hai ancora effettuato il login o registrato, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un token API è sufficiente per accedere a tutti i servizi della piattaforma, senza necessità di richiederne uno separato per ogni servizio. La prima richiesta ti darà un credito gratuito, per un’esperienza senza costi; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.

📘 Documentazione completa: API Luma Videos Generation →

Esempio di richiesta

L’API Luma Tasks può essere utilizzata per interrogare i risultati dell’API Luma Videos Generation. Per informazioni su come utilizzare l’API Luma Videos Generation, consulta la documentazione API Luma Videos Generation. Prendiamo come esempio un ID attività restituito dal servizio Luma Videos Generation, per dimostrare come utilizzare questa API. Supponiamo di avere un ID attività: 50fc6182-fa86-4c7d-ac12-2fa27ec2f151, e ora dimostreremo come passare un ID attività.

Esempio di attività

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Request Headers includono:

accept: specifica di ricevere la risposta in formato JSON, qui inserito come application/json.
authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.

Request Body include:

id: l’ID dell’attività caricata.
action: il modo in cui operare sull’attività.

Impostato come mostrato nell’immagine seguente:

Esempio di codice

Si può notare che, sul lato destro della pagina, sono già stati generati automaticamente vari codici in diverse lingue, come mostrato nell’immagine:

Alcuni esempi di codice sono i seguenti:

CURL

curl -X POST 'https://api.acedata.cloud/luma/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/luma/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Esempio di risposta

Se la richiesta ha successo, l’API restituirà i dettagli di questa attività video. Ad esempio:

{
  "_id": "66d297a3550a4144a5a5db42",
  "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
  "api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5",
  "application_id": "06484a45-9d04-498a-98a7-67086dee8166",
  "created_at": 1725077411.961,
  "started_at": 1725077412.021,
  "finished_at": 1725077566.241,
  "elapsed": 154.22,
  "credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50",
  "request": {
    "action": "generate",
    "prompt": "Astronauti si spostano dallo spazio a un vulcano"
  },
  "trace_id": "0b7c1c1a-045c-4145-a434-609cba88f0a9",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
    "video_id": "4b088fc8-2bbc-4706-80a6-a0fb118adc1a",
    "prompt": "Astronauti si spostano dallo spazio a un vulcano",
    "video_url": "https://platform.cdn.acedata.cloud/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.mp4",
    "video_height": 752,
    "video_width": 1360,
    "state": "completed",
    "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.jpg",
    "thumbnail_width": 1360,
    "thumbnail_height": 752
  }
}

Il risultato restituito contiene diversi campi, il campo request è il corpo della richiesta al momento dell’avvio dell’attività, mentre il campo response è il corpo della risposta restituito al termine dell’attività, i cui risultati sono coerenti con quelli della richiesta e risposta dell’API Luma Videos Generation. La descrizione dei campi è la seguente.

id, l’ID dell’attività video generata, utilizzato per identificare univocamente questa attività di generazione video.
video_id, l’identificativo unico del video nell’attività video interrogata, necessario per operazioni di estensione del video in futuro.
request, informazioni sulla richiesta nell’attività video interrogata.
response, informazioni sulla risposta nell’attività video interrogata.
created_at, data e ora di creazione dell’attività, timestamp Unix (secondi, float).
started_at, data e ora di inizio esecuzione dell’attività, timestamp Unix (secondi, float).
finished_at, data e ora di completamento dell’attività, timestamp Unix (secondi, float). Questo campo non viene restituito se l’attività non è completata.
elapsed, tempo di esecuzione dell’attività, in secondi (float, con 3 decimali). Questo campo non viene restituito se l’attività non è completata.

Operazione di query in batch

Questa è per interrogare i dettagli delle attività video per più ID attività, a differenza di quanto sopra, è necessario selezionare l’azione come retrieve_batch. Request Body include:

ids: array degli ID delle attività caricate.
action: il modo in cui operare sull’attività.

Impostato come mostrato nell’immagine seguente:

Esempio di codice

Si può notare che, sul lato destro della pagina, sono già stati generati automaticamente vari codici in diverse lingue, come mostrato nell’immagine:

Alcuni esempi di codice sono i seguenti:

Esempio di risposta

Se la richiesta ha successo, l’API restituirà i dettagli specifici di tutte le attività video in batch. Ad esempio:

{
  "items": [
    {
      "_id": "66d297a3550a4144a5a5db42",
      "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
      "api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5",
      "application_id": "06484a45-9d04-498a-98a7-67086dee8166",
      "created_at": 1725077411.961,
      "started_at": 1725077412.021,
      "finished_at": 1725077566.241,
      "elapsed": 154.22,
      "credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50",
      "request": {
        "action": "generate",
        "prompt": "Astronauti si spostano dallo spazio al vulcano"
      },
      "trace_id": "0b7c1c1a-045c-4145-a434-609cba88f0a9",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
        "video_id": "4b088fc8-2bbc-4706-80a6-a0fb118adc1a",
        "prompt": "Astronauti si spostano dallo spazio al vulcano",
        "video_url": "https://platform.cdn.acedata.cloud/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.mp4",
        "video_height": 752,
        "video_width": 1360,
        "state": "completato",
        "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.jpg",
        "thumbnail_width": 1360,
        "thumbnail_height": 752
      }
    },
    {
      "_id": "66d29ed3550a4144a5a6c089",
      "id": "76a05f61-68ad-4c1a-838f-a00cd08cf65b",
      "api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5",
      "application_id": "06484a45-9d04-498a-98a7-67086dee8166",
      "created_at": 1725079250.921,
      "started_at": 1725079250.981,
      "finished_at": 1725079406.71,
      "elapsed": 155.729,
      "credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50",
      "request": {
        "action": "generate",
        "prompt": "la la la"
      },
      "trace_id": "338f1616-741d-40b6-8d62-c025434024c6",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "76a05f61-68ad-4c1a-838f-a00cd08cf65b",
        "video_id": "5a638d6a-7481-4c5e-8843-36c9d1b5bcd5",
        "prompt": "la la la",
        "video_url": "https://platform.cdn.acedata.cloud/luma/76a05f61-68ad-4c1a-838f-a00cd08cf65b.mp4",
        "video_height": 752,
        "video_width": 1360,
        "state": "completato",
        "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/76a05f61-68ad-4c1a-838f-a00cd08cf65b.jpg",
        "thumbnail_width": 1360,
        "thumbnail_height": 752
      }
    }
  ],
  "count": 2
}

CURL

curl -X POST 'https://api.acedata.cloud/luma/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["50fc6182-fa86-4c7d-ac12-2fa27ec2f151","76a05f61-68ad-4c1a-838f-a00cd08cf65b"],
  "action": "retrieve_batch"
}'

Python

import requests

url = "https://api.acedata.cloud/luma/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ids": ["50fc6182-fa86-4c7d-ac12-2fa27ec2f151","76a05f61-68ad-4c1a-838f-a00cd08cf65b"],
    "action": "retrieve_batch"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Errore di gestione

In caso di errore durante la chiamata all’API, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:

400 token_mismatched：Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
400 api_not_implemented：Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
401 invalid_token：Non autorizzato, token di autorizzazione non valido o mancante.
429 too_many_requests：Troppe richieste, hai superato il limite di frequenza.
500 api_error：Errore interno del server, qualcosa è andato storto sul server.

Esempio di risposta di errore

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusione

Attraverso questo documento, hai compreso come utilizzare l’API Luma Tasks per interrogare i dettagli specifici di singoli o batch di video. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Proxy

Avanzato

Coding

Integrazione e utilizzo dell'API Luma Tasks

Processo di richiesta

Esempio di richiesta

Esempio di attività

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Esempio di codice

CURL

Python

Esempio di risposta

Operazione di query in batch

Esempio di codice

Esempio di risposta

CURL

Python

Errore di gestione

Esempio di risposta di errore

Conclusione

​Processo di richiesta

​Esempio di richiesta

​Esempio di attività

​Impostazione dell’intestazione della richiesta e del corpo della richiesta

​Esempio di codice

​CURL

​Python

​Esempio di risposta

​Operazione di query in batch

​Esempio di codice

​Esempio di risposta

​CURL

​Python

​Errore di gestione

​Esempio di risposta di errore

​Conclusione

Processo di richiesta

Esempio di richiesta

Esempio di attività

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Esempio di codice

CURL

Python

Esempio di risposta

Operazione di query in batch

Esempio di codice

Esempio di risposta

CURL

Python

Errore di gestione

Esempio di risposta di errore

Conclusione