> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Intégration et utilisation de l'API Grok Tasks

> Grok API guide - Ace Data Cloud

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](https://platform.acedata.cloud/console/applications) pour le garder en réserve.

![](https://cdn.acedata.cloud/dvc3cg.jpg)

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](https://platform.acedata.cloud/console/coin).

> 📘 Documentation complète : [Grok Videos Generation API →](https://platform.acedata.cloud/documents/grok-videos)

## 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

```bash theme={null}
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 :

```json theme={null}
{
  "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`.

```bash theme={null}
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"
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.