HappyHorse 1.1 Bild zu Video: API-Anleitung und fünf echte Clips

Um ein Standbild mit HappyHorse 1.1 Bild zu Video zu beleben, schickst du es als first_frame an https://api.omniakey.com/v1/media/tasks, mit der Modell-ID happyhorse-1.1-i2v, fragst die Aufgabe ab und lädst die MP4-Datei herunter. Unsere fünf 5-Sekunden-Clips in 720P brauchten am 2. November 2026 zwischen 92 und 158 Sekunden. Jeder Clip hatte Musik, die wir nicht angefordert hatten, und die Standardeinstellung setzt ein "Happy Horse"-Wasserzeichen.

Kurze Antwort

• Die Anfrage: Modell happyhorse-1.1-i2v, Operation image_to_video und genau ein first_frame in input.media.
• Seitenverhältnis: Der Clip folgt deinem Standbild, weil es kein Feld ratio gibt.
• Länge und Auflösung: 3 bis 15 Sekunden in 480P, 720P oder 1080P; schicke resolution jedes Mal mit, denn Alibabas Standard ist 1080P.
• Wasserzeichen: standardmäßig an, mit watermark: false aus.
• Ton: Alle fünf Clips hatten Musik, Alibabas API listet keinen Schalter für Audio, und ffmpeg entfernt die Tonspur.

Was brauchst du vor dem ersten Aufruf von HappyHorse 1.1 Bild zu Video?

Drei Dinge: einen Schlüssel, Python 3 und ein Standbild, das Alibabas Regeln erfüllt.

• Den Schlüssel in OMNIAKEY_API_KEY. Das Skript sendet ihn als Bearer-Token, deshalb steht er nicht im Code.
• Python 3 ohne Installation. Das Skript nutzt nur die Standardbibliothek.
• Ein Standbild, das Alibabas Referenz für die Bild-zu-Video-API erfüllt: JPEG, JPG, PNG oder WEBP; Breite und Höhe mindestens 300 Pixel; bis 20 MB; Seitenverhältnis 1:2.5 bis 2.5:1. Alibaba nennt keine Obergrenze für Pixel.

Der Haken ist die Größe: Ein eingebettetes Standbild reist im Anfragekörper mit, und der ganze Körper muss in 1 MiB passen, Base64 eingeschlossen (OmniaKeys Übersicht zur Media-API, geprüft am 2. November 2026). Das Skript stoppt über 700 KB; darüber verkleinerst du das Standbild oder übergibst eine öffentliche HTTPS-URL. Unser 2K-Standbild hatte 2.254.819 Bytes, und dieser macOS-Befehl machte 92.212 Bytes daraus:

sips -s format jpeg -s formatOptions 85 -Z 1280 still.jpg --out still-small.jpg

Welche Felder nimmt die Anfrage?

Neun Felder bestimmen die Aufgabe: drei auf oberster Ebene, zwei in input und vier in parameters.

Vier Details übersieht man leicht.

• Es gibt kein Feld ratio: Der Clip behält das Seitenverhältnis deines Standbilds (Alibabas Referenz für die Bild-zu-Video-API, geprüft am 2. November 2026).
• Alibabas Seiten zeigen kein Feld für einen negativen Prompt.
• Jeder Aufruf zum Erstellen braucht den Header Idempotency-Key. Derselbe Körper erneut gesendet liefert die ursprüngliche Aufgabe und berechnet nie doppelt; ein anderer Körper ergibt 409 idempotency_key_reused (OmniaKeys Dokumentation zur Video-API, geprüft am 2. November 2026).
• Die Ausgabegröße schwankt: In OmniaKeys Dokumentation kommt ein Standbild mit 1200×630 in 720P als 1324×696 zurück.

Das Python-Skript

Das ist genau die Datei, die wir ausgeführt haben, nur mit der Standardbibliothek.

