API — Bientôt disponible

Accès à l’API Happyhorse-1.0

Paiement à l’usage · Sans abonnement · À utiliser dans votre propre application

L’API REST Happyhorse-1.0 arrive bientôt. En attendant, l’accès direct à l’API Happyhorse est disponible en préversion privée ; vous pouvez dès maintenant générer des vidéos via le web — même modèle, même qualité, et vous ne payez que ce que vous utilisez.

Utilisez Happyhorse-1.0 en ligne — aucune clé API requise

Le système de clés API Happyhorse est en cours de développement, mais le modèle est déjà disponible. Achetez des crédits, générez des vidéos 4K sur le site et téléchargez — licence commerciale complète incluse. Lorsque l’API REST sera lancée, vos crédits seront automatiquement reportés.

01

Achetez des crédits

Paiement unique, sans abonnement. Les crédits sont partagés entre l’application web, les futurs appels API Happyhorse et le nœud ComfyUI.

02

Générez une vidéo

Saisissez votre prompt dans le Lab Happyhorse-1.0. Le même modèle qui alimentera l’API REST — architecture daVinci-MagiHuman, 4K native.

03

Téléchargez et publiez

Sortie MP4 avec 100 % de propriété des droits IP à usage commercial. Lorsque le point de terminaison de l’API Happyhorse sera disponible, renseignez votre clé et automatisez le même workflow.

Fonctionnement de l’API

L’API REST Happyhorse-1.0 suit un modèle simple asynchrone de requête puis d’interrogation (polling). Authentifiez-vous avec votre clé API happyhorse, soumettez une tâche et récupérez le résultat lorsqu’il est prêt. Vous trouverez ci-dessous un aperçu de l’intégration de l’API happyhorse-1.0.

01

Authentification

Incluez votre clé API happyhorse dans l’en-tête Authorization. Les clés sont limitées à un espace de travail et soumises à une limitation de débit selon l’offre.

02

Soumettre une tâche

Envoyez votre prompt et vos paramètres en POST vers le point de terminaison /v1/generate. Le point de terminaison de l’API happyhorse renvoie immédiatement un job_id.

03

Interroger l’état

Faites un GET sur /v1/jobs/{job_id} pour suivre l’avancement. Lorsque le statut est completed, la réponse inclut une URL vidéo signée, valable 24 heures.

04

Télécharger et utiliser

Téléchargez le fichier MP4 généré ou diffusez-le directement. Les crédits ne sont débités qu’en cas de génération réussie — les tâches en échec ne sont jamais facturées.

curl — Soumettre une tâche de génération vidéo

bash
curl -X POST https://api.happyhorselab.net/v1/generate \
  -H "Authorization: Bearer hh_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lone astronaut walks across a red desert at golden hour, cinematic 4K",
    "resolution": "4K",
    "duration": 8,
    "motion_strength": 0.7,
    "fps": 24
  }'

Python — Exemple d’intégration complet

python
import requests
import time

API_KEY = "hh_xxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.happyhorselab.net/v1"

# Submit generation job
response = requests.post(
    f"{BASE_URL}/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "prompt": "A lone astronaut walks across a red desert at golden hour",
        "resolution": "4K",
        "duration": 8,
        "motion_strength": 0.7,
        "fps": 24,
    },
)
job_id = response.json()["job_id"]

