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

> HappyHorse Video API guide - Ace Data Cloud

L'API HappyHorse Tasks est utilisée pour interroger les tâches de génération ou d'édition de vidéos créées par l'API HappyHorse Videos.

## Processus de demande

Pour utiliser l'API HappyHorse Videos, 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 qui vous invite à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle.

**Un seul token API suffit pour appeler tous les services de la plateforme, sans avoir besoin de demander un 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 : [HappyHorse Videos API →](https://platform.acedata.cloud/documents/happyhorse-videos)

## Exemple de demande

L'API HappyHorse Tasks peut être utilisée pour interroger les résultats de l'API HappyHorse Videos.

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

**Request Headers** comprend :

* `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** comprend :

* `id` : l'ID de la tâche à interroger.
* `action` : la manière d'opérer sur la tâche, pour une seule requête, remplissez `retrieve`.

### Exemple de code CURL

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/happyhorse/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. Le champ `request` est le corps de la demande lors de la création 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": 1769262774.423,
  "elapsed": 52.6,
  "request": {
    "action": "generate",
    "model": "happyhorse-1.1-t2v",
    "prompt": "Une prise de vue cinématographique d'un cheval blanc courant sur une plage éclairée par la lune",
    "resolution": "720P",
    "duration": 5
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "1469cfc3-3004-4d9e-ab10-xxxxxx",
        "video_url": "https://cdn.acedata.cloud/happyhorse/c8cbf53aa0.mp4",
        "state": "succeeded",
        "duration": 5,
        "resolution": "720P",
        "ratio": "16:9"
      }
    ]
  }
}
```

La description des champs est la suivante :

* `id` : l'ID de la tâche de génération, utilisé pour identifier de manière unique cette tâche de génération.
* `request` : les informations de demande lors de la création de la tâche.
* `response` : les informations de retour actuelles ou finales de la tâche.
* `created_at` : date de création de la tâche, horodatage Unix (secondes, flottant).
* `started_at` : date de début d'exécution de la tâche, horodatage Unix (secondes, flottant).
* `finished_at` : date de fin de la tâche, horodatage Unix (secondes, flottant). Ce champ n'est pas renvoyé si la tâche n'est pas terminée.
* `elapsed` : temps d'exécution de la tâche, en secondes (flottant, avec 3 décimales). Ce champ n'est pas renvoyé si la tâche n'est pas terminée.

## Opération de requête en masse

Pour interroger les détails de plusieurs tâches ID, définissez `action` sur `retrieve_batch` et passez le tableau d'ID de tâche via `ids` :

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

Le résultat renvoyé contiendra les champs `items` et `count`, `items` étant le tableau des détails de la tâche, et `count` le nombre de tâches correspondantes trouvées.


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