"""Animate one still with HappyHorse 1.1 image-to-video through the OmniaKey media API.

Usage:
    export OMNIAKEY_API_KEY="your-omniakey-api-key"
    python3 hh_i2v.py still.jpg "The camera slowly orbits the headphones." clip.mp4

The still can be a local JPEG or PNG (sent inline as a data URL) or a public https:// URL.
"""
import base64
import json
import mimetypes
import os
import sys
import time
import urllib.error
import urllib.request
import uuid

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {
    "Authorization": "Bearer " + os.environ["OMNIAKEY_API_KEY"],
    "Content-Type": "application/json",
    "User-Agent": "happyhorse-i2v-example/1.0",
}
POLL_SECONDS = 10
GIVE_UP_AFTER = 15 * 60  # most clips finish in 1-5 minutes


def call(method, url, body=None, extra_headers=None):
    data = json.dumps(body).encode() if body is not None else None
    req = urllib.request.Request(url, data=data, method=method, headers={**HEADERS, **(extra_headers or {})})
    for attempt in range(3):
        try:
            with urllib.request.urlopen(req, timeout=60) as resp:
                return json.load(resp)
        except urllib.error.HTTPError as err:
            sys.exit(f"HTTP {err.code}: {err.read().decode(errors='replace')}")
        except (urllib.error.URLError, TimeoutError, ConnectionError) as err:
            if attempt == 2:
                raise
            print("network error, retrying:", err)  # a retried POST keeps its Idempotency-Key
            time.sleep(5)


def first_frame_url(image):
    if image.startswith("https://"):
        return image
    raw = open(image, "rb").read()
    if len(raw) > 700_000:  # Base64 adds a third, and the whole request must stay under 1 MiB
        sys.exit("The still is over 700 KB. Resize it or pass a public https:// URL instead.")
    mime = mimetypes.guess_type(image)[0] or "image/jpeg"
    return f"data:{mime};base64,{base64.b64encode(raw).decode()}"


def main(image, prompt, out_path):
    task = call("POST", API, {
        "model": "happyhorse-1.1-i2v",
        "type": "video",
        "operation": "image_to_video",
        "input": {"prompt": prompt, "media": [{"type": "first_frame", "url": first_frame_url(image)}]},
        "parameters": {"resolution": "720P", "duration": 5, "watermark": False},  # watermark is on by default
    }, {"Idempotency-Key": str(uuid.uuid4())})
    print("task", task["id"], task["status"])

    start = time.time()
    while task["status"] in ("queued", "processing"):
        if time.time() - start > GIVE_UP_AFTER:
            sys.exit(f"Still {task['status']} after 15 minutes. Do not submit it again; "
                     f"check it later with GET {API}/{task['id']}")
        time.sleep(POLL_SECONDS)
        task = call("GET", f"{API}/{task['id']}")
    print(task["status"], "after", round(time.time() - start), "s")
    if task["status"] != "succeeded":
        sys.exit(json.dumps(task.get("error") or task))

    # The signed download URL is short-lived, so save the file right away.
    req = urllib.request.Request(task["assets"][0]["url"], headers={"User-Agent": HEADERS["User-Agent"]})
    with urllib.request.urlopen(req, timeout=300) as resp, open(out_path, "wb") as f:
        f.write(resp.read())
    print("saved", out_path)


if __name__ == "__main__":
    main(*sys.argv[1:4])

Speichere es als hh_i2v.py und starte es:

export OMNIAKEY_API_KEY="your-omniakey-api-key"
python3 hh_i2v.py still.jpg "The camera slowly orbits the headphones." clip.mp4

Unser Lauf mit watermark: false gab das aus:

task task_QqK3ZdAd72vmK1DSOuOxXSytBSaJ244v queued
succeeded after 91 s
saved data/clips/c5-orbit-nowm.mp4

Fünf Dinge im Skript sind wichtig.

