Google: Veo 3.1
Veo 3.1 ist Googles Videomodell für text- und bildgestützte Szenen mit generiertem Ton, vorgegebenen Grenzbildern und Referenz-Assets. Sein Produktionsprofil liefert vier-, sechs- oder achtsekündige Clips mit 24 fps und Ausgabeoptionen einschließlich 720p, 1080p und 4K.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Veo 3.1 ist Googles Videogenerierungsmodell zur Erstellung einer kurzen audiovisuellen Szene aus Text oder einem bildgestützten Briefing. Sein Produktionsprofil unterstützt Text-to-Video, Image-to-Video und die Erstellung mit vorgegebenem Anfangs-/Endbild, mit generiertem Ton, Asset-Referenzen und einem separaten Fortsetzungsablauf. Verwenden Sie es zur Entwicklung eines filmischen Konzepts, einer kurzen Produktgeschichte oder eines visuellen Abschnitts mit definierter Szene, Handlung und Hörerlebnis.
Beschreiben Sie zuerst Motiv und sichtbares Ereignis. Legen Sie Umgebung, Tageszeit und Licht fest und definieren Sie anschließend Blickwinkel oder Bewegung der Kamera und den gewünschten Bildstil. Ein eigenständiges Szenenbriefing könnte ein Glasgefäß auf einer dunklen Studiofläche zeigen, während eine langsame seitliche Fahrt eine Reflexion sichtbar macht und ein sanftes Umgebungsgeräusch die Enthüllung begleitet. Jede Anweisung benennt ein sichtbares oder hörbares Merkmal, das sich im fertigen Ergebnis beurteilen lässt.
Googles Prompt-Rahmen behandelt Motiv, Handlung, Szene, Kamera und Ästhetik als separate Teile des Briefings. Verwenden Sie die Teile, die der Einstellung dienen, statt jede denkbare Beschreibung hinzuzufügen. Schreiben Sie Anweisungen für das dokumentierte Prompt-Profil auf Englisch. Hat die Szene mehrere Handlungen, benennen Sie ihre Beziehung und halten Sie sie dem kurzen Clip angemessen, damit eine Enthüllung oder Reaktion klar erkennbar bleibt.
Ein Startbild legt anfängliches Erscheinungsbild und Komposition fest. Verwenden Sie es, wenn Figur, Produkt oder Umgebung bereits als visuelles Asset vorliegt, und beschreiben Sie die daraus entstehende Bewegung. Ein letztes Bild ergänzt eine Zielkomposition für den Schluss. Bereiten Sie Grenzbilder vor, die einen plausiblen Übergang vermitteln und die identifizierenden Details des Hauptmotivs bewahren, und prüfen Sie nach der Generierung die Bewegung zwischen diesen Bildern.
Asset-Referenzen erfüllen einen anderen Zweck: Sie steuern das Erscheinungsbild einer Figur oder eines Objekts in einer neu generierten Szene, während Grenzbilder konkrete Momente dieser Szene definieren. Wählen Sie Referenzen, die wichtige visuelle Merkmale zeigen, und machen Sie die Rolle jedes Assets im Prompt klar. Die Reference-Image-to-Video-Spezifikation des Produktionsmodells nutzt für diesen Referenzablauf eine achtsekündige Ausgabe, getrennt von der üblichen Dauerauswahl bei textgestützter Erstellung.
Das normale Produktionsprofil des Herstellers erzeugt vier-, sechs- oder achtsekündige Clips mit 24 Bildern pro Sekunde. Es nennt Querformat 16:9 und Hochformat 9:16, bis zu vier Videoausgaben pro Prompt sowie Ausgabeauflösungen von 720p, 1080p und 4K. Das Ausgabevideoformat ist MP4. Die bildgestützte Spezifikation akzeptiert JPEG oder PNG, nennt maximal 20 MB für Eingabebilder und unterstützt Eingabekonfigurationen in 720p/1080p. Wählen Sie das Ausgabeprofil für die beabsichtigte Platzierung und halten Sie die Bildkomposition in dieser Größe klar erkennbar.
Nativer Ton kann die sichtbare Szene begleiten. Geben Sie gesprochene Sätze, Atmosphäre und Klangeffekte als Teile desselben Briefings an und benennen Sie Motiv oder Ereignis, das jeweils den Ton erzeugt. Eine Dialog- und eine Kameraanweisung beantworten unterschiedliche Fragen: Die eine legt die Darbietung fest, die andere, wie das Publikum sie sieht. Begrenzen Sie den Wortumfang auf die nutzbare Sprechzeit des Clips und prüfen Sie den Ton auf Verständlichkeit und Bezug zur Handlung.
Für eine Fortsetzung bietet der Hersteller einen separaten Videoverlängerungsablauf. Beginnen Sie mit einem geeigneten generierten Quellclip und beschreiben Sie das nächste sichtbare Ereignis oder die nächste Szenenänderung. Bewahren Sie Original und fortgesetztes Segment auf, damit sich ihre Verbindungsstelle auf Erscheinungsbild, Bewegung und Ton prüfen lässt. Die normalen Dauer- und Auflösungsoptionen neuer Generierungen dürfen nicht als universeller Vertrag für jede Verlängerungsoperation behandelt werden.
Eine negative Beschreibung kann Ausschlüsse auf die visuellen Anforderungen der Aufgabe konzentrieren. Halten Sie für eine Reihe von Produktvarianten Motiv und Komposition stabil und ändern Sie eine kreative Vorgabe, etwa Beleuchtung oder Kameraabstand. Halten Sie Prompt, Referenzen und gewählte Einstellungen mit dem Ergebnis fest. So lässt sich ein nützlicher kreativer Unterschied vergleichen statt einer Sammlung unverbundener Generierungen.
Das reguläre Produktionsprofil von Veo 3.1 und Veo 3.1 Fast haben unterschiedliche Ausgabeauflösungsprofile. Fast nennt 720p und 1080p; das reguläre 3.1 nennt zusätzlich 4K. Bewahren Sie die gewählte Ausgabe mit dem Ergebnis auf, ohne eine Produktionsmodellkennung stillschweigend durch ein älteres Preview-Profil oder eine andere Veo-Generation zu ersetzen. Sowohl Motiverscheinung als auch unterstützte Operation hängen vom gewählten Ablauf ab.
Die Generierung ist eine Operation, deren abgeschlossenes Ergebnis Videoartefakte zur Wiedergabe und späteren Bearbeitung bereitstellt. Bewahren Sie zurückgegebene Dateien mit ihren Quellbildern, Referenz-Assets und dem Briefing sowie bereitgestellte Informationen zur Inhaltsherkunft auf. Prüfen Sie jede tatsächliche Ausgabe auf Motiverscheinung, Handlung, Bildausschnitt, Ton und Schlusskomposition. Verwenden Sie den ausgewählten Clip als Produktionsbaustein und ergänzen Sie Titel, Übergänge oder weitere Fertigstellung im umgebenden Schnitt.
Ailoot Ultra · Video POST /v1/videos google/veo-3.1
google/veo-3.1Start
Veo 3.1 ist Googles Videomodell für text- und bildgestützte Szenen mit generiertem Ton, vorgegebenen Grenzbildern und Referenz-Assets. Sein Produktionsprofil liefert vier-, sechs- oder achtsekündige Clips mit 24 fps und Ausgabeoptionen einschließlich 720p, 1080p und 4K.
- Zulässige Eingaben
- Text
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabetypen
text- Ausgabetypen
video- Ausgabeformat
- mp4
- Ausgabeanzahl
- Bis zu 4 Ausgabes
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits google/veo-3.1 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Maximale Anzahl UTF-8-Bytes: 10.000 Mindestens ein Zeichen außer Leerraum erforderlich: Ja | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 4, 6, 8 | Standard— |
Feldresolution | Typstring | AnforderungErforderlich | Werte und Limits 720p | Standard— |
Feldaspect_ratio | Typstring | AnforderungErforderlich | Werte und Limits 16:9, 9:16 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungErforderlich | Werte und Limits false, true | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Erforderlich: prompt
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parameteradditional_properties | Vertragfalse |
Parameterparameters | Vertrag{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
Parametermaterial_types | Vertragtext |
Methodenaliasnamen: /v1/videos/generations, /videos, /videos/generations
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Bewahren Sie die vollständige Antwort und die ursprünglich zurückgegebenen IDs auf.
Übermitteln Sie eine Erstellung mit unklarem Ausgang niemals erneut.
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Audio generieren | Auflösung | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Audio generieren— | Auflösung— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationUltra | Tarifstaffel— | Prognostizierte MengeAngeforderte Konfiguration; nur eine Schätzung. | Audio generierenMit Audio | Auflösung720p | Abrechnungseinheitpro Sekunde Ausgabevideo | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.8 pro Sekunde Ausgabevideo Der angezeigte Preis dient zur Kostenschätzung vor der Generierung. Die endgültige Abrechnung wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die physische Videodauer ist nicht die abrechenbare Menge. |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Audio generieren— | Auflösung— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenAudio: with_audio; Auflösung: 4k | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $1.2 pro Videosekunde |
| KonfigurationUltra | Tarifstaffel— | Prognostizierte MengeAngeforderte Konfiguration; nur eine Schätzung. | Audio generierenOhne Audio | Auflösung720p | Abrechnungseinheitpro Sekunde Ausgabevideo | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.4 pro Sekunde Ausgabevideo Der angezeigte Preis dient zur Kostenschätzung vor der Generierung. Die endgültige Abrechnung wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die physische Videodauer ist nicht die abrechenbare Menge. |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Audio generieren— | Auflösung— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenAudio: without_audio; Auflösung: 4k | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.8 pro Videosekunde |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Audio generieren— | Auflösung— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $1.6 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
Preisreferenzen für Videokonfigurationen
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationVideopreis | AbrechnungsbedingungenAudio: with_audio | Gebühr Ausgabe · Videopreis $0.8 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenAudio: with_audio; Auflösung: 4k | Gebühr Ausgabe · Videopreis $1.2 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenAudio: without_audio | Gebühr Ausgabe · Videopreis $0.4 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenAudio: without_audio; Auflösung: 4k | Gebühr Ausgabe · Videopreis $0.8 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jede signierte URL aus abgeschlossenen data[]-Einträgen der Ihnen zugeordneten Assets sowie die vollständigen Statusmetadaten auf. Speichern Sie jede Ausgabe einschließlich des generierten Tons. Auch bei generate_audio=false kann eine gültige AAC-Audiospur vorhanden sein; bewahren Sie die vollständige ursprüngliche MP4-Datei einschließlich dieser Audiospur auf.
Wenn die ursprüngliche Antwort geprüft werden muss
Lesen Sie den vorhandenen ursprünglichen Auftrag aus; wiederholen Sie eine Übermittlung mit unklarem Ausgang niemals.
Maximale Anzahl der Ausgaben: 4.
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldid | Typstring | Bedeutung— |
Feldobject | Typstring | Bedeutung— |
Feldmodel | Typstring | Bedeutung— |
Feldstatus | Typstring | Bedeutung— |
Felddata[] | Typsigned content URL | Bedeutung— |
Feldcharge_pending_check | Typboolean | Bedeutung— |
Felderror.code | Typstring | Bedeutung— |
Felderror.message | Typstring | Bedeutung— |
Feldoperation_id | Typstring | BedeutungHTTP503 result_pending_check in der ursprünglichen Status-/Inhaltsantwort: dieselbe ursprüngliche öffentliche Video-ID als id. |
Felderror.type | Typstring | Bedeutungserver_error bei HTTP503 result_pending_check. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungDas Lesen des rohen Anfrageinhalts schlägt vor dem Parsen des Videoprofils fehl | Nächster SchrittBewahren Sie die zurückgegebene Antwort auf und korrigieren Sie den nicht lesbaren Anfrageinhalt. |
Antwort422 · price_unavailable | BedingungDas exakte Videoprofil lässt sich nicht parsen, oder für das vollständig geparste Profil steht keine exakt passende Preiskarte bereit | Nächster SchrittBewahren Sie die Antwort auf; verwenden Sie das vollständige, exakt zugelassene Profil und seine veröffentlichte Preiskarte. Dieser Zweig wird vor der Übermittlung an den Anbieter ausgeführt. |
Antwort409 · video_not_ready | BedingungUrsprünglicher Ergebnisinhalt noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID regelmäßig ab und beachten Sie Retry-After. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Antwort503 · result_pending_check | BedingungGET des ursprünglichen Status/Inhalts: Die Aufgabe ist nicht veröffentlicht, der ursprüngliche Auftrag ist weder failed noch cancelled noch expired, und der lokale Zustand ist unknown oder der Status des ursprünglichen Auftrags ist completed. | Nächster SchrittBewahren Sie die ursprünglichen Werte id und operation_id (dieselbe öffentliche Video-ID), Antwort und Header auf; lesen Sie ausschließlich den ursprünglichen Status/Inhalt aus. Senden Sie niemals eine neue Generierungsanfrage. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra google/veo-3.1
Aliasnamen für Methodenpfade
/v1/videos/generations, /videos, /videos/generations
Zugehörige Aufrufer-IDs
FAQ · Google: Veo 3.1
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·google/veo-3.1:text→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·google/veo-3.1:model,prompt,duration,resolution,aspect_ratio,generate_audio