UlazAI fejlesztői dokumentumok
Google Veo 3.1 Videógenerálás API
Google Veo 3.1 Videógenerálás API
Készítsen videókat a Veo 3.1 segítségével a támogatott keretvezérlők és a munkaállapot-munkafolyamat segítségével.
✨ ÚJ: A Veo 3.1 Lite, Fast és Quality elérhető az első és az utolsó képkocka vezérléssel.
✨ Veo 3.1 jellemzők
✅ Három modell opció - Egyszerű, gyors és minőségi
✅ Keretvezérlés - Állítsa be az első és az utolsó képkockát
✅ Szövegből videóba és képről videóra
✅ 8 másodperces videók natív hanggal
✅ Vízjel támogatás - Márkaszöveg hozzáadása
✅ Opcionális tartalék mód a második modellkísérlethez
✅ Automatikus fordítás angolra
✅ Több képarány (16:9, 9:16, automatikus)
💰 Árazás
💸 Veo 3.1 Lite
40 krediteket
Legjobb ár-érték arányú mód
Szövegből videóba + képből videóba
⚡ Veo 3.1 Fast
100 krediteket
~0,92 USD videónként
Az idő soronként változik
💎 Veo 3.1 minőség
220 krediteket
~2,31 USD videónként
Az idő soronként változik
🛡️ Tartalék mód
+200 krediteket
Opcionális kiegészítő
A visszaállítás nem garantálja a sikert
/veo31/api/generate/
Veo 3.1 videó létrehozása
Készítsen 8 másodperces videót a Google Veo 3.1 segítségével szöveges promptok és opcionális képkeretek használatával.
Kérelem szerve
{
"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
}
Paraméterek
prompt * (karakterlánc)
A generálandó videó szöveges leírása. Max 5000 karakter. Legyen leíró a cselekvésekről, a kamera mozgásáról és a légkörről.
modell * (karakterlánc)
Használandó modell: veo3_lite (40 kreditek), veo3_fast (100 kredit), vagy veo3 (220 kredit)
oldalarány (karakterlánc)
Videó képaránya: 16:9 (táj), 9:16 (portré), Auto (automatikus). Alapértelmezett: 16:9
imageUrls (tömb)
1-2 kép URL-ből álló opcionális tömb keretvezérléshez:
• 1 kép: A videó a kép körül áll
• 2 kép: Videó átmenetek az elsőtől az utolsó képkockáig
Képenként legfeljebb 10 MB, csak JPG/PNG
magvak (egész szám)
Opcionális vetőmag a reprodukálható eredmények érdekében. Tartomány: 10000-99999
vízjel (karakterlánc)
Választható vízjelszöveg a videóra ráfedéshez. Max 50 karakter. Kiváló a márkaépítéshez.
engedélyezése Fallback (boolean)
Engedélyezze az opcionális biztonsági mentési modellkísérletet. Ellenőrizze az aktuális extra hitelköltséget; a tartalék nem garantálja a befejezést. Alapértelmezett: false
Engedélyezze a fordítást (boolean)
A legjobb eredmény érdekében fordítsa le automatikusan a prompt-t angolra. Támogatja az összes nyelvet. Alapértelmezett: true
Sikerreakció (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"
}
}
Hibaválasz (400)
{
"success": false,
"error": "Insufficient credits. Required: 100, Available: 50"
}
cURL példa – Szöveg-videó
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-példa – Kép-videó keretszabályozással
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 példa
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>/
Ellenőrizze a Generációs állapotot
Ellenőrizze a Veo 3.1 videógenerálási feladat állapotát.
Válasz - Feldolgozás
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"prompt": "A golden retriever running through flowers",
"credits_charged": 100
}
}
Válasz – kész
{
"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
}
}
Válasz - Sikertelen
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "failed",
"error_message": "Content policy violation. Enable fallback mode to retry.",
"credits_refunded": 100
}
}
cURL példa
curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
-H "Authorization: Token YOUR_API_KEY"
/veo31/api/upload-frame/
Keretkép feltöltése
Kép feltöltése keretvezérléshez (első vagy utolsó képkocka). A generálás végpontjában használandó URL-t adja vissza.
Kérelem (többrészes/űrlapadatok)
Content-Type: multipart/form-data
image: (binary file data)
Paraméterek
kép * (fájl)
Feltöltendő képfájl. Max 10 MB. Támogatott formátumok: JPG, PNG. Javasolt felbontás: 1920x1080 vagy nagyobb.
Sikerre adott válasz (200)
{
"success": true,
"url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
"message": "Image uploaded successfully"
}
cURL példa
curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
-H "Authorization: Token YOUR_API_KEY" \
-F "image=@/path/to/your/image.jpg"
Állapotkódok
200 OK - Sikeres kérés
201 Létrehozva - Generációs feladat sikeresen létrehozva
400 Rossz kérés - Érvénytelen paraméterek vagy nem elegendő kredit
401 Jogosulatlan - Hiányzó vagy érvénytelen API kulcs
404 Nem található - A feladatazonosító nem található
413 A rakomány túl nagy - A kép meghaladja a 10 MB korlátot
429 Túl sok kérés - A díjhatár túllépve
500 Belső szerverhiba - Szerverhiba, lépjen kapcsolatba a támogatással
Feladat állapotértékei
függőben - Feladat létrehozva, indulásra vár
feldolgozása - Videó létrehozása folyamatban van
elkészült - Sikeres videógenerálás, elérhető a video_url
nem sikerült - A generálás sikertelen, a kreditek automatikusan visszatérítésre kerülnek
💡 A legjobb gyakorlatok
Használjon leíró prompt-ket
Adjon meg részleteket a műveletekről, a kamera mozgásáról, a világításról és a légkörről. Példa: "lassított közeli vízcseppek zuhanása, aranyszínű naplemente háttérvilágítása, sekély mélységélesség"
Tartalék engedélyezése a fontos tartalomhoz
Fontos munkák esetén fontolja meg az opcionális tartalékkísérletet, és továbbra is kezelje a sikertelen vagy elutasított generációkat a munkafolyamatban.
Használjon magokat a konzisztencia érdekében
Ha hasonló videókat kell újragenerálnia, használja ugyanazt a kezdőértéket (10000-99999) a következetesebb eredmények érdekében.
Keretvezérlés a márkaépítéshez
Töltsön fel 1 képet a videó középpontjába, vagy 2 képet a sima átmenet létrehozásához. Tökéletes konzisztens karakter- vagy termékvideókhoz.
Szavazás állapota hatékonyan
Lekérdezés 5 másodpercenként gyors módban, 10 másodpercenként minőségi módban. Ne szavazzon gyakrabban, hogy elkerülje az aránykorlátokat.
📝 Példa Prompts
✅ Jó Prompt
"Fenséges sas szárnyal a hófödte hegyek felett hajnalban, arany fény világítja meg szárnyait, lassított kamera követi alulról, filmes kompozíció"
✅ Jó Prompt
"Közeli kép egy latte art-ot öntő baristáról, a csészéből felszálló gőz, meleg kávézói világítás, sekély mélységélesség, makró objektív perspektívája"
❌ Szegény Prompt
"repülő sas"
Túl homályos – hiányoznak a beállítások, mozgás, kameraállás részletei
Segítségre van szüksége?
Problémái vannak a Veo 3.1 API készülékkel? Azért vagyunk itt, hogy segítsünk!