Intégration et utilisation de l'API Grok Tasks

La principale fonctionnalité de l’API Grok Tasks est de permettre la consultation de l’état d’exécution d’une tâche en entrant l’ID de tâche généré par l’API Grok Videos Generation. Ce document détaillera les instructions d’intégration de l’API Grok Tasks, vous aidant à intégrer facilement et à consulter l’état d’exécution des tâches de l’API Grok Videos Generation.

Processus de demande

Pour utiliser l’API Grok Videos Generation, commencez par obtenir votre token API sur le tableau de bord Ace Data Cloud pour le garder en réserve.

Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion vous invitant à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle. Un token API suffit pour appeler tous les services de la plateforme, sans avoir besoin de demander séparément pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; lorsque le quota est insuffisant, vous pouvez recharger le solde général dans le tableau de bord.

📘 Documentation complète : Grok Videos Generation API →

Exemple de demande

L’API Grok Tasks peut être utilisée pour consulter les résultats de l’API Grok Videos Generation.

Configuration des en-têtes de demande et du corps de la demande

Request Headers inclut :

accept : spécifie que la réponse doit être au format JSON, ici rempli avec application/json.
authorization : la clé pour appeler l’API, que vous pouvez sélectionner directement après la demande.

Request Body inclut :

id : l’ID de la tâche à consulter.
action : la manière d’opérer sur la tâche, pour une consultation unique, remplissez retrieve.

Exemple de code CURL

curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'

Exemple de réponse

Après une demande réussie, l’API renverra les détails de la tâche ici. Le champ request est le corps de la demande lors du lancement de la tâche, le champ response est le corps de la réponse renvoyé après l’achèvement de la tâche, par exemple :

{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262729.623,
  "elapsed": 7.8,
  "request": {
    "prompt": "Une prise de vue cinématographique d'un chaton poursuivant un papillon dans un jardin ensoleillé",
    "model": "grok-imagine-video-1.5-fast:reverse",
    "resolution": "480p",
    "duration": 8
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "grok-imagine-video-1.5-fast:reverse:41eb9a5f-3b2d-4d1e-9f5a-6c2f1a0b9e77",
        "video_url": "https://cdn.acedata.cloud/c8cbf53aa0.mp4",
        "state": "succeeded"
      }
    ]
  }
}

La description des champs est la suivante :

id : l’ID de la tâche générée, utilisé pour identifier de manière unique cette tâche de génération.
request : les informations de demande dans la tâche consultée.
response : les informations de réponse dans la tâche consultée.
created_at : l’heure de création de la tâche, timestamp Unix (secondes, flottant).
started_at : l’heure de début d’exécution de la tâche, timestamp Unix (secondes, flottant).
finished_at : l’heure de fin de la tâche, timestamp Unix (secondes, flottant). Ce champ ne sera pas renvoyé si la tâche n’est pas terminée.
elapsed : le temps d’exécution de la tâche, en secondes (flottant, avec 3 décimales). Ce champ ne sera pas renvoyé si la tâche n’est pas terminée.

Opération de requête en lot

Pour consulter les détails de plusieurs ID de tâches, définissez action sur retrieve_batch et passez le tableau d’ID de tâches via ids : Request Body inclut :

ids : tableau d’ID de tâches à consulter.
action : la manière d’opérer sur la tâche, pour une consultation en lot, remplissez retrieve_batch.

curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Coding

Autres guides

Intégration et utilisation de l'API Grok Tasks

Processus de demande

Exemple de demande

Configuration des en-têtes de demande et du corps de la demande

Exemple de code CURL

Exemple de réponse

Opération de requête en lot

​Processus de demande

​Exemple de demande

​Configuration des en-têtes de demande et du corps de la demande

​Exemple de code CURL

​Exemple de réponse

​Opération de requête en lot

Processus de demande

Exemple de demande

Configuration des en-têtes de demande et du corps de la demande

Exemple de code CURL

Exemple de réponse

Opération de requête en lot