Hopp til innholdet

UlazAI utviklerdokumenter

Google Veo 3.1 videogenerasjon API

Google Veo 3.1 videogenerasjon API

Generer videoer med Veo 3.1 ved å bruke de støttede rammekontrollene og jobbstatusarbeidsflyten.

✨ NYHET: Veo 3.1 Lite, Fast og Quality er tilgjengelig med første og siste rammekontroll.

✨ Veo 3.1-funksjoner

✅ Tre modellalternativer - Lite, rask og kvalitet

✅ Rammekontroll - Sett første og siste bildebilde

✅ Tekst-til-video og bilde-til-video

✅ 8-sekunders videoer med innfødt lyd

✅ Støtte for vannmerke - Legg til merketekst

✅ Valgfri reservemodus for et nytt modellforsøk

✅ Automatisk oversettelse til engelsk

✅ Flere sideforhold (16:9, 9:16, Auto)

💰 Priser

💸 Veo 3.1 Lite

40 kreditter

Best-verdi-modus

Tekst-til-video + bilde-til-video

⚡ Veo 3.1 Fast

100 kreditter

~$0,92 per video

Tiden varierer etter kø

💎 Veo 3.1 kvalitet

220 kreditter

~$2,31 per video

Tiden varierer etter kø

🛡️ Reservemodus

+200 kreditter

Valgfritt tillegg

Fallback garanterer ikke suksess

POST /veo31/api/generate/

Generer Veo 3.1-video

Lag en 8-sekunders video med Google Veo 3.1 ved å bruke tekstmeldinger og valgfrie bilderammer.

Forespørselsorgan

{
  "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
}

Parametere

prompt * (streng)

Tekstbeskrivelse av videoen som skal genereres. Maks 5000 tegn. Vær beskrivende om handlinger, kamerabevegelser og atmosfære.

modell * (streng)

Modell å bruke: veo3_lite (40 kreditter), veo3_fast (100 kreditter), eller veo3 (220 kreditter)

aspektforhold (streng)

Videosideforhold: 16:9 (landskap), 9:16 (portrett), Auto (automatisk). Standard: 16:9

imageUrls (matrise)

Valgfri rekke med 1-2 bildenettadresser for rammekontroll:
• 1 bilde: Video sentreres rundt dette bildet
• 2 bilder: Videooverganger fra første til siste bilde
Maks 10 MB per bilde, kun JPG/PNG

frø (heltall)

Valgfritt frø for reproduserbare resultater. Rekkevidde: 10000-99999

vannmerke (streng)

Valgfri vannmerketekst til overlegg på video. Maks 50 tegn. Flott for merkevarebygging.

aktiverFallback (boolsk)

Aktiver et valgfritt forsøk på en sikkerhetskopimodell. Sjekk gjeldende ekstra kredittkostnad; fallback garanterer ikke fullføring. Standard: false

aktivere Oversettelse (boolsk)

Auto-oversett forespørsel til engelsk for best resultat. Støtter alle språk. Standard: true

Suksessrespons (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"
  }
}

Feilrespons (400)

{
  "success": false,
  "error": "Insufficient credits. Required: 100, Available: 50"
}

cURL-eksempel - tekst-til-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
  }'

cURL-eksempel - bilde-til-video med rammekontroll

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 eksempel

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']}")
FÅ /veo31/api/status/<task_id>/

Sjekk generasjonsstatus

Sjekk statusen til en Veo 3.1 videogenereringsoppgave.

Respons - Behandling

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "processing",
    "model": "veo3_fast",
    "prompt": "A golden retriever running through flowers",
    "credits_charged": 100
  }
}

Svar - Fullført

{
  "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
  }
}

Svar - Mislyktes

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "failed",
    "error_message": "Content policy violation. Enable fallback mode to retry.",
    "credits_refunded": 100
  }
}

Eksempel på cURL

curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
  -H "Authorization: Token YOUR_API_KEY"
POST /veo31/api/upload-frame/

Last opp rammebilde

Last opp et bilde for rammekontroll (første eller siste bilde). Returnerer en URL som skal brukes i genereringsendepunktet.

Forespørsel (multipart/skjemadata)

Content-Type: multipart/form-data

image: (binary file data)

Parametere

bilde * (fil)

Bildefil å laste opp. Maks 10 MB. Støttede formater: JPG, PNG. Anbefalt oppløsning: 1920x1080 eller høyere.

Suksessrespons (200)

{
  "success": true,
  "url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
  "message": "Image uploaded successfully"
}

Eksempel på cURL

curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -F "image=@/path/to/your/image.jpg"

Statuskoder

200 OK - Forespørselen er vellykket

201 Opprettet - Generasjonsoppgave opprettet

400 Dårlig forespørsel - Ugyldige parametere eller utilstrekkelig kreditt

401 Uautorisert - Manglende eller ugyldig API-nøkkel

404 Ikke funnet - Oppgave-ID ikke funnet

413 Nyttelast for stor - Bildet overskrider grensen på 10 MB

429 For mange forespørsler - Satsgrensen er overskredet

500 Intern serverfeil - Serverfeil, kontakt support

Oppgavestatusverdier

venter - Oppgave opprettet, venter på å starte

behandling - Video blir generert

fullført - Videogenerering vellykket, video_url tilgjengelig

mislyktes - Generering mislyktes, kreditter refundert automatisk

💡 Beste praksis

Bruk beskrivende spørsmål

Ta med detaljer om handlinger, kamerabevegelser, belysning og atmosfære. Eksempel: "sakte nærbilde av vanndråper som faller, bakgrunnsbelyst av gylden solnedgang, grunt dybdeskarphet"

Aktiver reserve for viktig innhold

For viktige jobber bør du vurdere det valgfrie reserveforsøket og fortsatt håndtere mislykkede eller avviste generasjoner i arbeidsflyten din.

Bruk frø for konsistens

Hvis du trenger å gjenskape lignende videoer, bruk den samme startverdien (10000-99999) for mer konsistente resultater.

Rammekontroll for merkevarebygging

Last opp 1 bilde for å sentrere videoen rundt det, eller 2 bilder for å lage en jevn overgang. Perfekt for konsekvente karakter- eller produktvideoer.

Avstemningsstatus effektivt

Poll hvert 5. sekund for rask modus, 10 sekunder for kvalitetsmodus. Ikke spør oftere for å unngå takstgrenser.

📝 Eksempel på meldinger

✅ God forespørsel

"En majestetisk ørn svever over snødekte fjell ved daggry, gyllent lys lyser opp vingene, sakte filmkamera som følger nedenfra, kinokomposisjon"

✅ God forespørsel

"Nærbilde av en barista som skjenker latte art, damp som stiger opp fra koppen, varm kafébelysning, grunt dybdeskarphet, makrolinseperspektiv"

❌ Dårlig forespørsel

"ørn som flyr"

For vag – mangler detaljer om innstilling, bevegelse, kameravinkel

Trenger du hjelp?

Har du problemer med Veo 3.1 API? Vi er her for å hjelpe!