img_uuid und fragen Sie dann den Status ab oder empfangen Sie HTTPS-Callbacks für das Ergebnis.HappyHorse 1.1 API für Videogenerierung
Greifen Sie auf die HappyHorse 1.1 API über die unabhängige GoEnhance Open API für Text-zu-Video, Erstbild-zu-Video oder einen separaten Referenzbild-Workflow zu. Übermitteln Sie eine asynchrone Aufgabe, speichern Sie die zurückgegebene
Einen API-Schlüssel erstellen
Den richtigen HappyHorse API-Modus wählen
Text-zu-Video
Senden Sie model: happyhorse-1-1 mit einem erforderlichen Prompt und ohne image_url. Wählen Sie ein dokumentiertes Seitenverhältnis, eine Dauer und eine Auflösung für das generierte Video.
Erstbild-zu-Video
Fügen Sie image_url hinzu, um ein erstes Bild zu animieren. Das Bild muss im JPEG-, PNG- oder WEBP-Format vorliegen, mindestens 300px groß sein, unter 10 MB wiegen und innerhalb des dokumentierten Bereichs von 1:2,5 bis 2,5:1 liegen.
Referenzbild-Video
Verwenden Sie model: happyhorse-1-1-ref mit 1–9 URLs in image_urls. Verweisen Sie im Prompt auf jede Quelle als [Image 1], [Image 2] usw.
Validieren Sie den ausgewählten Anfragemodus, bevor Sie Arbeit an Ihre Produktionswarteschlange senden.
HappyHorse 1.1 API-Funktionen und -Limits
Zwei Standard-Eingabemodi
Verwenden Sie nur einen Prompt für Text-zu-Video oder fügen Sie eine <code>image_url</code> für Erstbild-zu-Video hinzu.
Separates Multi-Referenz-Modell
Verwenden Sie <code>happyhorse-1-1-ref</code> mit 1–9 erforderlichen Referenzbild-URLs; es unterstützt kein reines Text-zu-Video.
3–15 Sekunden Dauer
Setzen Sie <code>duration</code> auf eine Ganzzahl von 3 bis 15 Sekunden. Der dokumentierte Standardwert beträgt 5 Sekunden.
720p- oder 1080p-Ausgabe
Wählen Sie <code>720p</code> oder <code>1080p</code>. Der dokumentierte Standardwert ist <code>720p</code>.
Hochformat-, Quadrat- und Querformat-Seitenverhältnisse
Die Standardroute unterstützt 16:9, 9:16, 1:1, 4:3 und 3:4. Der Referenzmodus listet zusätzlich 4:5 und 5:4.
Abfrage und Callbacks
Speichern Sie die <code>img_uuid</code>, fragen Sie den Job-Detail-Endpunkt ab oder stellen Sie eine öffentliche HTTPS-Callback-URL für Status-Updates bereit.
GoEnhance dokumentiert die sekundengenaue Preisgestaltung mit $0.02 pro Token und kennzeichnet diese Tarife derzeit als zeitlich begrenztes Angebot.
HappyHorse 1.1 API-Preisgestaltung
720p: $0.104 pro Sekunde
Die 720p-Generierung verbraucht 5,2 Token pro Sekunde. Eine 5-Sekunden-Anfrage verbraucht 26 Token oder $0.52 gemäß der dokumentierten Umrechnung.
1080p: $0.144 pro Sekunde
Die 1080p-Generierung verbraucht 7,2 Token pro Sekunde, was $0.144 pro generierter Sekunde entspricht.
Schätzung nach Dauer
Multiplizieren Sie den gewählten Sekundentarif mit der gewünschten Dauer von 3–15 Sekunden. Überprüfen Sie vor Produktionschargen die aktuelle API-Referenz, da sich Aktionspreise ändern können.
Integration der HappyHorse 1.1 API
1
1. API-Schlüssel erstellen und schützen
Erstellen Sie einen GoEnhance-Schlüssel und senden Sie ihn als Bearer-Autorisierung aus einem vertrauenswürdigen serverseitigen Code.
2
2. Modell auswählen
Wählen Sie
happyhorse-1-1 für die reine Prompt-Generierung oder die Generierung des ersten Frames, oder happyhorse-1-1-ref für 1–9 Referenzbilder. 3
3. Payload erstellen und validieren
Geben Sie den erforderlichen Prompt an und validieren Sie dann Bildfelder, Dauer, Auflösung, Seitenverhältnis und Callback-URL für den gewählten Modus.
4
4. Video-Task übermitteln
Senden Sie einen POST-Request an
https://api.goenhance.ai/api/v1/videos/generations und speichern Sie die zurückgegebene img_uuid. 5
5. Status verfolgen
Fragen Sie
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... ab oder empfangen Sie Statusänderungen über einen öffentlichen HTTPS-Callback. 6
6. Terminales Ergebnis verarbeiten
Verarbeiten Sie Erfolge und Fehler idempotent, verifizieren Sie das zurückgegebene Asset und vermeiden Sie doppelte nachgelagerte Arbeit, wenn sich Abfragen und Callbacks überschneiden.
Verbinden Sie strukturierte Generierungsanfragen mit Workflows für Überprüfung, Speicherung und Bereitstellung.
Entwickler-Anwendungsfälle für die HappyHorse API
Kampagnen-Video-Varianten
Generieren Sie kurze Motion-Konzepte aus strukturierten Prompts für kreative Überprüfungen und nachgelagerte Bearbeitung.
Produkt- und Markenanimation
Animieren Sie einen freigegebenen ersten Frame, während Ihr Backend Dauer, Auflösung und Abschlussbehandlung steuert.
Studien zur Charakterinteraktion
Verwenden Sie das Referenzmodell, um zu beschreiben, wie Subjekte aus freigegebenen Quellbildern gemeinsam in einer Szene erscheinen sollen.
Storyboard-Previsualisierung
Verwandeln Sie Shot-Beschreibungen in überprüfbare Clips, bevor Sie sich auf einen größeren Produktions-Workflow festlegen.
Lokalisierte Kreativ-Pipelines
Parametrisieren Sie Prompts für regionale Varianten, während die Task-Übermittlung und -Überwachung konsistent bleiben.
Automatisierte Asset-Warteschlangen
Verbinden Sie Generierung, Job-Status-Persistenz, Callbacks, Speicherung und menschliche Freigabe in einem Backend-Service.
Antworten zu Preisen, Anfragemodi, Eingabelimits und der Handhabung asynchroner Aufgaben.