• Es fragt alle 10 Sekunden ab.
• Es gibt nach 15 Minuten auf und rät in der Meldung, die Aufgabe nicht erneut zu senden.
• Bei einem Netzwerkfehler versucht es das erneut, und ein erneuter Aufruf zum Erstellen behält seinen Idempotency-Key, sodass du die ursprüngliche Aufgabe zurückbekommst statt einer zweiten Abbuchung.
• Es speichert die Datei, sobald die Aufgabe erfolgreich ist, weil die signierte Download-URL nur kurz gilt.
• Es sendet bei jeder Anfrage einen User-Agent: Der Standard von Python bekam in unserem Test der Kling 3.0 API am 29. Oktober 2026 von Cloudflare HTTP 403 mit error code: 1010.

Fünf Clips, die wir erstellt haben

Wir erzeugten vier Standbilder mit Nano Banana 2.1 und ließen das Kopfhörer-Bild zweimal laufen, um das Wasserzeichen zu prüfen. So entstanden fünf Clips, alle 5 Sekunden lang und in 720P, am 2. November 2026. Die Clips mit Porträt, See und Fuchs liefen mit den Standardeinstellungen, deshalb ist das Wasserzeichen in diesen Bildern zu sehen.

Kopfhörer auf der Kreisbahn

The camera slowly orbits about 90 degrees to the right around the headphones while a soft band of light sweeps across the ear cups. The headphones stay perfectly still on the pedestal. Smooth, steady product-commercial camera move.

Die Kamera schwenkt von einer Seite der Kopfhörer zur anderen, und sie bleiben auf dem Sockel. In den mittleren Bildern erscheint dahinter die gebogene Kante eines Hintergrunds, die im Standbild fehlt, und das Lichtband aus dem Prompt ist kaum zu sehen.

Denselben Prompt auf demselben Standbild ließen wir zweimal laufen, einmal mit den Standardeinstellungen und einmal mit watermark: false; in der Ecke zeigt sich der Unterschied.

Porträt im Regen

She slowly turns her head toward the camera and gives a small smile while light rain keeps falling. The neon signs behind her flicker softly and the camera pushes in a little.

Sie dreht sich vom Blick nach links zur Kamera und lächelt, in der Reihenfolge aus dem Prompt, und das Wasserzeichen sitzt in jedem Bild. Der Prompt verlangte einen leichten Push-in, und die Einstellung geht von halbnaher Sicht zur Nahaufnahme ihres Gesichts.

Push-in am See

Slow aerial push-in over the water toward the rowboat. Mist drifts across the lake, the boat rocks gently and small ripples spread from its hull, and the golden light grows a little brighter.

Die Kamera fährt wie gewünscht auf das Boot zu. Am Ende füllt das Boot fast das ganze Bild, und vom Rumpf breiten sich Wellen aus.

Fuchs-Illustration

The fox turns a page of the book with its paw and its ears twitch. A few orange leaves drift down from the tree and the branches sway gently. Keep the flat illustration style.

Der flache Illustrationsstil bleibt vom ersten bis zum letzten Bild erhalten, während orange Blätter herabfallen. Die Kamera zoomt vom ganzen Baum auf eine nahe Ansicht des Fuchses, was der Prompt nie verlangte; die Buchseiten heben sich, doch die Bilder bestätigen nicht, dass die Pfote eine Seite umblättert.

In 2 unserer 4 Prompts bewegte sich die Kamera stärker als verlangt, prüfe den Bildausschnitt deshalb mit einem kurzen Test. Ein 3-Sekunden-Clip in 480P ist die kürzeste und niedrigste Stufe in den Dokumenten (Alibabas Referenz für die Bild-zu-Video-API, geprüft am 2. November 2026).

Was die Dateien gemessen haben

Jede Datei meldet 5.16 Sekunden, obwohl wir 5 verlangt haben: Das ist die Tonspur, während die Videospur bei 123 Bildern 5.13 Sekunden und bei 121 Bildern 5.04 Sekunden läuft. Alle fünf sind H.264 mit 24 fps und einer AAC-Tonspur mit zwei Kanälen, und ein Skript zur Schnitterkennung fand in keiner Datei einen Schnitt.

