Skip to main content
La principale funzionalità dell’API Grok Tasks è quella di interrogare lo stato di esecuzione di un’attività utilizzando l’ID dell’attività generato dall’API Grok Videos Generation. Questo documento fornirà una guida dettagliata per l’integrazione dell’API Grok Tasks, aiutandoti a integrare facilmente e a interrogare lo stato di esecuzione delle attività dell’API Grok Videos Generation.

​
Processo di richiesta

Per utilizzare l’API Grok Videos Generation, prima di tutto 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 a effettuare il login; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è 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: Grok Videos Generation API →

​
Esempio di richiesta

L’API Grok Tasks può essere utilizzata per interrogare i risultati dell’API Grok Videos Generation.

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

Request Headers includono:
  • accept: specifica di ricevere la risposta in formato JSON, qui deve essere impostato su 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à da interrogare.
  • action: il modo di operare sull’attività, per una singola interrogazione impostare su retrieve.

​
Esempio di codice CURL

​
Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà le informazioni dettagliate sull’attività. Il campo request è il corpo della richiesta al momento dell’avvio dell’attività, il campo response è il corpo della risposta restituito al termine dell’attività, ad esempio:
La descrizione dei campi è la seguente:
  • id: l’ID dell’attività generata, utilizzato per identificare univocamente questa attività di generazione.
  • request: informazioni sulla richiesta nell’attività interrogata.
  • response: informazioni sulla risposta nell’attività 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 cifre decimali). Questo campo non viene restituito se l’attività non è completata.

​
Operazione di interrogazione in batch

Per interrogare i dettagli di più ID di attività, impostare action su retrieve_batch e passare l’array degli ID delle attività tramite ids: Request Body include:
  • ids: array degli ID delle attività da interrogare.
  • action: il modo di operare sull’attività, per interrogazioni in batch impostare su retrieve_batch.