UlazAI utviklerdokumenter
Google Veo 3.1 videogenerasjon API
Google Veo 3.1 videogenerasjon API
Generer videoer med Veo 3.1 ved å bruke de støttede rammekontrollene og jobbstatusarbeidsflyten.
✨ NYHET: Veo 3.1 Lite, Fast og Quality er tilgjengelig med første og siste rammekontroll.
✨ Veo 3.1-funksjoner
✅ Tre modellalternativer - Lite, rask og kvalitet
✅ Rammekontroll - Sett første og siste bildebilde
✅ Tekst-til-video og bilde-til-video
✅ 8-sekunders videoer med innfødt lyd
✅ Støtte for vannmerke - Legg til merketekst
✅ Valgfri reservemodus for et nytt modellforsøk
✅ Automatisk oversettelse til engelsk
✅ Flere sideforhold (16:9, 9:16, Auto)
💰 Priser
💸 Veo 3.1 Lite
40 kreditter
Best-verdi-modus
Tekst-til-video + bilde-til-video
⚡ Veo 3.1 Fast
100 kreditter
~$0,92 per video
Tiden varierer etter kø
💎 Veo 3.1 kvalitet
220 kreditter
~$2,31 per video
Tiden varierer etter kø
🛡️ Reservemodus
+200 kreditter
Valgfritt tillegg
Fallback garanterer ikke suksess
/veo31/api/generate/
Generer Veo 3.1-video
Lag en 8-sekunders video med Google Veo 3.1 ved å bruke tekstmeldinger og valgfrie bilderammer.
Forespørselsorgan
{
"prompt": "A golden retriever running through a field of flowers at sunset",
"model": "veo3_lite", // Options: "veo3_lite", "veo3_fast", "veo3"
"aspectRatio": "16:9", // Options: "16:9", "9:16", "Auto"
"imageUrls": [], // Optional: Array of 1-2 image URLs
"seeds": 42069, // Optional: 10000-99999 for reproducible results
"watermark": "UlazAI", // Optional: Max 50 characters
"enableFallback": false, // Optional fallback attempt; check current extra credits
"enableTranslation": true // Optional: Auto-translate to English
}
Parametere
prompt * (streng)
Tekstbeskrivelse av videoen som skal genereres. Maks 5000 tegn. Vær beskrivende om handlinger, kamerabevegelser og atmosfære.
modell * (streng)
Modell å bruke: veo3_lite (40 kreditter), veo3_fast (100 kreditter), eller veo3 (220 kreditter)
aspektforhold (streng)
Videosideforhold: 16:9 (landskap), 9:16 (portrett), Auto (automatisk). Standard: 16:9
imageUrls (matrise)
Valgfri rekke med 1-2 bildenettadresser for rammekontroll:
• 1 bilde: Video sentreres rundt dette bildet
• 2 bilder: Videooverganger fra første til siste bilde
Maks 10 MB per bilde, kun JPG/PNG
frø (heltall)
Valgfritt frø for reproduserbare resultater. Rekkevidde: 10000-99999
vannmerke (streng)
Valgfri vannmerketekst til overlegg på video. Maks 50 tegn. Flott for merkevarebygging.
aktiverFallback (boolsk)
Aktiver et valgfritt forsøk på en sikkerhetskopimodell. Sjekk gjeldende ekstra kredittkostnad; fallback garanterer ikke fullføring. Standard: false
aktivere Oversettelse (boolsk)
Auto-oversett forespørsel til engelsk for best resultat. Støtter alle språk. Standard: true
Suksessrespons (201)
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"credits_charged": 100,
"credits_remaining": 900,
"estimated_time": "varies by queue",
"message": "Veo 3.1 video generation started successfully"
}
}
Feilrespons (400)
{
"success": false,
"error": "Insufficient credits. Required: 100, Available: 50"
}
cURL-eksempel - tekst-til-video
curl -X POST https://ulazai.com/veo31/api/generate/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A golden retriever running through a field of flowers at sunset, slow motion, cinematic lighting",
"model": "veo3_fast",
"aspectRatio": "16:9",
"watermark": "MyBrand",
"enableTranslation": true
}'
cURL-eksempel - bilde-til-video med rammekontroll
curl -X POST https://ulazai.com/veo31/api/generate/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "The character slowly turns their head and smiles at the camera",
"model": "veo3",
"aspectRatio": "16:9",
"imageUrls": ["https://your-domain.com/start-frame.jpg"],
"seeds": 42069,
"enableFallback": true
}'
Python eksempel
import requests
import time
API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com"
# Generate video
response = requests.post(
f"{BASE_URL}/veo31/api/generate/",
headers={
"Authorization": f"Token {API_KEY}",
"Content-Type": "application/json"
},
json={
"prompt": "A serene mountain lake at sunrise with mist rising from the water",
"model": "veo3_fast",
"aspectRatio": "16:9",
"watermark": "MyBrand"
}
)
data = response.json()
if data["success"]:
task_id = data["data"]["task_id"]
print(f"Task created: {task_id}")
# Poll for completion
while True:
status_response = requests.get(
f"{BASE_URL}/veo31/api/status/{task_id}/",
headers={"Authorization": f"Token {API_KEY}"}
)
status_data = status_response.json()
if status_data["data"]["status"] == "completed":
video_url = status_data["data"]["video_url"]
print(f"Video ready: {video_url}")
break
elif status_data["data"]["status"] == "failed":
print(f"Generation failed: {status_data['data']['error_message']}")
break
time.sleep(5) # Poll every 5 seconds
else:
print(f"Error: {data['error']}")
/veo31/api/status/<task_id>/
Sjekk generasjonsstatus
Sjekk statusen til en Veo 3.1 videogenereringsoppgave.
Respons - Behandling
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"prompt": "A golden retriever running through flowers",
"credits_charged": 100
}
}
Svar - Fullført
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "completed",
"video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
"thumbnail_url": "https://cdn.ulazai.com/videos/veo31_abc123_thumb.jpg",
"resolution": "1080p",
"duration": 8,
"aspect_ratio": "16:9",
"fallback_used": false,
"credits_charged": 100
}
}
Svar - Mislyktes
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "failed",
"error_message": "Content policy violation. Enable fallback mode to retry.",
"credits_refunded": 100
}
}
Eksempel på cURL
curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
-H "Authorization: Token YOUR_API_KEY"
/veo31/api/upload-frame/
Last opp rammebilde
Last opp et bilde for rammekontroll (første eller siste bilde). Returnerer en URL som skal brukes i genereringsendepunktet.
Forespørsel (multipart/skjemadata)
Content-Type: multipart/form-data
image: (binary file data)
Parametere
bilde * (fil)
Bildefil å laste opp. Maks 10 MB. Støttede formater: JPG, PNG. Anbefalt oppløsning: 1920x1080 eller høyere.
Suksessrespons (200)
{
"success": true,
"url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
"message": "Image uploaded successfully"
}
Eksempel på cURL
curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
-H "Authorization: Token YOUR_API_KEY" \
-F "image=@/path/to/your/image.jpg"
Statuskoder
200 OK - Forespørselen er vellykket
201 Opprettet - Generasjonsoppgave opprettet
400 Dårlig forespørsel - Ugyldige parametere eller utilstrekkelig kreditt
401 Uautorisert - Manglende eller ugyldig API-nøkkel
404 Ikke funnet - Oppgave-ID ikke funnet
413 Nyttelast for stor - Bildet overskrider grensen på 10 MB
429 For mange forespørsler - Satsgrensen er overskredet
500 Intern serverfeil - Serverfeil, kontakt support
Oppgavestatusverdier
venter - Oppgave opprettet, venter på å starte
behandling - Video blir generert
fullført - Videogenerering vellykket, video_url tilgjengelig
mislyktes - Generering mislyktes, kreditter refundert automatisk
💡 Beste praksis
Bruk beskrivende spørsmål
Ta med detaljer om handlinger, kamerabevegelser, belysning og atmosfære. Eksempel: "sakte nærbilde av vanndråper som faller, bakgrunnsbelyst av gylden solnedgang, grunt dybdeskarphet"
Aktiver reserve for viktig innhold
For viktige jobber bør du vurdere det valgfrie reserveforsøket og fortsatt håndtere mislykkede eller avviste generasjoner i arbeidsflyten din.
Bruk frø for konsistens
Hvis du trenger å gjenskape lignende videoer, bruk den samme startverdien (10000-99999) for mer konsistente resultater.
Rammekontroll for merkevarebygging
Last opp 1 bilde for å sentrere videoen rundt det, eller 2 bilder for å lage en jevn overgang. Perfekt for konsekvente karakter- eller produktvideoer.
Avstemningsstatus effektivt
Poll hvert 5. sekund for rask modus, 10 sekunder for kvalitetsmodus. Ikke spør oftere for å unngå takstgrenser.
📝 Eksempel på meldinger
✅ God forespørsel
"En majestetisk ørn svever over snødekte fjell ved daggry, gyllent lys lyser opp vingene, sakte filmkamera som følger nedenfra, kinokomposisjon"
✅ God forespørsel
"Nærbilde av en barista som skjenker latte art, damp som stiger opp fra koppen, varm kafébelysning, grunt dybdeskarphet, makrolinseperspektiv"
❌ Dårlig forespørsel
"ørn som flyr"
For vag – mangler detaljer om innstilling, bevegelse, kameravinkel
Trenger du hjelp?
Har du problemer med Veo 3.1 API? Vi er her for å hjelpe!