Utiliser HappyHorse 1.1 API sur EvoLink

Pour utiliser HappyHorse 1.1 via EvoLink, le workflow pratique est le suivant :

1. Choisir le model ID HappyHorse 1.1 adapté au type d'entrée.
2. Créer une tâche vidéo avec POST /v1/videos/generations.
3. Stocker le task ID retourné.
4. Interroger GET /v1/tasks/{task_id} ou configurer callback_url.
5. Télécharger ou déplacer le résultat vidéo avant d'en dépendre en production.

Réponse rapide

HappyHorse 1.1 propose trois routes sur EvoLink :

Ne mélangez pas HappyHorse 1.1 avec d'anciennes routes HappyHorse 1.0. La surface actuelle de HappyHorse 1.1 sur EvoLink correspond aux trois routes ci-dessus.

Faits confirmés

La génération vidéo doit être traitée comme un job async de production, pas comme un appel synchrone bloquant.

Choisir la bonne route

L'erreur fréquente consiste à choisir par nom au lieu de partir des assets disponibles.

Utilisez text-to-video pour l'idéation, image-to-video pour animer un asset et reference-to-video quand la cohérence entre références compte.

Préparer l'intégration

Les entrées image doivent être des URLs HTTP ou HTTPS publiques. Les liens intranet, storage authentifié et fichiers locaux ne sont pas adaptés à la production.

Workflow API de base

Exemple text-to-video

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.1-text-to-video",
    "prompt": "A cinematic product shot of a transparent electric scooter moving through a clean studio space, slow dolly camera, soft reflections",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "callback_url": "https://your-domain.com/webhooks/video-task-completed"
  }'

Exemple image-to-video

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.1-image-to-video",
    "image_urls": ["https://cdn.example.com/product-hero.png"],
    "prompt": "Animate the product with a smooth camera orbit and subtle studio lighting movement",
    "quality": "720p",
    "duration": 5,
    "callback_url": "https://your-domain.com/webhooks/video-task-completed"
  }'

Exemple reference-to-video

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.1-reference-to-video",
    "prompt": "character1 walks into the scene, picks up the object shown as character2, and places it on the table beside character3",
    "image_urls": [
      "https://cdn.example.com/person.png",
      "https://cdn.example.com/object.png",
      "https://cdn.example.com/scene.png"
    ],
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "callback_url": "https://your-domain.com/webhooks/video-task-completed"
  }'

Async status et callback_url

Après création, l'application reçoit un task ID. Stockez-le immédiatement et interrogez le statut :

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<TASK_ID> \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>'

Les réponses peuvent contenir statut, progression, model, informations de tâche, résultats et usage.

Planification des coûts

Liste de vérification production

Avec EvoLink, passer de HappyHorse à Seedance, Kling, Sora ou une autre route vidéo doit être une décision de sélection de modèle, pas une nouvelle intégration fournisseur.

Troubleshooting

Modèle d'implémentation

type HappyHorseRoute =
  | 'text-to-video'
  | 'image-to-video'
  | 'reference-to-video'

const happyHorseModelIdByRoute: Record<HappyHorseRoute, string> = {
  'text-to-video': 'happyhorse-1.1-text-to-video',
  'image-to-video': 'happyhorse-1.1-image-to-video',
  'reference-to-video': 'happyhorse-1.1-reference-to-video',
}

La couche de routage doit rester derrière la logique produit. L'UI collecte les assets disponibles ; le backend produit un model ID et un request body validé.

Quand utiliser un autre modèle vidéo EvoLink

FAQ

Quel endpoint utiliser pour HappyHorse 1.1 ?

Quels sont les model IDs HappyHorse 1.1 ?

Quel model ID utiliser pour un prompt seul ?

Quel model ID utiliser pour animer un premier frame ?

Quel model ID utiliser pour plusieurs images de référence ?

Image-to-video supporte-t-il aspect_ratio ?

Non. Le ratio vient de l'image source. Pour un contrôle explicite, utilisez text-to-video ou reference-to-video.

Puis-je utiliser callback_url ?

Oui. Utilisez HTTPS et rendez le handler idempotent.

Où trouver les prix actuels ?

Puis-je réutiliser la même API key EvoLink ?

Oui. HappyHorse 1.1 utilise la même API key et le même système de facturation EvoLink.

HappyHorse 1.1 supporte-t-il video-edit ?

La page actuelle et la référence API exposent text-to-video, image-to-video et reference-to-video. N'utilisez pas une route video-edit HappyHorse 1.0 comme route HappyHorse 1.1.

Références

• Page HappyHorse 1.1 API
• Référence API HappyHorse 1.1 Text-to-Video
• Référence API HappyHorse 1.1 Image-to-Video
• Référence API HappyHorse 1.1 Reference-to-Video