Wie verwende ich die Grok Imagine 1.5 Lite Image-to-Video API? Fotos zum Leben erwecken

TL;DR

• Grok Imagine 1.5 Lite Image to Video (grok-imagine-1.5-lite/image-to-video): Lade 1 Bild hoch und lass es sich bewegen – 1–15 Sekunden, mit integrierten Soundeffekten, Seitenverhältnis folgt dem Input-Bild. Modellseite öffnen, ein Bild hochladen und ausprobieren – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Preis = Sekundenpreis × Sekunden + $0.015 Input-Bild-Gebühr pro Video: 720P 6 Sekunden $0.273; 480P $0.189; 1080P $1.215.
• Aufruf über die HiAPI /v1/tasks-Schnittstelle: image_url ist ein String (kein Array), genau 1 öffentliche URL.

Was es kann

• Ein Foto wird zu einer Szene mit Ton: Bewegung, Kamerafahrt und Soundeffekte werden per Prompt beschrieben, das Hauptmotiv bleibt das Originalbild.
• Seitenverhältnis folgt dem Input-Bild: Querformat ergibt 16:9 (1264×720), Hochformat 9:16 (720×1264), Quadrat 1:1 (960×960), 4:3 ergibt 1104×816 – Pixel werden auf unterstützte Größen gerundet, das Verhältnis bleibt gleich.
• 1–15 Sekunden, beliebige ganze Sekunden, drei Auflösungsstufen.
• Text-to-Video derselben Serie: Zur Generierung von Grund auf siehe Text-to-Video-Integrationsleitfaden; beide Schnittstellen kosten gleich (bei Image-to-Video kommt eine $0.015 Input-Bild-Gebühr hinzu), nutzen dasselbe /v1/tasks, der Code unterscheidet sich nur in model und image_url.

So liest man die Preistabelle:

• „Sekundenpreis × Sekunden“ sind die Kosten für das Video selbst, exakt wie bei Text-to-Video;
• $0.015 ist ein Zuschlag für das Input-Bild, pro Video einmalig, unabhängig von Auflösung und Dauer;
• Bei gleichen Parametern ist Image-to-Video daher $0.015 teurer als Text-to-Video: 720P 6 Sekunden $0.258 + $0.015 = $0.273. Bei tausend Videos beträgt dieser Unterschied $15 – im Budget einplanen.

Hier das echte Ergebnis (Surffoto → 6-sekündige Tracking-Aufnahme mit Wellenrauschen):

The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.

(Auf Deutsch: Die Welle rollt hinter dem Surfer und bricht, während er ihre Flanke hinuntergleitet, weiße Gischt bricht hervor und funkelt im goldenen Gegenlicht. Die Kamera folgt dem Surfer gleichmäßig. Laute Meeresbrandung und rauschendes Wasser. Halte das Foto realistisch. Kein Text, keine Logos.)

·

grok-imagine-1.5-lite/image-to-video, 720P, 6 Sekunden, 16:9, 1264×720, mit Soundeffekten, $0.273 (inkl. $0.015 Input-Bild-Gebühr).Kompletten Clip ansehen →

Mit diesem Prompt generieren →

Preis: Sekundenpreis + Input-Bild-Gebühr

Stufe	Pro Sekunde	6 Sekunden pro Video (inkl. $0.015 Input-Bild-Gebühr)
480P	$0.029	$0.189
720P (Standard)	$0.043	$0.273
1080P	$0.20	$1.215

Aktueller HiAPI-Preis, geprüft am 23. Oktober 2026. image_url ist Pflicht, daher enthält jedes Video diese $0.015; 1080P kostet $0.2 pro Sekunde (etwa das 4,65-Fache von 720P), für Stapel-Experimente 480P verwenden. Bei Fehlschlag wird nichts berechnet.

Zwei Einstiegswege

Browser in 3 Schritten: Modellseite öffnen → Bild hochladen, Bewegungsbeschreibung eingeben → Generieren klicken.

API in 3 Schritten: POST /v1/tasks absenden → taskId erhalten → mit GET /v1/tasks/<taskId> auf success prüfen und herunterladen.

curl: das erste Video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "grok-imagine-1.5-lite/image-to-video",
  "input": {
    "prompt": "The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.",
    "image_url": "https://static.hiapi.ai/gallery/2026/10/3f75ff28db9e0070.png",
    "duration": 6,
    "resolution": "720p"
  }
}'

