Veo 3.1
veo-3.1/image-to-video
Googles Videogenerierungsmodell: Bildeingaben erzeugen nativ 8-Sekunden-Videos mit Umgebungsgeräuschen und Dialogen, unterstützen bis zu 4K und bewahren das einheitliche Erscheinungsbild des Motivs
veo-3.1/image-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
veo-3.1/image-to-video per second
Positionsübersicht
Die Veo 3.1 Bild-zu-Video-Pipeline ist die bildgesteuerte Version des Google-Videogenerierungsmodells auf HiAPI.ai. Sie nimmt ein Bild und einen Text-Prompt entgegen und erzeugt ein dynamisches Video mit nativem Audiospur. Sie eignet sich besonders dafür, das Erscheinungsbild des Motivs im Eingabebild zu bewahren und gleichzeitig Kamerabewegung und Szenenentwicklung zu steuern. Damit ist sie ideal für Entwickler, die statisches Bildmaterial schnell in abspielbare Clips verwandeln möchten, etwa für Werbung, soziale Medien und Konzept-Previews.
Kernhighlights
- Native synchrone Bild-Ton-Generierung – Beim Erzeugen des Videos werden gleichzeitig Umgebungsgeräusche, Dialoge und Soundeffekte produziert, wodurch separate Nachvertonungs- und Soundeffekt-Syntheseschritte entfallen.
- Bis zu 4K Auflösung wählbar – Die Ausgabe unterstützt die drei Stufen 720p, 1080p und 4k und kann das Seitenverhältnis automatisch an das Eingabebild anpassen oder explizit 16:9 bzw. 9:16 verwenden.
- Ausgabedauer und Audio steuerbar – Die Dauer ist mit 4, 6 oder 8 Sekunden wählbar, die Audiospur lässt sich ein- und ausschalten, sodass sich die Generierungsspezifikationen an Vertriebskanäle und Kostenbudgets anpassen lassen.
- Unterstützung von Negativ-Prompts und festem Seed – Mit negative_prompt lassen sich unerwünschte Elemente ausschließen, und über seed lassen sich ähnliche Generierungsergebnisse reproduzieren.
Funktionsbeschreibung
Bildgesteuerte Animationsgenerierung: Ausgehend von einem Bild und einem Prompt von bis zu 20000 Zeichen, der die Bewegungsart beschreibt, wird ein Videoclip von 4 bis 8 Sekunden ausgegeben. Damit lässt sich vorhandenes Bildmaterial direkt in dynamische Inhalte umwandeln.
Native Audiospur-Generierung: Standardmäßig wird natives Audio erzeugt; durch Deaktivieren von generate_audio erhält man ein stummes Video, das sich in der Postproduktion individuell vertonen oder unterlegen lässt.
Auflösungs- und Seitenverhältnissteuerung: Die Ausgabe lässt sich auf 720p, 1080p oder 4k festlegen; das Seitenverhältnis kann automatisch dem Eingabebild folgen oder auf 16:9 bzw. 9:16 gezwungen werden, passend für Quer- und Hochformat-Ausspielung.
Kontrollierbarkeit der Ergebnisse: Über negative_prompt werden zu vermeidende Inhalte beschrieben, über seed wird der Zufallsseed fixiert, um bei der Batch-Generierung den Stil stabil zu halten oder A/B-Vergleiche durchzuführen.
Anwendungsfälle
- Marketingteams verwandeln Produktbilder in Werbespots – Statisches Produktbild und Bewegungsbeschreibung eingeben, einen Querformat-Videoclip in 4K oder 1080p erzeugen und direkt für Online-Werbeausspielung und Website-Präsentation nutzen.
- Social-Media-Teams erstellen dynamische Hochformat-Inhalte – Mit Hochformat-Bild und Prompt ein 9:16-Video mit nativem Soundeffekt generieren und als Material für Kurzvideo-Plattformen veröffentlichen.
- Filmvorproduktion wandelt Konzeptbilder in dynamische Previews um – Storyboards oder Konzeptdesigns in dynamische Clips umwandeln, damit das Team vor der eigentlichen Produktion Kamerabewegung und Atmosphäre bestätigen kann.
- Entwickler erzeugen dynamisches Material im Batch – In programmatischen Abläufen Bilder und Prompts übergeben und mit seed einheitlich gestaltete Videoclips in Serie erzeugen, für Tests oder zur Inhaltsbefüllung.
Einschränkungen und Auswahlhinweise
Die maximale Dauer einer einzelnen Generierung beträgt 8 Sekunden; längere Erzählungen müssen in Segmenten erzeugt und anschließend zusammengefügt werden, wobei die Kontinuität über mehrere Einstellungen hinweg weiterhin manueller Planung bedarf. Das Eingabebild sollte mindestens 720p und im Format 16:9 oder 9:16 sein; andere Seitenverhältnisse werden beschnitten. Auflösung und Audio-Schalter beeinflussen die Abrechnung, daher sollte vor der Batch-Generierung zunächst ein Testlauf mit niedriger Spezifikation erfolgen. Wenn das Bild nicht aus vorhandenem Material gesteuert, sondern von Grund auf neu aufgebaut werden soll, ist die Text-zu-Video-Pipeline derselben Familie zu wählen.
Häufige Fragen
Alle Fragen ansehen →-
Was für ein Videomodell ist Veo 3.1 Text to Video?
Es ist eine reine Text-zu-Video-Variante, die nur einen Text-Prompt benötigt und kein Hochladen eines Startbilds verlangt.
-
Welche Ausgabeformate unterstützt Veo 3.1 Text to Video?
Unterstützt werden 4-8 Sekunden, Auflösungen einschließlich 720p, 1080p, 4k und Bildformate einschließlich 16:9, 9:16.
-
Kann Ton generiert oder eine Audioreferenz verwendet werden?
Die Audiogenerierung ist standardmäßig aktiviert
-
Wie wird Veo 3.1 Text to Video abgerechnet?
Die Abrechnung erfolgt nach Ausgabedauer und Echtzeit-Stufe; Abweichungen durch Auflösung, Modus oder Audiooptionen richten sich nach dem Seitenpreis und dem Aufgabenprotokoll.
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/image-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für veo-3.1/image-to-video und Route default — siehe Parametertabelle unten.
seedintegerOptionalZufälliger Seed, mit dem sich das Generierungsergebnis reproduzieren lässt; bei gleichem Seed erhält man konsistente Ergebnisse.
promptstringPflichtminLength 1maxLength 20000Text-Prompt, der beschreibt, auf welche Weise sich das eingegebene Bild bewegen soll.
durationintegerPflichtStandard: 8min 4max 8Dauer des generierten Videos (in Sekunden); die Kosten steigen mit der Dauer; Standard 8 Sekunden.
468image_urlstringPflichtURL des Eingabebilds, das animiert werden soll; empfohlen wird eine Auflösung von 720p oder höher im Format 16:9 oder 9:16, andere Seitenverhältnisse werden zugeschnitten.
resolutionstringPflichtStandard: "720p"Auflösung des Ausgabevideos; je höher die Auflösung, desto höher die Kosten; Standard 720p.
720p1080p4kaspect_ratiostringOptionalStandard: "auto"Seitenverhältnis des Ausgabevideos; Standard auto, d. h., das Seitenverhältnis des Eingabebilds wird übernommen.
auto16:99:16generate_audiobooleanOptionalStandard: trueOb eine native Tonspur generiert wird; ist dies aktiviert, fällt die Abrechnung höher aus; standardmäßig aktiviert.
negative_promptstringOptionalNegativ-Prompt, der beschreibt, welche Inhalte im generierten Video vermieden werden sollen.
callbackobjectOptional
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/image-to-video",
"input": {
"prompt": "…",
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}' 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/image-to-video",
input: {
"prompt": "…",
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}),
});
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/image-to-video",
"input": {
"prompt": "…",
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": True
}
},
)
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
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
-
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
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Wan 3.0 Video Alibaba $0.040 /Sekunde -
Creatify Boreal Creatify $0.015 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
Ray 3.2 Luma $0.214 /Video -
Vidu Q4 Preview Vidu $0.051 /Sekunde -
Veo 3.1 Fast Google $0.170 /Sekunde -
Hailuo 2.3 MiniMax $0.270 /Video -
Wan 2.6 Flash Alibaba $0.043 /Sekunde -
Kling 3.0 Kuaishou $0.100 /Sekunde -
Runway Gen 4.5 Runway $0.172 /Sekunde -
Veo 3.1 Lite Google $0.060 /Sekunde -
HappyHorse 1.1 Alibaba $0.160 /Sekunde
Gleicher Anbieter
-
Lyria 3 Pro Google $0.140 /Song -
Nano Banana 2 Google $0.036 /Bild -
Gemini Omni Google -- -
Gemini Omni 1.1 Flash Google $0.450 /Video -
Veo 3.1 Lite Google $0.060 /Sekunde -
Nano Banana 2 Lite Google $0.033 /Bild -
Lyria 3.5 Google $0.090 /Song -
Gemini 3.1 Flash TTS Google -- -
Nano Banana Pro Google $0.057 /Bild -
Imagen 4 Google $0.030 /Bild -
Google Virtual Try-On Google $0.107 /Bild -
Veo 3.1 Fast Google $0.170 /Sekunde