Unsere Clips brauchten 92 bis 158 Sekunden vom Absenden bis zum Download, gegenüber den 1 bis 5 Minuten, die Alibabas Dokumente für Bild-zu-Video-Aufgaben nennen (Alibabas Referenz für die Bild-zu-Video-API, geprüft am 2. November 2026). 480P, 1080P, andere Längen, seed, eine öffentliche Bild-URL, HappyHorse 1.0 und Alibabas eigenen Endpunkt haben wir nicht getestet. Für die Wahl zwischen Modellen sieh dir HappyHorse 1.1 gegen Seedance 2.0 und HappyHorse 1.1 gegen Kling 3.0 an. Wer einen Clip ohne Code wiederholen will, findet HappyHorse 1.1 im KI-Video-Generator.

Warum haben die Clips Ton?

HappyHorse 1.1 legte allen fünf Clips eine Tonspur bei, obwohl keiner unserer Prompts eine verlangte. Gehört hat sie niemand: Wir baten Gemini 3.8 Flash über die OmniaKey API, jede Spur zu beschreiben.

In keinem Clip meldete es Sprache. Derselbe Prompt und dasselbe Standbild ergaben bei zwei Läufen zwei verschiedene Spuren.

Alibabas Referenz für Bild zu Video listet kein Audiofeld und keine stille Option, doch die Versionsnotiz zu 1.1 erwähnt die Synchronisation von Ton und Bild (Alibabas Seite der neu veröffentlichten Modelle, geprüft am 2. November 2026). Für eine stille Datei entfernst du die Spur nach dem Download:

ffmpeg -i clip.mp4 -an -c:v copy silent.mp4

Wir führten das beim Clip mit watermark: false aus, und das Ergebnis hat eine Videospur und keine Tonspur. Das Bild bleibt genau gleich, weil -c:v copy die Spur kopiert statt sie neu zu kodieren.

Wie lange sind Ergebnisse verfügbar?

Bei OmniaKey gilt der signierte Link zu deiner MP4-Datei etwa 1 Stunde, und der Datensatz der Aufgabe bleibt 24 Stunden erhalten; frage die Aufgabe erneut ab, um eine frische URL zu bekommen (OmniaKeys Übersicht zur Media-API, geprüft am 2. November 2026). In Alibabas eigener API gelten die Video-URL und die Aufgaben-ID beide 24 Stunden, danach gibt eine Abfrage UNKNOWN zurück und die Datei ist weg. Lade herunter, sobald eine Aufgabe erfolgreich ist.

Auf welche Fehler triffst du?

Keiner unserer fünf Läufe schlug fehl, deshalb stammt diese Liste aus OmniaKeys Dokumentation zur Video-API, geprüft am 2. November 2026.

Eine Aufgabe, die mit failed endet, wird automatisch erstattet, ein abgelehntes Rendering kostet also nur deine Zeit (OmniaKeys Übersicht zur Media-API, geprüft am 2. November 2026).

Der Fehler, den du vermeiden solltest, ist ein Timeout auf deiner Seite als fehlgeschlagene Aufgabe zu lesen. Frage dieselbe Aufgaben-ID erneut ab; ein neues Absenden startet eine zweite Aufgabe und eine zweite Abbuchung. Wenn du wirklich erneut sendest, behalte denselben Idempotency-Key und denselben Körper, dann bekommst du die ursprüngliche Aufgabe zurück.

Was kostet ein Clip mit HappyHorse 1.1?

Ein 5-Sekunden-Clip in 720P kostet $0.70 zu Alibabas Listenpreis in Singapur. Das sind Alibabas Preise pro Sekunde von seiner Preisseite, geprüft am 2. November 2026:

Die Rechnung ist der Preis pro Sekunde mal die Sekunden der Ausgabe. Fehlgeschlagene Anfragen werden nicht berechnet. Singapur enthält außerdem ein kostenloses Kontingent von 10 Sekunden, gültig 90 Tage. Auf der Preisseite gelten die Global-Preise für Frankfurt, Virginia und Tokio.

OmniaKey rechnet pro Sekunde gerenderter Ausgabe ab und bucht beim Erstellen der Aufgabe im Voraus, fehlgeschlagene oder stornierte Aufgaben werden automatisch erstattet; die aktuellen Sätze stehen auf der Seite zu HappyHorse 1.1.

