Ugrás a tartalomra

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

POST /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']}")
GET /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"
POST /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!