# Poll until complete
while True:
    status = requests.get(
        f"{BASE_URL}/jobs/{job_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    ).json()
    if status["status"] == "completed":
        print("Video URL:", status["output_url"])
        break
    elif status["status"] == "failed":
        print("Generation failed:", status["error"])
        break
    time.sleep(5)

Tarifs & Crédits

L’accès à l’API Happyhorse fonctionne avec le même système de crédits que le site — pas d’abonnement séparé, pas de frais par utilisateur. Les crédits achetés aujourd’hui fonctionnent sur l’application web et seront reportés sur le modèle API Happyhorse à l’usage lors du lancement.

Standard

À partir d’environ 0,10 $ / vidéo

1080p, jusqu’à 8 s, file standard. Idéal pour prototyper et évaluer l’API vidéo IA Happyhorse.

Most Popular

Pro

À partir d’environ 0,25 $ / vidéo

4K native, jusqu’à 16 s, file prioritaire. Conçu pour les charges de production — le modèle API Happyhorse à l’usage, à grande échelle.

Enterprise

Tarification sur mesure

Remises sur volume, garanties de SLA, endpoints dédiés et gestion des clés API Happyhorse entre équipes.

Les crédits achetés sur le site sont entièrement interchangeables avec les futurs crédits API. Il n’existe pas de palier tarifaire distinct pour l’API Happyhorse — vous ne payez que ce que vous générez.

Les crédits n’expirent jamais tant que votre compte reste actif.

Points de terminaison API (aperçu)

L’API REST Happyhorse-1.0 expose un ensemble ciblé de points de terminaison pour la génération de vidéos et la gestion des tâches. La documentation complète de l’API happyhorse-1.0 sera publiée au lancement.

POST/v1/generate

Soumettez une tâche de génération texte-vers-vidéo ou image-vers-vidéo. Renvoie un job_id à interroger (polling).

ParameterTypeRequiredDescription
promptstringrequiredDescription textuelle de la vidéo.
resolutionstringoptional« 1080p » (par défaut) ou « 4K ». La 4K nécessite des crédits Pro.
durationintegeroptionalDurée de la vidéo en secondes. Plage : 2–16. Par défaut : 8.
motion_strengthfloatoptionalIntensité du mouvement 0,0–1,0. Par défaut : 0,6.
fpsintegeroptionalImages par seconde : 24 ou 30. Par défaut : 24.
seedintegeroptionalGraine pour la reproductibilité. À omettre pour un résultat aléatoire.
GET/v1/jobs/{job_id}

Interrogez l’état d’une tâche de génération. Renvoie status, progress et output_url une fois terminée.

GET/v1/credits

Consultez le solde de crédits restants de l’API happyhorse ainsi que l’historique d’utilisation.

GET/v1/models

Listez les modèles disponibles et leurs plages de paramètres. Expose actuellement happyhorse-1.0.

Exemple de réponse — tâche terminée

json
{
  "job_id": "job_01HZ9X3K7VQWPN8S4TYJB6MDE",
  "status": "completed",
  "model": "happyhorse-1.0",
  "created_at": "2025-06-01T14:22:10Z",
  "completed_at": "2025-06-01T14:23:48Z",
  "credits_used": 25,
  "output_url": "https://cdn.happyhorselab.net/out/job_01HZ9X3K7VQWPN8S4TYJB6MDE.mp4",
  "output_url_expires_at": "2025-06-02T14:23:48Z",
  "metadata": {
    "resolution": "4K",
    "duration": 8,
    "fps": 24,
    "motion_strength": 0.7
  }
}

FAQ

Questions fréquentes sur l’accès à l’API Happyhorse, les crédits et l’intégration.

1

Comment obtenir une clé API Happyhorse ?

Le système de clés API Happyhorse est en préversion privée. En attendant, utilisez l’application web sur happyhorselab.net — même modèle, même qualité. Achetez des crédits sur la page de tarification et commencez à générer immédiatement. Les clés API seront disponibles dans le tableau de bord au lancement de l’accès direct.

2

L’API Happyhorse-1.0 est-elle compatible avec ComfyUI ?

Oui. Le nœud personnalisé officiel Happyhorse pour ComfyUI utilise la même API REST en arrière-plan. Les crédits achetés pour l’application web sont interchangeables avec l’intégration ComfyUI. Consultez notre guide /comfyui pour les détails de configuration.

3

Quelles sont les limites de débit ?

Les limites de débit dépendent de votre formule de crédits. L’accès standard commencera à 10 tâches simultanées et 500 requêtes par minute. Les offres Enterprise proposent des limites personnalisées, des endpoints dédiés et des garanties de SLA — contactez-nous pour les tarifs Enterprise de l’API Happyhorse.

4

Un accès API Enterprise ou en marque blanche est-il disponible ?

Oui. Les clients Enterprise peuvent demander des endpoints d’inférence dédiés, des packs de crédits en volume, des SLA personnalisés et un affinement privé du modèle. Contactez-nous via la page de tarification et nous reviendrons vers vous avec une offre adaptée.

5

Les crédits de l’API Happyhorse expirent-ils ?

Les crédits achetés sur happyhorselab.net n’expirent pas tant que votre compte reste actif (au moins une connexion tous les 365 jours). La même politique de crédits pour l’API Happyhorse s’applique, que vous les utilisiez via l’application web, l’API ou le nœud ComfyUI.

6

Quels langages de programmation l’API Happyhorse prend-elle en charge ?

L’API REST Happyhorse-1.0 est une API HTTP standard — n’importe quel langage convient : Python, Node.js, Go, Ruby, PHP, Java, Rust, etc. Des SDK officiels pour Python et TypeScript sont prévus au lancement. D’ici là, utilisez n’importe quel client HTTP avec votre clé API Happyhorse dans l’en-tête Authorization.

Créez avec le modèle vidéo n°1 — dès aujourd’hui

N’attendez pas l’API. Utilisez Happyhorse-1.0 en ligne dès maintenant, payez par crédit, et votre solde est automatiquement reporté lors du lancement de l’API REST.