Beachte, dass image_url ein String ist und nur ein Bild übergeben wird – ein Array führt zu 400.

Python: Senden, Abfragen, Herunterladen

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "grok-imagine-1.5-lite/image-to-video",
    "input": {
        "prompt": "The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.",
        "image_url": "https://example.com/your-image.png",
        "duration": 6,
        "resolution": "720p",
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    mp4 = requests.get(video["url"], timeout=120)   # temporäre Adresse, sofort speichern
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

Parametertabelle

Feld	Pflicht	Wert	Beschreibung
image_url	Ja	String, genau 1 öffentliche URL	Ausgabeverhältnis folgt diesem Bild
prompt	Ja	1–4096 Zeichen	Gewünschte Bewegung oder Veränderung beschreiben, inkl. Soundeffekte
duration	Nein	Beliebige ganze Zahl 1–15, Standard 6
resolution	Nein	480p / 720p / 1080p, Standard 720p

Felder außerhalb der Tabelle im Request-Body führen direkt zu 400.

Fehler, die dir begegnen werden

Statuscode	Bedeutung	Was tun
400 INVALID_REQUEST	Ungültiger Request-Body (fehlende image_url, image_url als Array, Feld außerhalb der Tabelle)	image_url als String verwenden
402 INSUFFICIENT_QUOTA	Guthaben unzureichend (keine Berechnung)	Nach Aufladen erneut versuchen
429 RATE_LIMITED	Rate-Limit ausgelöst	Anfragefrequenz senken
409 / 422 IDEMPOTENCY_KEY_*	Doppelte Übermittlung mit demselben Idempotenzschlüssel	Neuen Idempotency-Key verwenden

Bei Endstatus-Fehlschlag gibt es außerdem CONTENT_POLICY_VIOLATION, TASK_FAILED, TASK_TIMEOUT usw.; bei Fehlschlag wird nichts berechnet.

Vor dem Livegang beachten

• Callback: Videoaufgaben dauern lange; übergebe auf oberster Ebene "callback": {"url": "https://..."}, um Polling zu sparen.
• Rechtzeitig sichern: Die Video-URL in output ist temporär; sobald du sie erhältst, lade sie herunter und speichere sie in deinem eigenen Speicher. Verwende temporäre Links nicht als Materialbibliothek.
• Dasselbe Bild kann mehrfach verwendet werden: Ein neuer Prompt ergibt ein neues Video (neue Abrechnung) – ideal, um aus einem Produktfoto schnell ein komplettes Set von Präsentationsmaterial mit mehreren Kameraperspektiven zu erstellen.
• Beim Rechnen die $0.015 nicht vergessen: Stapelbudget nach „Sekundenpreis × Sekunden + $0.015 × Anzahl“ berechnen.
• Ton lässt sich nicht abschalten: Für stummes Material später schneiden; der Preis bleibt gleich.

Häufige Fragen

• Ja, jedes Video hat integrierte Soundeffekte: Im Prompt angegebene Geräusche (Wellen, Schritte im Schnee) werden mitgeneriert, es gibt keinen Ausschalter.
• Ja, das Seitenverhältnis folgt dem Input-Bild: 16:9-Bild ergibt 1264×720, Quadrat ergibt 960×960, Pixel gerundet, Verhältnis unverändert.
• Ja, image_url ist ein String, nur 1 Bild möglich; ein Array oder mehrere Bilder ergeben 400.
• Ja, Dauer 1–15 beliebige ganze Sekunden – eine Aktion 5–6 Sekunden, eine durchgehende Bewegung über 10 Sekunden.
• Ja, die Qualität des Input-Bildes bestimmt die Obergrenze des Ergebnisses: Ein unscharfes kleines Bild wird beim Bewegen nicht klarer; möglichst ein klares Originalbild mit mindestens 720p verwenden.
• Ja, für Stapelrechnungen gibt es eine Formel: Sekundenpreis × Sekunden + $0.015 × Anzahl; 720P 6 Sekunden hundert Videos $27.30, tausend Videos $273.00.

Nächster Schritt: Nimm ein eigenes Foto und erwecke es auf der Modellseite zum Leben; vier Szenarien findest du in der großen Sammlung von Image-to-Video-Prompts.