Skip to main content
Die Hauptfunktion der Grok Tasks API besteht darin, den Ausführungsstatus eines Tasks abzufragen, indem die Task-ID eingegeben wird, die über die Grok Videos Generation API generiert wurde. Dieses Dokument wird die Integrationsanleitung der Grok Tasks API detailliert beschreiben, um Ihnen zu helfen, die Ausführungsstatus der Tasks der Grok Videos Generation API einfach abzufragen.

​
Antragsprozess

Um die Grok 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 es kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.
📘 Vollständige Dokumentation: Grok Videos Generation API →

​
Anfragebeispiel

Die Grok Tasks API kann verwendet werden, um die Ergebnisse der Grok 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 Task-ID.
  • action: Die Art der Operation auf der Task, für eine Einzelabfrage retrieve eintragen.

​
CURL Codebeispiel

​
Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die Detailinformationen zu dieser Task zurück. Das request-Feld ist der Request Body, der beim Starten der Task gesendet wurde, das response-Feld ist der Response Body, der nach Abschluss der Task zurückgegeben wird, zum Beispiel:
Die Feldbeschreibung ist wie folgt:
  • id: Die ID der generierten Task, die zur eindeutigen Identifizierung dieser Generierung verwendet wird.
  • request: Die Anfrageinformationen der abgefragten Task.
  • response: Die Rückgabeinformationen der abgefragten Task.
  • created_at: Erstellungszeit der Task, Unix-Zeitstempel (Sekunden, Fließkomma).
  • started_at: Beginn der Ausführung der Task, Unix-Zeitstempel (Sekunden, Fließkomma).
  • finished_at: Abschlusszeit der Task, Unix-Zeitstempel (Sekunden, Fließkomma). Dieses Feld wird nicht zurückgegeben, wenn die Task nicht abgeschlossen ist.
  • elapsed: Die Ausführungsdauer der Task, Einheit in Sekunden (Fließkomma, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn die Task nicht abgeschlossen ist.

​
Batch-Abfrageoperation

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