Veo 3.1 Lite
veo-3.1-lite/image-to-video
Kostengünstige Hochdurchsatz-Videogenerierungsstufe von Google, Geschwindigkeit auf Augenhöhe mit Veo 3.1 Fast, unterstützt Bild-zu-Video, verschiedene Seitenverhältnisse und Dauern
veo-3.1-lite/image-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
veo-3.1-lite/image-to-video per second
Einordnung und Kurzprofil
veo-3.1-lite/image-to-video ist ein Bild-zu-Video-Modell aus der Google-Veo-3.1-Lite-Reihe, das über die einheitliche Schnittstelle von HiAPI.ai aufgerufen wird. Es nimmt ein Eingabebild als Ausgangspunkt und verwandelt das Standbild zusammen mit einem Prompt in einen Videoclip mit nativem Audio. Die Ausgabe unterstützt 720p und 1080p, die Seitenverhältnisse 16:9 und 9:16 sowie wählbare Längen von 4, 6 oder 8 Sekunden. Geeignet ist es für Entwickler, die vorhandenes Bildmaterial in großem Umfang in kurze Videos umwandeln möchten, sowie für Teams, die Videoerzeugung kostensensibel in ihre Produkte integrieren wollen.
Wesentliche Stärken
- Das Bild als Anker, kontrollierbarer Ausgangspunkt – Das Eingabebild dient als Generierungsbedingung, ergänzt durch einen Prompt, der die Bewegungsart beschreibt; so wird das bei reiner Textgenerierung typische Bilddriften reduziert.
- Natives Audio entsteht gemeinsam mit dem Video – Standardmäßig wird natives Audio erzeugt, sodass direkt ein Videoclip mit Ton entsteht und separate Vertonung oder Soundeffekt-Synthese entfallen.
- Seitenverhältnis und Länge nach Bedarf kombinierbar – Unterstützt die Seitenverhältnisse 16:9 und 9:16, die Auflösungen 720p und 1080p sowie Längen von 4, 6 oder 8 Sekunden.
- Steuerbarer und reproduzierbarer Generierungsprozess – Negative Prompts, Zufalls-Seeds und Sicherheitstoleranzparameter ermöglichen die Reproduktion von Ergebnissen und die Eingrenzung der Ausgabeinhalte.
Funktionsbeschreibung
Bildgesteuerte Videoerzeugung: Übergibt man eine Bild-URL und einen Prompt zur Bewegungsbeschreibung, entsteht das entsprechende Video. Für das Eingabebild werden 720p oder höher und ein Seitenverhältnis von 16:9 oder 9:16 empfohlen.
Auswahl von Auflösung und Seitenverhältnis: Die Ausgabe ist wahlweise 720p oder 1080p; das Seitenverhältnis kann 16:9 oder 9:16 sein oder automatisch aus dem Bild abgeleitet werden. Damit lassen sich sowohl Querformat-Inhalte als auch vertikale Kurzvideos abdecken.
Steuerbare Länge: Die Länge einer Generierung lässt sich auf 4, 6 oder 8 Sekunden einstellen, Standard sind 8 Sekunden. Die Abrechnung erfolgt nach Ausgabesekunden, sodass sich die Kosten bequem über die Cliplänge steuern lassen.
Audio-Schalter: Die Erzeugung nativen Audios lässt sich ein- oder ausschalten. Wer stummes Material für eine spätere Vertonung benötigt, kann sie direkt deaktivieren und unnötige Verarbeitung vermeiden.
Ausgabeeinschränkung und Reproduzierbarkeit: Negative Prompts schließen unerwünschte Inhalte aus, die Sicherheitstoleranz regelt die Prüfintensität, und ein fester Seed reproduziert dasselbe Generierungsergebnis.
Einsatzszenarien
- E-Commerce- und Werbeteams: Produktstandbilder zu dynamischen Kurzclips – Produktbilder werden in wenige Sekunden lange dynamische Präsentationsclips verwandelt, etwa für Detailseiten, In-Feed-Werbung und Social-Media-Material.
- Content-Betrieb: vertikale Kurzvideos in großer Stückzahl – Bildmaterial wird im 9:16-Format und mit 4 bis 8 Sekunden Länge zu Kurzvideos verarbeitet, die für die tägliche Content-Aktualisierung auf Kurzvideo-Plattformen genutzt werden.
- Produktteams: Integration der Bild-zu-Video-Funktion – Die Bild-zu-Video-Fähigkeit wird ins Produkt eingebunden, sodass Nutzer durch Hochladen eines Bildes einen kurzen Videoclip mit Audio erhalten.
- Kreativprüfung: schnelle Vorschau von Storyboard-Skizzen – Storyboards oder Concept-Arts werden rasch in dynamische Vorschauen umgewandelt, um Konzepte zu bewerten und die kreative Richtung zu bestätigen, bevor über die weitere Produktion entschieden wird.
Einschränkungen und Auswahlhinweise
Die Auflösung ist auf 1080p begrenzt, die Länge einer einzelnen Generierung auf 8 Sekunden; für Langvideos oder höher aufgelöste Endprodukte ist das Modell daher nicht geeignet. Die Eingabe erfordert ein Bild mit mindestens 720p; für einen rein textbasierten Start sollte auf die Text-zu-Video-Variante derselben Reihe ausgewichen werden. Die Ergebnisse hängen von Prompt und Prüfparametern ab, weshalb Aufwand für Wiederholungen und Auswahl eingeplant werden sollte. Wer längere Längen, höhere Auflösungen oder eine stärkere Kontrolle der Bildkonsistenz benötigt, sollte eine höherwertige Videomodell-Klasse prüfen.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: veo-3.1-lite/image-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für veo-3.1-lite/image-to-video und Route default — siehe Parametertabelle unten.
seedintegerOptionalZufälliger Startwert als Ganzzahl, um das Generierungsergebnis reproduzierbar zu machen; bei gleichem Seed und ansonsten identischen Parametern lässt sich dieselbe Ausgabe erzielen.
promptstringPflichtminLength 1Text-Prompt, der beschreibt, wie das Eingabebild animiert werden soll; Wert ist eine Zeichenkette.
auto_fixbooleanOptionalStandard: falseOb Prompts, die die Validierung nicht bestehen, automatisch umgeschrieben werden; boolescher Wert, Standard false.
durationintegerOptionalStandard: 8min 4max 8Dauer des generierten Videoclips in Sekunden, Ganzzahl, Standard 8.
468image_urlstringPflichtURL des zu animierenden Eingabebilds, Zeichenkette; empfohlen wird ein Bild im Verhältnis 16:9 oder 9:16 mit einer Auflösung von mindestens 720p.
resolutionstringOptionalStandard: "720p"Auflösung des Ausgabevideos, Zeichenkette, Standard 720p.
720p1080paspect_ratiostringOptionalStandard: "auto"Seitenverhältnis des Ausgabevideos, Zeichenkette, Standard auto.
auto16:99:16generate_audiobooleanOptionalStandard: trueOb natives Audio generiert werden soll, boolescher Wert, Standard true.
negative_promptstringOptionalNegativ-Prompt, der beschreibt, welche Inhalte im generierten Video vermieden werden sollen; Wert ist eine Zeichenkette.
safety_tolerancestringOptionalStandard: "4"Toleranzstufe der Inhaltsprüfung, Zeichenkette, Standard 4.
123456callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3.1-lite/image-to-video",
"input": {
"prompt": "…",
"auto_fix": false,
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"safety_tolerance": "4"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "veo-3.1-lite/image-to-video",
input: {
"prompt": "…",
"auto_fix": false,
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"safety_tolerance": "4"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "veo-3.1-lite/image-to-video",
"input": {
"prompt": "…",
"auto_fix": False,
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": True,
"safety_tolerance": "4"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Seedance 2.5 ByteDance $0.121 /Sekunde -
Runway Gen 4.5 Runway $0.172 /Sekunde -
Gemini Omni 1.1 Flash Google $0.450 /Video -
Grok Imagine 1.5 Lite xAI $0.029 /Sekunde -
Vidu Q4 Preview Vidu $0.051 /Sekunde -
Wan 3.0 Video Alibaba $0.040 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
Kling 2.5 Kuaishou $0.060 /Sekunde -
Kling 4.0 Kuaishou $0.330 /Sekunde -
Kling 3.0 Turbo Kuaishou $0.130 /Sekunde -
HeyGen Avatar V HeyGen $0.150 /Sekunde -
Wan 2.7 Video Alibaba $0.100 /Sekunde
Gleicher Anbieter
-
Veo 3.1 Google $0.290 /Sekunde -
Nano Banana 2 Google $0.036 /Bild -
Gemini 3.1 Flash TTS Google -- -
Lyria 3 Pro Google $0.140 /Song -
Gemini Omni Google -- -
Imagen 4 Google $0.030 /Bild -
Nano Banana Google $0.021 /Bild -
Nano Banana 2 Lite Google $0.033 /Bild -
Google Virtual Try-On Google $0.107 /Bild -
Nano Banana Pro Google $0.057 /Bild -
Lyria 3.5 Google $0.090 /Song -
Gemini Omni 1.1 Flash Google $0.450 /Video