Kannst du Alibaba Cloud direkt aufrufen?

Ja. HappyHorse läuft auf Alibaba Cloud Model Studio, mit regionalen Endpunkten für Singapur, USA (Virginia), Peking, Frankfurt und Tokio (Alibabas Referenz für die Bild-zu-Video-API, geprüft am 2. November 2026). Unsere Läufe gingen über OmniaKeys API, das Folgende stammt deshalb aus Alibabas Dokumenten.

• Erstelle mit POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis für Singapur.
• Sende den Header X-DashScope-Async: enable, sonst scheitert die Anfrage mit "current user api does not support synchronous calls".
• Frage GET .../api/v1/tasks/{task_id} etwa alle 15 Sekunden ab; der Status läuft durch PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED, UNKNOWN.
• Halte Modell, Endpunkt und Schlüssel in derselben Region, denn Aufrufe über Regionen hinweg scheitern.
• Ein Schlüssel bekommt 5 Anfragen pro Sekunde und 5 gleichzeitige Aufgaben (Alibabas Seite zu Ratenlimits, geprüft am 2. November 2026).

Die Preisseite nennt Tokio, die Seite zu Ratenlimits führt dort aber kein 1.1 Bild zu Video, deshalb bleibt Tokio unbestätigt.

Häufige Fragen

Brauche ich für HappyHorse Bild zu Video einen Prompt?

Bei OmniaKey ja: Eine Aufgabe ohne input.prompt bekommt 400 invalid_request (OmniaKeys Dokumentation zur Video-API, geprüft am 2. November 2026). Alibabas eigene API behandelt den Prompt als optional und nimmt nur das erste Bild. Nenne in beiden Fällen die Bewegung und die Kamerafahrt, wie es unsere Prompts oben tun.

Wie entferne ich das Wasserzeichen Happy Horse?

Sende parameters.watermark: false. Der Standard true zeichnet kleinen weißen Text "Happy Horse" in die untere rechte Ecke; unser zweiter Kreisbahn-Clip kam mit false sauber zurück.

Wie lege ich das Seitenverhältnis fest?

Schneide das Standbild zu. Bild zu Video hat kein Feld ratio, und der Clip folgt der Form des ersten Bildes, deshalb ergab unser 16:9-Standbild einen 16:9-Clip und das Porträt einen 9:16-Clip. Halte den Zuschnitt zwischen 1:2.5 und 2.5:1.

Gibt es HappyHorse 1.5?

Nichts nach 1.1 erscheint in Alibabas Modellliste, den Preistabellen oder der Seite zum Lebenszyklus, Stand 2. November 2026, und die neueste Version auf diesen Seiten ist happyhorse-1.1-i2v, veröffentlicht am 16. Juni 2026. Manche Seiten verwenden den Namen "Happy Horse 1.5".

Ist HappyHorse 1.1 für Bild zu Video besser als 1.0?

Alibaba sagt, 1.1 verbessert Bildqualität, Bewegung und Konsistenz zwischen Clips, und die Preisseite listet eine 480P-Stufe nur für 1.1. 1.1 erschien am 16. Juni 2026 und 1.0 am 22. April 2026. Zu Alibabas Satz in Singapur kostet 1080P bei 1.1 $0.18 pro Sekunde gegenüber $0.24 bei 1.0.

Geprüfte Quellen

• Alibaba Cloud: Referenz für die HappyHorse-Bild-zu-Video-API, geprüft am 2. November 2026
• Alibaba Cloud: Modellpreise, geprüft am 2. November 2026
• Alibaba Cloud: Modelle, geprüft am 2. November 2026
• Alibaba Cloud: neu veröffentlichte Modelle, geprüft am 2. November 2026
• Alibaba Cloud: Ratenlimits, geprüft am 2. November 2026

OmniaKeys eigene Dokumentation, geprüft am 2. November 2026: Video-API und Übersicht zur Media-API.