UlazAI kehittäjädokumentit
Google Veo 3.1 videosukupolvi API
Google Veo 3.1 videosukupolvi API
Luo videoita Veo 3.1:lla käyttämällä tuettuja kehyssäätimiä ja työn tilan työnkulkua.
✨ UUTTA: Veo 3.1 Lite, Fast ja Quality ovat saatavilla ensimmäisen ja viimeisen kehyksen ohjauksella.
✨ Veo 3.1 ominaisuudet
✅ Kolme mallivaihtoehtoa - Kevyt, nopea ja laadukas
✅ Kehyksen ohjaus - Aseta ensimmäisen ja viimeisen kehyksen kuvat
✅ Tekstistä videoksi ja kuvasta videoon
✅ 8 sekunnin videoita alkuperäisellä äänellä
✅ Vesileiman tuki - Lisää tuotemerkkiteksti
✅ Valinnainen varatila toiselle malliyritykselle
✅ Automaattinen käännös englanniksi
✅ Useita kuvasuhteita (16:9, 9:16, automaattinen)
💰 Hinnoittelu
💸 Veo 3.1 Lite
40 krediittejä
Paras hinta-laatusuhde
Tekstistä videoksi + kuvasta videoksi
⚡ Veo 3.1 Fast
100 krediittejä
~0,92 dollaria per video
Aika vaihtelee jonon mukaan
💎 Laatu Veo 3.1
220 krediittejä
~2,31 dollaria per video
Aika vaihtelee jonon mukaan
🛡️ Varatila
+200 krediittejä
Valinnainen lisäosa
Palautus ei takaa menestystä
/veo31/api/generate/
Luo Veo 3.1-video
Luo 8 sekunnin video Google Veo 3.1:lla käyttämällä tekstiä prompts ja valinnaisia kuvakehyksiä.
Pyynnön elin
{
"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
}
Parametrit
prompt * (merkkijono)
Luotavan videon tekstikuvaus. Enintään 5000 merkkiä. Kuvaile toimintaa, kameran liikkeitä ja tunnelmaa.
malli * (merkkijono)
Käytettävä malli: veo3_lite (40 krediittejä), veo3_fast (100 krediittejä), tai veo3 (220 krediittejä)
kuvasuhde (merkkijono)
Videon kuvasuhde: 16:9 (maisema), 9:16 (muotokuva), Auto (automaattinen). Oletus: 16:9
imageUrls (joukko)
Valinnainen 1-2 kuvan URL-osoitteiden joukko kehysten hallintaa varten:
• 1 kuva: Video keskittyy tämän kuvan ympärille
• 2 kuvaa: Video siirtyy ensimmäisestä viimeiseen kuvaan
Enintään 10 Mt per kuva, vain JPG/PNG
siemeniä (kokonaisluku)
Valinnainen siemen toistettavia tuloksia varten. Alue: 10000-99999
vesileima (merkkijono)
Valinnainen vesileimateksti, joka peitetään videolla. Enintään 50 merkkiä. Erinomainen brändäyskäyttöön.
ota Fallback käyttöön (looginen)
Ota käyttöön valinnainen varmuuskopiointiyritys. Tarkista nykyiset ylimääräiset luottokustannukset; varmistus ei takaa valmistumista. Oletus: false
ota käännös käyttöön (looginen)
Käännä prompt automaattisesti englanniksi saadaksesi parhaat tulokset. Tukee kaikkia kieliä. Oletus: true
Menestysvastaus (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"
}
}
Virhevastaus (400)
{
"success": false,
"error": "Insufficient credits. Required: 100, Available: 50"
}
cURL-esimerkki - Tekstistä videoksi
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-esimerkki - Kuvasta videoon kehysten ohjauksella
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 esimerkki
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>/
Tarkista sukupolven tila
Tarkista Veo 3.1-videon luontitehtävän tila.
Vastaus - Käsittely
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"prompt": "A golden retriever running through flowers",
"credits_charged": 100
}
}
Vastaus - Valmis
{
"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
}
}
Vastaus - Epäonnistui
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "failed",
"error_message": "Content policy violation. Enable fallback mode to retry.",
"credits_refunded": 100
}
}
cURL-esimerkki
curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
-H "Authorization: Token YOUR_API_KEY"
/veo31/api/upload-frame/
Lataa kehyskuva
Lataa kuva kehyksen ohjausta varten (ensimmäinen tai viimeinen kehys). Palauttaa luomispäätepisteessä käytettävän URL-osoitteen.
Pyyntö (moniosainen/lomake-data)
Content-Type: multipart/form-data
image: (binary file data)
Parametrit
kuva * (tiedosto)
Ladattava kuvatiedosto. Enintään 10 MB. Tuetut tiedostomuodot: JPG, PNG. Suositeltu resoluutio: 1920x1080 tai suurempi.
Menestysvastaus (200)
{
"success": true,
"url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
"message": "Image uploaded successfully"
}
cURL-esimerkki
curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
-H "Authorization: Token YOUR_API_KEY" \
-F "image=@/path/to/your/image.jpg"
Tilakoodit
200 OK - Pyyntö onnistui
201 Luotu - Luontitehtävä luotu onnistuneesti
400 Huono pyyntö - Virheelliset parametrit tai riittämättömät hyvitykset
401 Luvaton - Puuttuva tai virheellinen API-avain
404 Ei löydy - Tehtävätunnusta ei löydy
413 Hyötykuorma liian suuri - Kuva ylittää 10 Mt rajan
429 Liian monta pyyntöä - Hintaraja ylitetty
500 Sisäinen palvelinvirhe - Palvelinvirhe, ota yhteyttä tukeen
Tehtävän tilan arvot
vireillä - Tehtävä luotu, odottaa alkamista
käsittelyä - Videota luodaan
valmiiksi - Videon luominen onnistui, video_url saatavilla
epäonnistunut - Luonti epäonnistui, hyvitykset palautetaan automaattisesti
💡 Parhaat käytännöt
Käytä kuvailevia prompt:itä
Sisällytä tietoja toiminnoista, kameran liikkeistä, valaistuksesta ja tunnelmasta. Esimerkki: "hidastettu lähikuva putoavista vesipisaroista, kultaisen auringonlaskun taustavalaistu, syväterävyys"
Ota käyttöön tärkeän sisällön varatoiminto
Tärkeissä töissä harkitse valinnaista varayritystä ja käsittele silti epäonnistuneita tai hylättyjä sukupolvia työnkulussasi.
Käytä siemeniä johdonmukaisuuden saamiseksi
Jos sinun on luotava uudelleen samanlaisia videoita, käytä samaa siemenarvoa (10000-99999) johdonmukaisempien tulosten saamiseksi.
Kehyksen ohjaus brändäystä varten
Lataa 1 kuva keskittääksesi videosi sen ympärille tai 2 kuvaa luodaksesi sujuvan siirtymän. Täydellinen johdonmukaisiin hahmo- tai tuotevideoihin.
Äänestyksen tila tehokkaasti
Pollaus 5 sekunnin välein nopeassa tilassa, 10 sekunnin välein laatutilassa. Älä tee äänestystä useammin välttääksesi rajoitukset.
📝 Esimerkki Prompts
✅ Hyvä Prompt
"Majesteettinen kotka kohoaa lumihuippuisten vuorten yli aamunkoitteessa, kultainen valo valaisee sen siipiä, hidastettu kameran seurantakuva alhaalta, elokuvallinen sommitelma"
✅ Hyvä Prompt
"Lähikuva latte-taidetta kaatavasta baristasta, kupista nouseva höyry, lämmin kahvilavalaistus, syväterävyys, makrolinssin perspektiivi"
❌ Huono Prompt
"kotka lentää"
Liian epämääräinen – puuttuu yksityiskohtia asetuksista, liikkeestä, kamerakulmasta
Tarvitsetko apua?
Onko sinulla ongelmia Veo 3.1 API:n kanssa? Olemme täällä auttamassa!