Skip to main content
Die Hauptfunktion der Gemini Tasks API besteht darin, den Status der Ausführung eines Auftrags abzufragen, indem die Auftrags-ID eingegeben wird, die über die Gemini Videos Generation API generiert wurde. Dieses Dokument wird die Integrationsanleitung der Gemini Tasks API detailliert beschreiben, um Ihnen zu helfen, die Gemini Videos Generation API einfach zu integrieren und den Status der Auftragsausführung abzufragen.

​
Antragsprozess

Um die Gemini Videos Generation API zu nutzen, müssen Sie zunächst Ihr API-Token im Ace Data Cloud Dashboard abrufen und für zukünftige Verwendung aufbewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, die Sie zur Registrierung und Anmeldung einlädt. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um die Dienste kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.
📘 Vollständige Dokumentation: Gemini Videos Generation API →

​
Anfragebeispiel

Die Gemini Tasks API kann verwendet werden, um die Ergebnisse der Gemini Videos Generation API abzufragen.

​
Anfrageheader und Anfragekörper festlegen

Request Headers umfassen:
  • accept: Gibt an, dass die Antwort im JSON-Format empfangen werden soll, hier eingetragen als application/json.
  • authorization: Der Schlüssel zur Aufrufung der API, nach der Beantragung kann er direkt ausgewählt werden.
Request Body umfasst:
  • id: Die zu abfragende Auftrags-ID.
  • action: Die Art der Operation auf dem Auftrag, für eine Einzelabfrage retrieve eintragen.

​
CURL Codebeispiel

​
Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die Detailinformationen zu diesem Auftrag zurück. Das Feld request ist der Anfragekörper, der beim Starten des Auftrags gesendet wurde, das Feld response ist der Antwortkörper, der nach Abschluss des Auftrags zurückgegeben wird, zum Beispiel:
Die Feldbeschreibung ist wie folgt:
  • id: Die ID des generierten Auftrags, die zur eindeutigen Identifizierung dieses Generierungsauftrags verwendet wird.
  • request: Die Anfrageinformationen im Auftrag.
  • response: Die Rückgabeinformationen im Auftrag.
  • created_at: Erstellungszeit des Auftrags, Unix-Zeitstempel (Sekunden, Fließkomma).
  • started_at: Beginn der Ausführung des Auftrags, Unix-Zeitstempel (Sekunden, Fließkomma).
  • finished_at: Abschlusszeit des Auftrags, Unix-Zeitstempel (Sekunden, Fließkomma). Dieses Feld wird nicht zurückgegeben, wenn der Auftrag nicht abgeschlossen ist.
  • elapsed: Die für die Ausführung des Auftrags benötigte Zeit, Einheit in Sekunden (Fließkomma, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn der Auftrag nicht abgeschlossen ist.

​
Batch-Abfrageoperation

Um die Auftragsdetails für mehrere Auftrags-IDs abzufragen, setzen Sie action auf retrieve_batch und übergeben Sie die Auftrags-ID-Array über ids: Request Body umfasst:
  • ids: Das Array der zu abfragenden Auftrags-IDs.
  • action: Die Art der Operation auf dem Auftrag, für die Batch-Abfrage retrieve_batch eintragen.