UlazAI documente pentru dezvoltatori
Google Veo 3.1 Generare video API
Google Veo 3.1 Generare video API
Generați videoclipuri cu Veo 3.1 utilizând controalele de cadru acceptate și fluxul de lucru pentru starea lucrării.
✨ NOU: Veo 3.1 Lite, Fast și Quality sunt disponibile cu controlul primului și ultimul cadru.
✨ Caracteristici Veo 3.1
✅ Trei variante de model - Simplu, rapid și de calitate
✅ Controlul cadrului - Setați primul și ultimul cadru pentru imagini
✅ Text-to-video şi imagine-la-video
✅ Videoclipuri de 8 secunde cu audio nativ
✅ Suport filigran - Adăugați textul mărcii
✅ Mod de rezervă opțional pentru oa doua încercare de model
✅ Traducere automată la engleză
✅ Raport de aspect multiple (16:9, 9:16, automat)
💰 Prețuri
💸 Veo 3.1 Lite
40 credite
Modul cea mai bună valoare
Text-to-video + imagine-to-video
⚡ Veo 3.1 Fast
100 credite
~0,92 USD per videoclip
Timpul variază în funcție de coadă
💎 Veo 3.1 Calitate
220 credite
~2,31 USD per videoclip
Timpul variază în funcție de coadă
🛡️ Modul de rezervă
+200 credite
Supliment opțional
Fallback nu garantează succesul
/veo31/api/generate/
Generați videoclipul Veo 3.1
Creați un videoclip de 8 secunde cu Google Veo 3.1 folosind textul prompt și cadre de imagine opționale.
Organismul de solicitare
{
"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
}
Parametrii
prompt * (șir)
Descrierea text a videoclipului de generat. Maxim 5000 de caractere. Fiți descriptivi despre acțiuni, mișcările camerei și atmosferă.
model * (șir)
Model de utilizat: veo3_lite (40 credite), veo3_fast (100 credite), sau veo3 (220 credite)
aspectRatio (șir)
Raport de aspect video: 16:9 (peisaj), 9:16 (portret), Auto (automat). Implicit: 16:9
imageUrls (matrice)
Matrice opțională de 1-2 adrese URL de imagine pentru controlul cadrelor:
• 1 imagine: Videoclipul este centrat în jurul acestei imagini
• 2 imagini: tranzițiile video de la primul la ultimul cadru
Maximum 10 MB per imagine, numai JPG/PNG
semințe (întreg)
Sămânță opțională pentru rezultate reproductibile. Interval: 10000-99999
filigran (șir)
Text filigran opțional pentru a se suprapune pe videoclip. Maxim 50 de caractere. Excelent pentru branding.
enableFallback (boolean)
Activați o încercare opțională de model de rezervă. Verificați costul actual al creditului suplimentar; alternativa nu garantează finalizarea. Implicit: false
enableTranslation (boolean)
Traduceți automat promptul în engleză pentru cele mai bune rezultate. Acceptă toate limbile. Implicit: true
Răspuns de succes (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"
}
}
Răspuns la eroare (400)
{
"success": false,
"error": "Insufficient credits. Required: 100, Available: 50"
}
Exemplu cURL - Text-to-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
}'
Exemplu de cURL - imagine-to-video cu control cadre
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
}'
Exemplu Python
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>/
Verificați starea generației
Verificați starea unei sarcini de generare video Veo 3.1.
Răspuns - Procesare
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"prompt": "A golden retriever running through flowers",
"credits_charged": 100
}
}
Răspuns - Finalizat
{
"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
}
}
Răspuns - Eșuat
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "failed",
"error_message": "Content policy violation. Enable fallback mode to retry.",
"credits_refunded": 100
}
}
Exemplu de cURL
curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
-H "Authorization: Token YOUR_API_KEY"
/veo31/api/upload-frame/
Încărcați imaginea cadru
Încărcați o imagine pentru controlul cadrului (primul sau ultimul cadru). Returnează o adresă URL de utilizat în punctul final de generare.
Solicitare (multipart/form-data)
Content-Type: multipart/form-data
image: (binary file data)
Parametrii
imagine * (dosar)
Fișier imagine de încărcat. Maxim 10 MB. Formate acceptate: JPG, PNG. Rezoluție recomandată: 1920x1080 sau mai mare.
Răspuns de succes (200)
{
"success": true,
"url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
"message": "Image uploaded successfully"
}
Exemplu de cURL
curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
-H "Authorization: Token YOUR_API_KEY" \
-F "image=@/path/to/your/image.jpg"
Coduri de stare
200 OK - Solicitare reușită
201 Creat - Sarcina de generare creată cu succes
400 Solicitare greșită - Parametri nevalidi sau credite insuficiente
401 Neautorizat - Cheie API lipsă sau nevalidă
404 Nu a fost găsit - ID-ul sarcinii nu a fost găsit
413 Sarcină utilă prea mare - Imaginea depășește limita de 10 MB
429 Prea multe cereri - Limita ratei a fost depășită
500 Eroare interna server - Eroare de server, contactați asistența
Valori de stare a sarcinii
în aşteptare - Sarcina creată, așteaptă să înceapă
prelucrare - Videoclipul este generat
completat - Generare video de succes, video_url disponibil
a eșuat - Generarea a eșuat, creditele rambursate automat
💡 Cele mai bune practici
Utilizați prompt-uri descriptive
Includeți detalii despre acțiuni, mișcările camerei, iluminare și atmosferă. Exemplu: „prim-plan cu mișcare lentă a picăturilor de apă care cad, iluminat din spate de apusul auriu, adâncime mică de câmp”
Activați alternativă pentru conținut important
Pentru joburi importante, luați în considerare încercarea opțională de rezervă și gestionați în continuare generațiile eșuate sau respinse în fluxul dvs. de lucru.
Folosiți semințele pentru consistență
Dacă trebuie să regenerați videoclipuri similare, utilizați aceeași valoare de semințe (10000-99999) pentru rezultate mai consistente.
Controlul cadrului pentru branding
Încărcați 1 imagine pentru a vă centra videoclipul în jurul acestuia sau 2 imagini pentru a crea o tranziție lină. Perfect pentru videoclipuri consistente cu personaje sau produse.
Starea sondajului în mod eficient
Sondaj la fiecare 5 secunde pentru modul rapid, 10 secunde pentru modul Calitate. Nu sondați mai des pentru a evita limitele ratelor.
📝 Exemplu Prompt
✅ Bun Prompt
„Un vultur maiestuos plutește peste munți acoperiți de zăpadă în zori, lumina aurie iluminându-și aripile, urmărirea camerei cu încetinitorul filmat de jos, compoziție cinematografică”
✅ Bun Prompt
„Prim plan al unui barista care toarnă latte artă, abur care se ridică din ceașcă, iluminare caldă a cafelei, adâncime mică de câmp, perspectiva lentilei macro”
❌ Prompt slab
"vultur care zboară"
Prea vag - lipsesc detalii despre setare, mișcare, unghiul camerei
Ai nevoie de ajutor?
Aveți probleme cu Veo 3.1 API? Suntem aici pentru a vă ajuta!