Google: Veo 3.1
Veo 3.1 er Googles videomodell for tekst- og bildestyrte scener med generert lyd, styrte start- og sluttbilder og referansematerialer. Produksjonsprofilen gir klipp på fire, seks eller åtte sekunder ved 24 bilder per sekund, med utdatavalg som omfatter 720p, 1080p og 4K.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Veo 3.1 er Googles videogenereringsmodell for å lage en kort audiovisuell scene fra tekst eller en bildestyrt beskrivelse. Produksjonsprofilen støtter tekst-til-video, bilde-til-video og styrt skaping fra første/siste bilde, med generert lyd, materialreferanser og en egen arbeidsflyt for videreføring. Bruk den til å utvikle et filmatisk konsept, en kort produktfortelling eller et visuelt segment med en definert scene, handling og lytteopplevelse.
Beskriv først motivet og den synlige hendelsen. Fastsett omgivelsene, tiden på dagen og lyset, og definer deretter kameraets synsvinkel eller bevegelse og ønsket visuell stil. En original scenebeskrivelse kan vise et glasskar på en mørk studiooverflate, med en langsom sideveis bevegelse som avdekker en refleksjon mens en myk miljølyd følger avdekkingen. Hver instruksjon gir en synlig eller hørbar egenskap som kan vurderes i det ferdige resultatet.
Googles promptrammeverk behandler motiv, handling, scene, kamera og estetikk som separate deler av beskrivelsen. Bruk delene som tjener opptaket, fremfor å legge til alle mulige beskrivelser. Skriv regi på engelsk for den dokumenterte promptprofilen. Hvis scenen har flere handlinger, angir du forholdet mellom dem og holder dem proporsjonale med et kort klipp, slik at en avdekking eller reaksjon forblir tydelig.
Et startbilde fastsetter åpningsutseendet og komposisjonen. Bruk det når karakteren, produktet eller omgivelsene allerede finnes som visuelt materiale, og beskriv bevegelsen som skal utvikle seg fra dette. Et siste bilde legger til en målkomposisjon for avslutningen. Klargjør start- og sluttbilder som formidler en plausibel overgang og bevarer detaljene som identifiserer hovedmotivet, og undersøk deretter bevegelsen mellom disse bildene etter generering.
Materialreferanser har et annet formål: de styrer utseendet til en karakter eller et objekt i en nygenerert scene, mens start- og sluttbilder definerer bestemte øyeblikk i scenen. Velg referanser som viser viktige visuelle trekk, og gjør rollen til hvert materiale tydelig i prompten. Produksjonsmodellens spesifikasjon for referansebilde-til-video bruker utdata på åtte sekunder for denne referansearbeidsflyten, atskilt fra vanlig lengdevalg for tekststyrt generering.
Produsentens vanlige produksjonsprofil genererer klipp på fire, seks eller åtte sekunder ved 24 bilder per sekund. Den oppgir liggende 16:9 og stående 9:16, opptil fire videoutdata per prompt og utdataoppløsninger på 720p, 1080p og 4K. Utdatavideoformatet er MP4. Den bildestyrte spesifikasjonen godtar JPEG eller PNG, oppgir maksimalt 20 MB for inngangsbildet og støtter inndatakonfigurasjoner i 720p/1080p. Velg utdataprofilen for den tiltenkte plasseringen, og hold bildekomposisjonen lesbar i den størrelsen.
Innebygd lyd kan følge den synlige scenen. Angi replikker, atmosfære og lydeffekter som deler av samme beskrivelse, og navngi motivet eller hendelsen som produserer hver av dem. En dialoginstruksjon og en kamerainstruksjon svarer på ulike spørsmål: den ene fastsetter fremføringen, den andre fastsetter hvordan seeren ser den. Hold ordene innenfor klippets nyttige taletid, og vurder lyden for forståelighet og forholdet til handlingen.
For videreføring tilbyr produsenten en egen arbeidsflyt for videoforlengelse. Begynn med et egnet generert kildeklipp, og beskriv neste synlige hendelse eller endring i scenen. Behold originalsegmentet og det videreførte segmentet, slik at sammenføyningen kan vurderes for utseende, bevegelse og lyd. De vanlige valgene for nygenereringslengde og oppløsning skal ikke behandles som en universell kontrakt for hver forlengelsesoperasjon.
En negativ beskrivelse kan rette utelukkelser mot oppgavens visuelle krav. For en serie produktvariasjoner holder du motivet og komposisjonen stabile mens du endrer én kreativ retning, som lyssettingen eller kameraavstanden. Registrer prompten, referansene og valgte innstillinger sammen med resultatet. Dette gjør det mulig å sammenligne en nyttig kreativ forskjell fremfor en samling urelaterte genereringer.
Den ordinære produksjonsprofilen Veo 3.1 og Veo 3.1 Fast har forskjellige profiler for utdataoppløsning. Fast oppgir 720p og 1080p; ordinær 3.1 oppgir også 4K. Behold den valgte utgaven knyttet til resultatet, uten å erstatte en produksjonsmodellidentifikator med en eldre Preview-profil eller en annen Veo-generasjon uten videre. Både motivets utseende og den støttede operasjonen avhenger av den valgte arbeidsflyten.
Generering er en operasjon der det ferdige resultatet gir videofiler for avspilling og senere redigering. Behold de returnerte filene med kildebildene, referansematerialene og beskrivelsen, og bevar medfølgende informasjon om innholdets opprinnelse. Undersøk hvert faktisk resultat for motivets utseende, handling, utsnitt, lyd og sluttkomposisjon. Bruk det valgte klippet som en byggestein i produksjonen, med titler, overganger eller annen sluttbearbeiding lagt til i redigeringen rundt.
Ailoot Ultra · Video POST /v1/videos google/veo-3.1
google/veo-3.1Start
Veo 3.1 er Googles videomodell for tekst- og bildestyrte scener med generert lyd, styrte start- og sluttbilder og referansematerialer. Produksjonsprofilen gir klipp på fire, seks eller åtte sekunder ved 24 bilder per sekund, med utdatavalg som omfatter 720p, 1080p og 4K.
- Godkjente inndata
- Tekst
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Video POST /v1/videos
- Inndatatyper
text- Utdatatyper
video- Utdataformat
- mp4
- Antall utdata
- Opptil 4 utdatas
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser google/veo-3.1 | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Maksimalt antall UTF-8-byte: 10 000 Minst ett tegn som ikke er mellomrom, kreves: Ja | Standard— |
Feltduration | Typeinteger | KravPåkrevd | Verdier & grenser 4, 6, 8 | Standard— |
Feltresolution | Typestring | KravPåkrevd | Verdier & grenser 720p | Standard— |
Feltaspect_ratio | Typestring | KravPåkrevd | Verdier & grenser 16:9, 9:16 | Standard— |
Feltgenerate_audio | Typeboolean | KravPåkrevd | Verdier & grenser false, true | Standard— |
Kombinasjoner av inngående materialer
Tekst til video · Påkrevd: prompt
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parameteradditional_properties | Avtalefalse |
Parameterparameters | Avtale{"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 | Avtaletext |
Metodealiaser: /v1/videos/generations, /videos, /videos/generations
Livssyklus: 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
Behold hele svaret og de opprinnelige returnerte ID-ene.
Send aldri en opprettelse med ukjent utfall på nytt.
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Generer lyd | Oppløsning | Faktureringsenhet | Faktureringsvilkår | Kostnad |
|---|---|---|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Generer lyd— | Oppløsning— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonUltra | Prisplan— | Forventet mengdeForespurt konfigurasjon; kun et estimat. | Generer lydMed lyd | Oppløsning720p | Faktureringsenhetper sekund utdatavideo | Faktureringsvilkår— | Kostnad Utdata · Anslått videosekund i utdata · Estimat kun for sammenligning $0.8 per sekund utdatavideo Den viste satsen anslår kostnaden før generering. Endelig belastning beregnes fra kostnaden som er registrert for den opprinnelige genereringen. Videoens fysiske varighet er ikke den fakturerbare mengden. |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Generer lyd— | Oppløsning— | Faktureringsenhetper videosekund | Faktureringsvilkårlyd: with_audio; oppløsning: 4k | Kostnad Utdata · Videopris · Estimat kun for sammenligning $1.2 per videosekund |
| KonfigurasjonUltra | Prisplan— | Forventet mengdeForespurt konfigurasjon; kun et estimat. | Generer lydUten lyd | Oppløsning720p | Faktureringsenhetper sekund utdatavideo | Faktureringsvilkår— | Kostnad Utdata · Anslått videosekund i utdata · Estimat kun for sammenligning $0.4 per sekund utdatavideo Den viste satsen anslår kostnaden før generering. Endelig belastning beregnes fra kostnaden som er registrert for den opprinnelige genereringen. Videoens fysiske varighet er ikke den fakturerbare mengden. |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Generer lyd— | Oppløsning— | Faktureringsenhetper videosekund | Faktureringsvilkårlyd: without_audio; oppløsning: 4k | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.8 per videosekund |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Generer lyd— | Oppløsning— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $1.6 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Detaljer om referansetariffen
Referanseprisplaner på modellnivå endrer ikke metodevalg, prisoverslag eller kostnader. Aktive kostnader bruker satsene til den valgte Ailoot-metoden.
Prisreferanser for videokonfigurasjoner
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Faktureringsvilkår | Kostnad |
|---|---|---|
| KonfigurasjonVideopris | Faktureringsvilkårlyd: with_audio | Kostnad Utdata · Videopris $0.8 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårlyd: with_audio; oppløsning: 4k | Kostnad Utdata · Videopris $1.2 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårlyd: without_audio | Kostnad Utdata · Videopris $0.4 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårlyd: without_audio; oppløsning: 4k | Kostnad Utdata · Videopris $0.8 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
Eksempelforespørsler
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
Motta og lagre resultater
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
Kontroller jobbstatus
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
Andre innholdslesinger
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
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold hver signert URL for ferdigstilte data[] du eier, og alle statusmetadataene. Lagre alle utdata, inkludert den genererte lyden. Et gyldig AAC-lydspor kan finnes selv med generate_audio=false; behold hele den opprinnelige MP4-filen, inkludert lyden.
Hvis det opprinnelige svaret må kontrolleres
Les den eksisterende opprinnelige jobben; send aldri en forespørsel med ukjent utfall på nytt.
Maksimalt antall utdata: 4.
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltid | Typestring | Betydning— |
Feltobject | Typestring | Betydning— |
Feltmodel | Typestring | Betydning— |
Feltstatus | Typestring | Betydning— |
Feltdata[] | Typesigned content URL | Betydning— |
Feltcharge_pending_check | Typeboolean | Betydning— |
Felterror.code | Typestring | Betydning— |
Felterror.message | Typestring | Betydning— |
Feltoperation_id | Typestring | BetydningOpprinnelig status-/innholdssvar med HTTP503 result_pending_check: samme opprinnelige offentlige video-ID som id. |
Felterror.type | Typestring | Betydningserver_error ved HTTP503 result_pending_check. |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårLesing av den rå forespørselskroppen mislykkes før videoprofilen tolkes | Neste trinnBehold det returnerte svaret og korriger den uleselige forespørselskroppen. |
Svar422 · price_unavailable | VilkårTolking av den eksakte videoprofilen mislykkes, eller hele den tolkede profilen mangler et klart og eksakt priskort | Neste trinnBehold svaret; bruk hele den eksakte godkjente profilen og det publiserte priskortet. Denne grenen kjøres før en forespørsel sendes til leverandøren. |
Svar409 · video_not_ready | VilkårDet opprinnelige resultatinnholdet er ennå ikke tilgjengelig | Neste trinnSpør jevnlig etter den opprinnelige returnerte ID-en og følg Retry-After. |
Svarserver_error | VilkårDet returnerte svaret angir at operasjonen eller resultatet må kontrolleres | Neste trinnBevar den opprinnelige returnerte operasjons-/oppgave-ID-en, forespørselshodene og svaret; fortsett å lese den opprinnelige operasjonen på de støttede måtene. Ikke send opprettelsesforespørselen på nytt. |
Svar503 · result_pending_check | VilkårGET for opprinnelig status/innhold: oppgaven er ikke publisert, den opprinnelige jobben er ikke failed/cancelled/expired, og lokal tilstand er unknown eller den opprinnelige jobbstatusen er completed. | Neste trinnBehold opprinnelig id og operation_id (samme offentlige video-ID), svar og svarhoder; les bare opprinnelig status og innhold. Send aldri en ny forespørsel om generering. |
Aliaser
Modellaliaser
Ailoot Ultra google/veo-3.1
Aliaser for metodestier
/v1/videos/generations, /videos, /videos/generations
Tilknyttede anroper-ID-er
FAQ · Google: Veo 3.1
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·google/veo-3.1:text→video- Hvilke felt bruker forespørselen?
POST /v1/videos·google/veo-3.1:model,prompt,duration,resolution,aspect_ratio,generate_audio