Google: Veo 3.1
Veo 3.1 ist Googles Videomodell für text- und bildgestützte Szenen mit generiertem Ton, vorgegebenen Begrenzungsbildern und Referenzmaterial. Sein Produktionsprofil bietet Clips mit vier, sechs oder acht Sekunden bei 24 fps und Ausgabeoptionen von 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 gesteuerte Erstellung mit erstem/letztem Einzelbild, mit generiertem Ton, Asset-Referenzen und separatem Fortsetzungsablauf. Nutzen Sie es zur Entwicklung eines filmischen Konzepts, einer kurzen Produktgeschichte oder eines visuellen Abschnitts mit definierter Szene, Handlung und Hörerfahrung.
Beschreiben Sie zuerst Motiv und sichtbares Ereignis. Legen Sie Umgebung, Tageszeit und Licht fest und bestimmen Sie danach Kamerablickwinkel oder -bewegung und gewünschten Bildstil. Ein eigenes Szenenbriefing könnte ein Glasgefäss auf einer dunklen Studiofläche zeigen, mit einer langsamen seitlichen Fahrt, die eine Reflexion enthüllt, begleitet von einem sanften Umgebungsgeräusch. Jede Anweisung liefert ein sichtbares oder hörbares Merkmal, das im fertigen Ergebnis beurteilt werden kann.
Googles Prompt-Rahmen behandelt Motiv, Handlung, Szene, Kamera und Ästhetik als separate Briefingteile. Nutzen Sie die für die Einstellung hilfreichen Teile, statt jeden möglichen Deskriptor hinzuzufügen. Schreiben Sie Anweisungen für das dokumentierte Prompt-Profil auf Englisch. Hat die Szene mehrere Handlungen, benennen Sie deren Beziehung und passen Sie sie an einen kurzen Clip an, damit Enthüllung oder Reaktion verständlich bleiben.
Ein Startbild legt Anfangserscheinung und -komposition fest. Nutzen Sie es, wenn Figur, Produkt oder Umgebung bereits als visuelles Material vorliegen, und beschreiben Sie die daraus entstehende Bewegung. Ein letztes Einzelbild ergänzt die Zielkomposition für den Schluss. Bereiten Sie Begrenzungsbilder mit plausiblem Übergang und erhaltenen Identifikationsdetails des Hauptmotivs vor und prüfen Sie nach der Generierung die Bewegung dazwischen.
Asset-Referenzen haben einen anderen Zweck: Sie führen die Erscheinung einer Figur oder eines Objekts in einer neu generierten Szene, während Begrenzungsbilder konkrete Momente darin definieren. Wählen Sie Referenzen mit den wichtigen Bildmerkmalen und machen Sie die Rolle jedes Materials im Prompt deutlich. Die Reference-Image-to-Video-Spezifikation des Produktionsmodells verwendet achtsekündige Ausgabe für diesen Referenzablauf, getrennt von der gewöhnlichen textgestützten Dauerwahl.
Das gewöhnliche Produktionsprofil des Herstellers generiert Clips mit vier, sechs oder acht Sekunden und 24 Bildern pro Sekunde. Es nennt Querformat 16:9 und Hochformat 9:16, bis zu vier Videoausgaben pro Prompt und Auflösungen von 720p, 1080p und 4K. Das Ausgabevideoformat ist MP4. Seine bildgestützte Spezifikation akzeptiert JPEG oder PNG, nennt maximal 20 MB pro Eingabebild und unterstützt 720p-/1080p-Eingabekonfigurationen. Wählen Sie das Ausgabeprofil passend zur vorgesehenen Platzierung und halten Sie die Bildkomposition in dieser Grösse lesbar.
Nativer Ton kann die sichtbare Szene begleiten. Geben Sie gesprochene Sätze, Atmosphäre und Geräuscheffekte als Teile desselben Briefings an und benennen Sie das jeweils erzeugende Motiv oder Ereignis. Eine Dialoganweisung und eine Kameraanweisung beantworten verschiedene Fragen: Die eine bestimmt die Darbietung, die andere, wie das Publikum sie sieht. Halten Sie den Text innerhalb der nutzbaren Sprechzeit des Clips und prüfen Sie Verständlichkeit sowie Bezug des Tons 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 Szenenänderung. Bewahren Sie Original und Fortsetzungsabschnitt auf, damit sich ihr Übergang hinsichtlich Erscheinung, Bewegung und Ton prüfen lässt. Gewöhnliche Dauer- und Auflösungsoptionen für neue Generierung dürfen nicht als universeller Vertrag für jede Verlängerungsoperation behandelt werden.
Eine negative Beschreibung kann Ausschlüsse auf die visuellen Aufgabenanforderungen konzentrieren. Halten Sie bei einer 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 zusammen mit dem Ergebnis fest. So lässt sich ein brauchbarer kreativer Unterschied statt einer Sammlung unzusammenhängender Generierungen vergleichen.
Das reguläre Veo-3.1-Produktionsprofil und Veo 3.1 Fast haben unterschiedliche Auflösungsprofile. Fast nennt 720p und 1080p, reguläres 3.1 zusätzlich 4K. Ordnen Sie die gewählte Edition dem Ergebnis zu, ohne eine Produktionsmodellkennung stillschweigend durch ein älteres Preview-Profil oder eine andere Veo-Generation zu ersetzen. Motiverscheinung und unterstützte Operation hängen beide vom gewählten Ablauf ab.
Die Generierung ist eine Operation, deren abgeschlossenes Ergebnis Videodateien zur Wiedergabe und späteren Bearbeitung bereitstellt. Bewahren Sie zurückgegebene Dateien mit Quellbildern, Referenzmaterial und Briefing auf und erhalten Sie mitgelieferte Herkunftsinformationen. Prüfen Sie jede tatsächliche Ausgabe auf Motiverscheinung, Handlung, Bildausschnitt, Ton und Schlusskomposition. Nutzen Sie den gewählten Clip als Produktionsbaustein und ergänzen Sie Titel, Übergänge oder weitere Abschlussarbeiten im umgebenden Schnitt.
Ailoot Ultra · Video POST /v1/videos google/veo-3.1
google/veo-3.1Einstieg
Veo 3.1 ist Googles Videomodell für text- und bildgestützte Szenen mit generiertem Ton, vorgegebenen Begrenzungsbildern und Referenzmaterial. Sein Produktionsprofil bietet Clips mit vier, sechs oder acht Sekunden bei 24 fps und Ausgabeoptionen von 720p, 1080p und 4K.
- Zulässige Eingaben
- Text
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabe
text- Ausgabe
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 ausser 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.
Reichen Sie eine Erstellung mit unbekanntem Ausgang niemals erneut ein.
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 |
|---|---|---|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Audio generieren— | Auflösung— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationUltra | Tarifstaffel— | Prognostizierte MengeAngeforderte Konfiguration; nur eine Schätzung. | Audio generierenMit Audio | Auflösung720p | Abrechnungseinheitpro Sekunde Ausgabevideo | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Ausgabevideo-Sekunde · Schätzung nur zum Vergleich $0.8 pro Sekunde Ausgabevideo Der angezeigte Preis dient zur Kostenschätzung vor der Erzeugung. Die endgültige Abbuchung wird anhand der für die ursprüngliche Erzeugung 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 Ausgabevideo-Sekunde · Schätzung nur zum Vergleich $0.4 pro Sekunde Ausgabevideo Der angezeigte Preis dient zur Kostenschätzung vor der Erzeugung. Die endgültige Abbuchung wird anhand der für die ursprüngliche Erzeugung 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 Erzeugungskosten | 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 abschliessenden 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 dem abgeschlossenen data[] für die Ihnen zugeordneten Ausgaben sowie die vollständigen Statusmetadaten auf. Speichern Sie jede Ausgabe einschliesslich ihres erzeugten Audios. Eine gültige AAC-Audiospur kann auch bei generate_audio=false enthalten sein; bewahren Sie die vollständige ursprüngliche MP4-Datei einschliesslich dieser Audiospur auf.
Wenn die ursprüngliche Antwort geprüft werden muss
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
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 | BedeutungAntwort des ursprünglichen Status-/Inhaltsabrufs mit HTTP503 result_pending_check: 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 Anfragetexts scheitert vor dem Parsen des Videoprofils | Nächster SchrittBewahren Sie die zurückgegebene Antwort auf und korrigieren Sie den nicht lesbaren Anfragetext. |
Antwort422 · price_unavailable | BedingungDas exakte Videoprofil lässt sich nicht parsen oder für das vollständig geparste Profil liegt keine einsatzbereite exakte Preiskarte vor | Nächster SchrittBewahren Sie die Antwort auf; verwenden Sie das vollständige, exakt zugelassene Profil und dessen veröffentlichte Preiskarte. Dieser Zweig wird vor dem Senden an einen Anbieter ausgeführt. |
Antwort409 · video_not_ready | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID 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 hat keinen der Zustände failed/cancelled/expired, und der lokale Zustand ist unknown oder der ursprüngliche Auftragsstatus ist completed. | Nächster SchrittBewahren Sie die ursprüngliche id und operation_id (dieselbe öffentliche Video-ID), Antwort und Header auf; lesen Sie ausschliesslich den ursprünglichen Status/Inhalt. Senden Sie niemals eine neue Erzeugungsanfrage. |
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