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

​
Processo di richiesta

Per utilizzare l’API Gemini 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: Gemini Videos Generation API →

​
Esempio di richiesta

L’API Gemini Tasks può essere utilizzata per interrogare i risultati dell’API Gemini 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 si compila con 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 si compila con retrieve.

​
Esempio di codice CURL

​
Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà i dettagli dell’attività qui. 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 dell’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 impiegato per l’esecuzione dell’attività, in secondi (float, con 3 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à, imposta action su retrieve_batch e passa 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 l’interrogazione in batch si compila con retrieve_batch.