/happyhorse/videos und den Parameter action Text-zu-Video, Erstbild-zu-Video, Referenzbild-zu-Video und Videobearbeitung.
Antragsprozess
Um die HappyHorse Videos API zu verwenden, rufen Sie zunächst die Ace Data Cloud-Konsole auf, um Ihr API-Token zu erhalten, und bewahren Sie es als Reserve auf.
Wenn 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.
Ein API-Token kann alle Dienste der Plattform aufrufen, ohne dass für jeden Dienst ein separater Antrag erforderlich ist. Beim ersten Antrag wird ein kostenloses Kontingent gewährt, das kostenlos getestet werden kann; bei unzureichendem Kontingent kann in der Konsole ein allgemeines Guthaben aufgeladen werden.
📘 Vollständige Dokumentation: HappyHorse Videos API →
Aktionstypen
action bestimmt den Generierungsmodus dieser Anfrage:
generate: Text-zu-Video, die Standardaktion, unterstützthappyhorse-1.0-t2vundhappyhorse-1.1-t2v;promptmuss übergeben werden.image_to_video: Erstbild-zu-Video, unterstützthappyhorse-1.0-i2vundhappyhorse-1.1-i2v;image_urlmuss übergeben werden.reference_to_video: Referenzbild-zu-Video, 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 überimage_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; auch Parameter wie resolution, ratio und duration können angegeben werden:
success: Ob diese Anfrage erfolgreich war.task_id: Aufgaben-ID auf der Ace-Data-Cloud-Seite, kann zur Abfrage des Aufgabenstatus verwendet werden.trace_id: Tracking-ID dieser Anfrage, wird zur Fehleranalyse verwendet.data: Liste der Videoergebnisse.id: Aufgaben-ID auf der HappyHorse-Seite.video_url: CDN-Linkadresse des generierten Videos.state: Aufgabenstatus, optionalpending/succeeded/error.duration: Abgerechnete Videodauer in Sekunden; beivideo_editdie Gesamtdauer von Eingabe- und Ausgabevideo.resolution: Ausgabeauflösung.ratio: Ausgabe-Seitenverhältnis.
Erstbild-zu-Video
Bei Verwendung vonimage_to_video wird image_url als erstes Videobild verwendet. Das Ausgabe-Seitenverhältnis folgt möglichst dem Bild des ersten Frames, daher muss bei dieser Aktion kein ratio übergeben werden.
Referenzbild-zu-Video
Bei Verwendung vonreference_to_video können über image_urls 1–9 Referenzbilder übergeben werden. Im Prompt können die Bilder in der entsprechenden Reihenfolge mit character1, character2 usw. referenziert werden.
Videobearbeitung
Bei Verwendung vonvideo_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 lokale Ersetzung. audio_setting kann optional auto oder origin sein, wobei origin bedeutet, dass der Originalton des Videos beibehalten wird.
Asynchroner Rückruf
Die Videogenerierung benötigt eine gewisse Verarbeitungszeit. Wenn Sie nicht warten möchten, während eine lange Verbindung offen bleibt, können Siecallback_url übergeben. In diesem Fall gibt die API sofort task_id zurück, und nach Abschluss der Aufgabe wird das endgültige Ergebnis per POST an diese Adresse gesendet:
"async": true übergeben und anschließend das Aufgabenergebnis über die HappyHorse Tasks API abfragen.
Abrechnungshinweise
HappyHorse rechnet nach der Anzahl der Sekunden des ausgegebenen Videos und der Auflösung ab:720P: Ab etwa 0,105 $ / Sekunde.1080P: Ab etwa 0,18 $ / Sekunde.video_edit: Abrechnung nach der Gesamtdauer des Eingabevideos und des Ausgabevideos; die tatsächliche Abrechnungsdauer richtet sich nach den Statistiken nach Abschluss der Aufgabe.
Fehlerbehandlung
Wenn ein Problem mit der Anfrage auftritt, gibt die API den entsprechenden Fehlercode und eine Beschreibung zurück. Häufige Fälle sind:400: Anfrageparameter sind fehlerhaft, beispielsweise 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 die Eingabeaufforderung wurde aufgrund der Inhaltsprüfung abgelehnt.429: Die Anfragen erfolgen zu häufig und haben die Ratenbegrenzung ausgelöst. Bitte versuchen Sie es später erneut.500: Interner Serverfehler oder Generierung fehlgeschlagen.

