Einführung
HappyHorse 1.1 Bild-zu-Video animiert ein Anfangsbild aus image_url. Der Prompt ist Pflicht und beschreibt die folgende Bewegung; der Clip läuft 3 bis 15 ganze Sekunden in 720p oder 1080p, mit erzeugtem Soundtrack. Es gibt weder ein Feld für das Seitenverhältnis noch eines für ein Schlussbild: Das Still bestimmt die Form, und das Ende ist das, worauf die im Prompt beschriebene Bewegung hinausläuft.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| eine geschriebene Szene oder ein Skript | HappyHorse 1.1 Text-zu-Video |
| ein freigegebenes Startbild | HappyHorse 1.1 Bild-zu-Video |
| ein bis neun Referenzbilder | HappyHorse 1.1 Referenz-zu-Video |
Wichtige Funktionen und Highlights
Das Still bestimmt Motiv und Form
Dem Anfangsbild wird eng gefolgt; das macht diesen Weg zum verlässlichen Pfad zu einem wörtlichen Ergebnis, unzensierte Ausgangsbilder eingeschlossen. Im Beispiel tailgate-turn stammen Garderobe, Truck und Gegenlicht aus dem Bild, und der Prompt bittet sie nur, die Flasche zu senken, einmal mit den Stiefeln zu schwingen und den Kopf in die tiefe Sonne zu drehen.
Kein Schlussbild als Ziel
Dieser Endpunkt nimmt nur image_url an, eine Einstellung lässt sich also nicht auf eine Schlusskomposition festlegen. Am besten funktionieren Bewegungen, die sich von selbst auflösen. Das Beispiel quiet-hold besteht aus vier Sekunden fast völliger Ruhe: ein Ausatmen, eine sinkende Schulter und eine Gewichtsverlagerung gegen den Fensterrahmen, fast ohne Kamerabewegung.
Eingabe- und Ausgabegrenzen
Das Anfangsbild braucht mindestens 300 px je Seite, ein Seitenverhältnis zwischen 1:2,5 und 2,5:1 und höchstens 20 MB. Die Ausgabe läuft 3 bis 15 Sekunden, Standard sind 5, in 720p (Standard) oder 1080p, und der Soundtrack wird immer mit dem Bild erzeugt.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Pflicht. Beschreiben Sie, was sich nach dem Frame ändert – Handlung, Kamera, Tempo –, nicht den Frame selbst. mindestens 1 Zeichen · höchstens 2500 Zeichen |
image_url | Ja | Das Startbild. Es legt Motiv und Komposition fest und setzt die Ausgabeform. |
resolution | Nein | 720p oder 1080p. |
duration_seconds | Nein | Ganze Sekunden, 3 bis 15. Es gibt kein Schlussbild – halten Sie die Bewegung in dieser Zeit auflösbar. |
seed | Nein | Ganzzahl von 0 bis 2147483647 für den Zufallsstart; ohne Angabe zieht jeder Lauf seinen eigenen. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.14 / Sekunde |
| $0.18 / Sekunde |
Anwendungsfälle
Ein unzensiertes oder art-directed Bild animieren
Dieser Weg folgt dem Bild, das er erhält; unzensierte Arbeiten beginnen deshalb hier und nicht in text-to-video, das Prompts jenseits seiner Inhaltsgrenze ablehnt. Liefern Sie das entworfene Bild und schreiben Sie nur die Bewegung – das Motiv erscheint so, wie es gezeichnet oder fotografiert wurde, statt aus einem Satz neu gedeutet zu werden.
Umgebungsbewegung um eine gehaltene Pose
Das Beispiel wasteland-hood-two lässt zwei Figuren auf der Motorhaube eines liegengebliebenen Autos und schreibt nur, was in Bewegung existiert: zerrissener Stoff, den der Wind hebt und fallen lässt, flirrende Hitze, Staubteufel über der Straße und eine langsame Ranfahrt. Erzeugt wurde es in 1080p mit der Standarddauer.
Kurze Inserts und Zwischenschnitte
Ein Clip von drei oder vier Sekunden mit minimaler Kamerabewegung eignet sich für Inserts zwischen längeren Einstellungen. Beschränken Sie die Handlung auf einen Atemzug oder eine Geste, wie quiet-hold es tut, damit die Bewegung innerhalb der Dauer abschließt, statt mittendrin abzubrechen.
Prompt-Leitfaden und Praxistipps
Dem Prompt nur Bewegung geben
Der Prompt ist Pflicht, also verwenden Sie ihn für das, was sich verändert: Handlung, Kamera und Tempo. Der Prompt von wasteland-hood-two beschreibt nie die Komposition, sondern Wind, Hitzeflimmern und Staub. Wer das Bild neu beschreibt, verbraucht die Grenze von 2.500 Zeichen für das, was das Bild bereits festlegt.
Die Bewegung an die Dauer anpassen
Ohne Schlussbild hört eine Bewegung, die in der gewählten Zeit nicht fertig wird, einfach dort auf, wo der Clip endet. Passen Sie die Handlung der Länge an: eine Geste für einen kurzen Clip, eine kurze Folge wie senken, schwingen, drehen für einen längeren, so wie tailgate-turn es über sechs Sekunden tut.
Vor dem Hochladen zuschneiden
Das Still bestimmt die Ausgabeform, also schneiden Sie es zuerst auf das Lieferformat zu und prüfen die Größengrenzen. Entwerfen Sie in 720p und wiederholen Sie für die Lieferung in 1080p. Jeder Durchgang erzeugt einen eigenen Take, halten Sie den Wortlaut beim Vergleichen also fest.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
