Intégration et utilisation de l'API HappyHorse Tasks

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 pour le garder en réserve.

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.

📘 Documentation complète : HappyHorse Videos API →

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

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 :

{
  "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 :

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.

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 HappyHorse 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 masse

​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 masse

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 masse