Google: Veo 3.1
Veo 3.1 ist Googles Videomodell für text- und bildgestützte Szenen mit generiertem Ton, geführten Begrenzungsbildern und Referenzdateien. Sein Produktionsprofil bietet Clips von vier, sechs oder acht Sekunden 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 zum Erstellen einer kurzen audiovisuellen Szene aus Text oder einem bildgestützten Briefing. Sein Produktionsprofil unterstützt Text-zu-Video, Bild-zu-Video und geführte Erstellung mit Anfangs- und Endbild, generiertem Ton, Motivdateireferenzen und einem separaten Fortsetzungsablauf. Nutzen Sie es für ein filmisches Konzept, eine kurze Produktgeschichte oder einen Bildabschnitt mit festgelegter Szene, Handlung und Hörerlebnis.
Beschreiben Sie zuerst Motiv und sichtbares Ereignis. Legen Sie Umgebung, Tageszeit und Licht fest und bestimmen Sie danach Kamerablick oder -bewegung und gewünschten Bildstil. Ein eigenes Szenenbriefing könnte ein Glasgefäß auf einer dunklen Studiofläche zeigen, während eine langsame seitliche Kamerafahrt eine Reflexion enthüllt und ein sanftes Umgebungsgeräusch die Enthüllung begleitet. Jede Anweisung nennt ein sichtbares oder hörbares Merkmal, das am fertigen Ergebnis geprüft werden kann.
Googles Prompt-Rahmen behandelt Motiv, Handlung, Szene, Kamera und Ästhetik als separate Briefingteile. Nutzen Sie die Teile, die der Einstellung dienen, statt jede mögliche Beschreibung hinzuzufügen. Schreiben Sie Anweisungen für das dokumentierte Prompt-Profil auf Englisch. Hat die Szene mehrere Handlungen, beschreiben Sie ihre Beziehung und passen Sie sie an den kurzen Clip an, damit Enthüllung oder Reaktion verständlich bleiben.
Ein Ausgangsbild bestimmt Aussehen und Komposition der Eröffnung. Verwenden Sie es, wenn Figur, Produkt oder Umgebung bereits als Bilddatei vorliegen, und beschreiben Sie die daraus entstehende Bewegung. Ein Endbild ergänzt die Zielkomposition für den Schluss. Bereiten Sie Begrenzungsbilder vor, die einen plausiblen Übergang vermitteln und identifizierende Hauptmotivdetails bewahren, und prüfen Sie nach der Generierung die Bewegung dazwischen.
Motivdateireferenzen erfüllen einen anderen Zweck: Sie steuern das Aussehen einer Figur oder eines Gegenstands in einer neuen Szene, während Begrenzungsbilder bestimmte Momente dieser Szene festlegen. Wählen Sie Referenzen mit wichtigen visuellen Merkmalen und machen Sie jede Rolle im Prompt klar. Die Referenzbild-zu-Video-Spezifikation des Produktionsmodells verwendet achtsekündige Ausgabe für diesen Referenzablauf, getrennt von der normalen textgestützten Dauerwahl.
Das normale Produktionsprofil des Herstellers generiert Clips von vier, sechs oder acht Sekunden mit 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 für den Einsatzort und halten Sie die Bildkomposition in dieser Größe lesbar.
Nativer Ton kann die sichtbare Szene begleiten. Beschreiben Sie gesprochene Sätze, Atmosphäre und Geräusche als Teile desselben Briefings und benennen Sie jeweils das erzeugende Motiv oder Ereignis. Dialog- und Kameraanweisungen beantworten verschiedene Fragen: Die eine legt die Darbietung fest, die andere, wie das Publikum sie sieht. Passen Sie die Wortmenge an die nutzbare Sprechzeit an und prüfen Sie Tonverständlichkeit und Bezug zur Handlung.
Für eine Fortsetzung bietet der Hersteller einen eigenen 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 fortgesetzten Abschnitt auf, damit der Übergang auf Aussehen, Bewegung und Ton geprüft werden kann. Die normalen Dauer- und Auflösungsoptionen neuer Generierungen gelten nicht als universeller Vertrag für jede Verlängerungsoperation.
Eine negative Beschreibung kann Ausschlüsse auf die visuellen Aufgabenanforderungen konzentrieren. Halten Sie für eine Reihe von Produktvarianten Motiv und Komposition stabil und ändern Sie eine kreative Richtung, etwa Licht oder Kameraabstand. Halten Sie Prompt, Referenzen und Einstellungen mit dem Ergebnis fest. So lässt sich ein brauchbarer kreativer Unterschied statt einer Sammlung unabhängiger Generierungen vergleichen.
Das reguläre Produktionsprofil Veo 3.1 und Veo 3.1 Fast haben unterschiedliche Ausgabeauflösungen. Fast führt 720p und 1080p auf; reguläres 3.1 zusätzlich 4K. Bewahren Sie die gewählte Ausgabe mit dem Ergebnis auf, ohne eine Produktionsmodellkennung unbemerkt durch ein älteres Preview-Profil oder eine andere Veo-Generation zu ersetzen. Sowohl Motivaussehen als auch unterstützte Operation hängen vom gewählten Ablauf ab.
Die Generierung ist eine Operation, deren fertiges Ergebnis Videodateien für Wiedergabe und späteren Schnitt bereitstellt. Bewahren Sie zurückgegebene Dateien mit Ausgangsbildern, Referenzen und Briefing auf und erhalten Sie mitgelieferte Herkunftsinformationen. Prüfen Sie jede tatsächliche Ausgabe auf Motivaussehen, Handlung, Ausschnitt, Ton und Schlusskomposition. Verwenden Sie den gewä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.1Einstieg
Veo 3.1 ist Googles Videomodell für text- und bildgestützte Szenen mit generiertem Ton, geführten Begrenzungsbildern und Referenzdateien. Sein Produktionsprofil bietet Clips von vier, sechs oder acht Sekunden 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
- 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 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 unbekanntem Ergebnis 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 Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In 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 Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.8 pro Sekunde Ausgabevideo Der angezeigte Tarif schätzt die Kosten vor der Generierung. Der endgültige Betrag wird anhand der 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 Tarif schätzt die Kosten vor der Generierung. Der endgültige Betrag wird anhand der 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 einer fertiggestellten, Ihnen zugeordneten Ausgabe in data[] und die vollständigen Statusmetadaten auf. Speichern Sie jede Ausgabe einschließlich ihres generierten Audios. 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; übermitteln Sie eine Anfrage mit unbekanntem Übermittlungsergebnis niemals erneut.
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 | BedeutungUrsprüngliche Status-/Inhaltsantwort 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 Anfrageinhalts schlägt vor dem Parsen des Videoprofils fehl | Nächster SchrittBewahren Sie die zurückgegebene Antwort auf und korrigieren Sie den unlesbaren Anfrageinhalt. |
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 der Übermittlung 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 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 nicht failed/cancelled/expired, und der lokale Zustand ist unknown oder der Status des ursprünglichen Auftrags ist completed. | Nächster SchrittBewahren Sie die ursprüngliche id und operation_id (dieselbe öffentliche Video-ID), die Antwort und die Header auf; lesen Sie ausschließlich den ursprünglichen Status/Inhalt. Übermitteln 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