/happyhorse/videos und den Parameter action.
Antragsprozess
Um die HappyHorse Videos API zu verwenden, rufen Sie zunächst die Ace Data Cloud-Konsole auf, um Ihren API-Token abzurufen und für die spätere Verwendung aufzubewahren.
Falls Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach Abschluss kehren Sie automatisch zur aktuellen Seite zurück.
Mit einem API-Token können alle Dienste der Plattform aufgerufen werden, ohne dass Sie ihn für jeden Dienst separat beantragen müssen. Bei der ersten Beantragung erhalten Sie ein kostenloses Guthaben zum kostenlosen Ausprobieren; bei unzureichendem Guthaben können Sie Ihr allgemeines Guthaben in der Konsole aufladen.
📘 Vollständige Dokumentation: HappyHorse Videos API →
Aktionstypen
action bestimmt den Generierungsmodus dieser Anfrage:
generate: Text-zu-Video, die standardmäßige action, unterstützthappyhorse-1.0-t2vundhappyhorse-1.1-t2v;promptmuss übergeben werden.image_to_video: Bild-zu-Video mit dem ersten Frame, unterstützthappyhorse-1.0-i2vundhappyhorse-1.1-i2v;image_urlmuss übergeben werden.reference_to_video: Bild-zu-Video mit Referenzbildern, unterstützthappyhorse-1.0-r2vundhappyhorse-1.1-r2v;promptund 1–9image_urlsmüssen übergeben werden.video_edit: Videobearbeitung, unterstützthappyhorse-1.0-video-edit;promptundvideo_urlmüssen übergeben werden, zusätzlich können 0–5 Referenzbilder alsimage_urlsübergeben werden.
video_edit gibt es derzeit nur happyhorse-1.0-video-edit.
Grundlegende Verwendung
Für Text-zu-Video muss nurprompt bereitgestellt werden; Parameter wie resolution, ratio und duration können ebenfalls angegeben werden:
success: Ob diese Anfrage erfolgreich war.task_id: Die Aufgaben-ID auf der Seite von Ace Data Cloud, die zum Abfragen des Aufgabenstatus verwendet werden kann.trace_id: Die Tracking-ID dieser Anfrage, die zur Fehlerbehebung verwendet wird.data: Liste der Videoergebnisse.id: Die Aufgaben-ID auf der Seite von HappyHorse.video_url: Die CDN-Linkadresse des generierten Videos.state: Aufgabenstatus, optionalpending/succeeded/error.duration: Abrechenbare Videodauer in Sekunden; beivideo_editdie Gesamtdauer von Eingabe- und Ausgabevideo.resolution: Ausgabeauflösung.ratio: Ausgabe-Seitenverhältnis.
Bild-zu-Video mit dem ersten Frame
Bei der Verwendung vonimage_to_video wird image_url als erster Frame des Videos verwendet. Das Ausgabe-Seitenverhältnis folgt nach Möglichkeit dem Bild des ersten Frames, daher muss für diese Aktion ratio nicht übergeben werden.
Bild-zu-Video mit Referenzbildern
Bei der Verwendung vonreference_to_video können 1–9 Referenzbilder in image_urls übergeben werden. Im Prompt können die Bilder in der entsprechenden Reihenfolge mit character1, character2 usw. referenziert werden.
Videobearbeitung
Die Ausgabedauer und das Bildformat vonvideo_edit werden vom Quellvideo übernommen; die Übergabe von duration oder ratio ändert sie nicht. Auch das Bildformat von Bild-zu-Video übernimmt das Quellbild. Die Bearbeitungskosten werden anhand der Gesamtdauer von Eingabe- und Ausgabevideo berechnet.
Bei der Verwendung von video_edit müssen das zu bearbeitende Video video_url und die Bearbeitungsabsicht prompt übergeben werden. Optionale image_urls werden als Referenzbilder verwendet, beispielsweise für Kleidungswechsel, Stilübertragung oder lokalen Ersatz. audio_setting kann optional auto oder origin sein, wobei origin bedeutet, dass das Originalaudio des Videos beibehalten wird.
Asynchroner Rückruf
Die Videogenerierung benötigt eine gewisse Verarbeitungszeit. Wenn Sie nicht auf eine lange Verbindung warten möchten, können Siecallback_url übergeben. In diesem Fall gibt die API sofort task_id zurück, und nach Abschluss der Aufgabe wird das Endergebnis per POST an diese Adresse gesendet:
"async": true übergeben und anschließend das Aufgabenergebnis über die HappyHorse Tasks API abfragen.
Abrechnungshinweise
HappyHorse berechnet nach Sekunden des Ausgabevideos und Auflösung:720P: bereits ab ca. $0.105 / Sekunde.1080P: bereits ab ca. $0.18 / Sekunde.video_edit: Die Abrechnung erfolgt nach der Gesamtdauer des Eingabe- und Ausgabevideos; die tatsächliche Abrechnungsdauer richtet sich nach der Statistik nach Abschluss der Aufgabe.
Fehlerbehandlung
Wenn bei der Anfrage ein Problem auftritt, gibt die API den entsprechenden Fehlercode und eine Beschreibung zurück. Häufige Fälle sind:400: Anfrageparameter sind fehlerhaft, z. B. stimmen action und model nicht überein,prompt/image_url/video_urlfehlt, oderdurationliegt außerhalb des Bereichs von 3–15 Sekunden.401: Authentifizierung fehlgeschlagen, das Token ist ungültig oder stimmt nicht mit der API überein.403: Unzureichendes Guthaben oder der Prompt wurde von der Inhaltsprüfung abgelehnt.429: Zu häufige Anfragen haben die Ratenbegrenzung ausgelöst. Bitte versuchen Sie es später erneut.500: Interner Serverfehler oder Generierung fehlgeschlagen.

