Siirry sisältöön

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ä

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