HappyHorse 1.1 API auf EvoLink verwenden

Wenn du HappyHorse 1.1 über EvoLink nutzen willst, ist der praktische Ablauf:

1. Wähle die HappyHorse 1.1 Model ID passend zu deinem Eingabetyp.
2. Erstelle einen Video-Task über POST /v1/videos/generations.
3. Speichere die zurückgegebene Task ID.
4. Frage GET /v1/tasks/{task_id} ab oder nutze callback_url.
5. Sichere das fertige Video, bevor deine Anwendung dauerhaft davon abhängt.

Schnelle Antwort

HappyHorse 1.1 hat auf EvoLink drei Routen:

Mische HappyHorse 1.1 nicht mit älteren HappyHorse 1.0 Routen. Die aktuelle EvoLink-Oberfläche für HappyHorse 1.1 besteht aus den drei Routen oben.

Bestätigte Fakten

Das bedeutet: Videogenerierung sollte als asynchroner Produktionsjob behandelt werden, nicht als synchroner API-Call, der einen Webrequest blockiert.

Die richtige Route wählen

Der häufigste Integrationsfehler ist, die Route nach Namen statt nach Eingabe-Assets zu wählen. Starte mit dem, was dein Workflow bereits besitzt.

Nutze text-to-video für Ideenfindung, image-to-video für Asset-Animation und reference-to-video, wenn Konsistenz über mehrere Referenzbilder wichtig ist.

Voraussetzungen

Für Bildeingaben müssen HTTP- oder HTTPS-URLs öffentlich erreichbar sein. Private Objekt-Storage-URLs, Intranet-Links und lokale Dateien sind keine geeigneten Produktionseingaben.

Grundlegender Request-Ablauf

Text-to-video Beispiel

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"
  }'

Image-to-video Beispiel

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"
  }'

Reference-to-video Beispiel

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 und callback_url

Nach dem Create Request erhält deine Anwendung eine Task ID. Speichere sie sofort und frage den Status ab:

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

Task-Antworten können Status, Fortschritt, Model, Task-Informationen, Ergebnisdetails und Usage-Informationen enthalten.

Kostenplanung

Produktions-Checkliste

Hier ist der Wert des EvoLink Gateways sichtbar: Wenn deine App eine saubere Routing-Schicht nutzt, wird der Wechsel zwischen HappyHorse, Seedance, Kling, Sora oder anderen Videomodellen zu einer Model-Selection-Entscheidung statt zu einer neuen Vendor-Integration.

Troubleshooting

Implementierungsmuster

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',
}

Die Routing-Schicht sollte hinter der Produktlogik sitzen. Die UI kann nach Prompt, First Frame oder mehreren Referenzen fragen; das Backend übersetzt die Antwort in eine Model ID und einen validierten Request Body.

Wann ein anderes EvoLink Videomodell sinnvoll ist

FAQ

Welchen Endpoint nutze ich für HappyHorse 1.1?

Welche HappyHorse 1.1 Model IDs gibt es?

Welche Model ID ist für reine Prompts richtig?

Welche Model ID ist für First-Frame-Animation richtig?

Welche Model ID ist für mehrere Referenzbilder richtig?

Unterstützt image-to-video aspect_ratio?

Nein. Image-to-video leitet das Output-Seitenverhältnis aus dem Quellbild ab. Für explizite Aspect-Ratio-Planung nutze text-to-video oder reference-to-video.

Kann ich callback_url verwenden?

Wo finde ich aktuelle Preise?

Kann ich denselben EvoLink API Key verwenden?

Ja. HappyHorse 1.1 nutzt denselben EvoLink API Key und dasselbe Billing-System wie andere Routen in deinem Account.

Unterstützt HappyHorse 1.1 video-edit?

Die aktuelle HappyHorse 1.1 Seite und API-Referenz zeigen text-to-video, image-to-video und reference-to-video. Verwende keine HappyHorse 1.0 video-edit Route als HappyHorse 1.1 Route.

Quellen

• HappyHorse 1.1 API Seite
• HappyHorse 1.1 Text-to-Video API-Referenz
• HappyHorse 1.1 Image-to-Video API-Referenz
• HappyHorse 1.1 Reference-to-Video API-Referenz