Documentation API HappyHorse

Guide complet pour intégrer l’API de génération vidéo HappyHorse 1.0 dans vos applications.

API v1.0 Base URL: https://happyhorse.app

Démarrage rapide

bash

curl -X POST 'https://happyhorse.app/api/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0/video",
    "prompt": "A cinematic shot of mountains at sunrise",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Authentification

Toutes les requêtes API nécessitent un jeton Bearer dans l’en-tête Authorization.

Obtenir votre clé API: Vous pouvez obtenir votre clé API sur la page API Keys du tableau de bord. → Obtenir votre clé API

http

Authorization: Bearer YOUR_API_KEY

Modèles disponibles

HappyHorse 1.0

Génération vidéo IA de haute qualité avec HappyHorse

Type	Description	Durée	Crédits
`pro (text-to-video)`	Texte vers vidéo qualité Pro	3-15s	54/s (no audio) · 80/s (with audio)
`pro (image-to-video)`	Image vers vidéo qualité Pro	3-15s	54/s (no audio) · 80/s (with audio)
`std (text-to-video)`	Texte vers vidéo qualité standard	3-15s	40/s (no audio) · 60/s (with audio)
`std (image-to-video)`	Image vers vidéo qualité standard	3-15s	40/s (no audio) · 60/s (with audio)

Points de terminaison API

Crée une tâche de génération vidéo. Le champ model doit être 'happyhorse-1.0/video'.

Corps de la requête

Paramètres du corpsJSON

model:string

Nom du modèle, doit être 'happyhorse-1.0/video'

prompt:optional string

Description textuelle de la vidéo (max. 2500 caractères). Non requis si multi_shots est true.

mode:optional string

Mode qualité : 'pro' ou 'std' (défaut : std) Defaults to std.

duration:optional number

Durée en secondes (3–15, défaut : 5) Defaults to 5.

aspect_ratio:optional string

Format de sortie (16:9, 9:16, 1:1) Defaults to 16:9.

image_urls:optional string[]

Tableau d’URLs d’images pour l’image vers vidéo

sound:optional boolean

Activer l’audio natif (défaut : true) Defaults to true.

cfg_scale:optional number

Adhérence au prompt (0-1, défaut : 0.5). Les valeurs élevées suivent le prompt plus fidèlement. Defaults to 0.5.

multi_shots:optional boolean

Mode multi-plans avec plusieurs prompts Defaults to false.

multi_prompt:optional array

Tableau d’objets 'prompt, duration' pour le mode multi-plans

happyhorse_elements:optional array

Tableau d'objets décrivant chaque élément. Dans le prompt, écrivez @ suivi de la valeur du champ name (ex. : name 'element_dog' → @element_dog). Chaque élément : name, description, element_input_urls (2-4 URLs). Max. 3 éléments par tâche.

Texte vers vidéo

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "A majestic eagle soaring through clouds at sunset",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "sound": true
}

Image vers vidéo

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "The character slowly turns and smiles",
  "mode": "pro",
  "image_urls": ["https://example.com/my-image.jpg"],
  "duration": 5
}

Vidéo multi-plans

json

{
  "model": "happyhorse-1.0/video",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    { "prompt": "A woman walks into a coffee shop", "duration": 3 },
    { "prompt": "She orders a latte and sits by the window", "duration": 4 },
    { "prompt": "She looks outside and smiles", "duration": 3 }
  ],
  "aspect_ratio": "16:9"
}

Réponses

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "IN_PROGRESS"
  }
}

Vérifie le statut d’une génération vidéo avec le task_id renvoyé par l’endpoint generate.

Paramètres de requête

task_id:string

Identifiant unique renvoyé par generate (préfixe n92)

Exemple de requête

bash

curl -X GET 'https://happyhorse.app/api/status?task_id=n92abc123hh10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Astuce: Le champ response contient un tableau resultUrls. Utilisez data.response.resultUrls[0] pour l’URL de la vidéo.

javascript

// Extract video URL from response
const videoUrl = data.response.resultUrls[0];

Réponses

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "SUCCESS",
    "consumed_credits": 400,
    "created_at": "2026-04-08T10:30:00Z",
    "type": "text-to-video",
    "request": {
      "model": "happyhorse-1.0/video",
      "prompt": "A majestic eagle soaring through clouds at sunset",
      "mode": "pro",
      "duration": 5,
      "aspect_ratio": "16:9"
    },
    "response": {
      "resultUrls": [
        "https://cdn.example.com/videos/abc123.mp4"
      ]
    },
    "error_message": null
  }
}

Bac à sable API

Testez l’API directement dans le navigateur. Remplacez YOUR_API_KEY par votre clé réelle.

Bac à sable APIPOST

URL de base

Point de terminaison

En-têtes

Corps de la requête

Codes d’erreur

Statut HTTP	Code	Description
400 Requête incorrecte	INVALID_PROMPT	Le prompt est invalide ou vide
400 Requête incorrecte	INVALID_DURATION	Durée hors plage prise en charge (3–15 s)
400 Requête incorrecte	INVALID_MODEL	Le modèle doit être 'happyhorse-1.0/video'
401 Non autorisé	INVALID_API_KEY	Clé API manquante ou invalide
402 Paiement requis	INSUFFICIENT_CREDITS	Crédits insuffisants pour cette opération
429 Trop de requêtes	RATE_LIMITED	Trop de requêtes, veuillez ralentir
500 Erreur interne du serveur	INTERNAL_ERROR	Erreur serveur, réessayez plus tard