UlazAI API Documentatie

Google Veo 3.1 Video Generation API

Generera filmiska AI-videor med Googles senaste Veo 3.1-modell - Med ramkontroll, vattenstämplar och 99 % konverteringsfrekvens.

✨ NY: Veo 3.1 Snabb (100 poäng) och kvalitet (250 poäng) nu tillgänglig med första och sista ramkontroll!

✨ Veo 3.1 funktioner

✅ Två kvalitetslägen - Snabb (30-45s) och kvalitet (45-60s)

✅ Ramkontroll - Ställ in första och sista bildruta

✅ Text-till-video I bild-till-video

✅ 8 sekunders videor träffade inbyggt ljud

✅ Stöd för vattenstämpel - Lägg till varumärkestext

✅ 99% framgång träffade fallback-modus

✅ Automatisk översättning till engelska

✅ Flera bildförhållanden (16:9, 9:16, automatisk)

💰 Priser

⚡ Veo 3.1 Snabb

100 poäng

~$0,92 per video

30-45 andra generationen

💎 Veo 3.1 kvalitet

250 poäng

~2,31 USD per video

45-60 andra generationen

🛡️ Reservläge

+200 poäng

Valfritt tillägg

99% framgångsgaranti

POSTA /veo31/api/generera/

Veo 3.1 Generera video

Skapa en 8-sekunders video med Google Veo 3.1 med hjälp av textmeddelanden och valfria bildramar.

Begäran kropp

{
  "prompt": "En golden retriever springer genom ett fält av blommor vid solnedgången",
  "model": "veo3_fast", // Alternativ: "veo3_fast", "veo3"
  "aspectRatio": "16:9", // Alternativ: "16:9", "9:16", "Auto"
  "imageUrls": [], // Valfritt: Array med 1-2 bildadresser
  "frön": 42069, // Valfritt: 10000-99999 för reproducerbara resultat
  "watermark": "UlazAI", // Valfritt: Max 50 tecken
  "enableFallback": false, // Valfritt: +200 poäng för 99 % framgång
  "enableTranslation": true // Valfritt: Översätt automatiskt till engelska
}

Parametrar

snabbt * (sträng)

Textbeskrivning av videon som ska genereras. Max 5000 tecken. Var beskrivande om handlingar, kamerarörelser och atmosfär.

modell * (sträng)

Modell att använda: veo3_snel (100 hp, 30-45s) eller veo3 (250 poäng, 45-60-tal, bättre kvalitet)

aspektförhållande (sträng)

Videobildförhållande: 16:9 (landskap), 9:16 (porträtt), Bil (automatisk). Standard: 16:9

imageUrls (matris)

Valfri sekvens av 1-2 bildwebbadresser före ramkontroll:
• 1 bild: videon kretsar kring denna bild
• 2 bilder: videoövergångar från första till sista bildrutan
Max 10 MB per bild, endast JPG/PNG

frön (heltal)

Valfritt frö för reproducerbara resultat. Räckvidd: 10 000-99 999

vattenstämpel (sträng)

Valfri vattenstämpeltext för överlagring på video. Max 50 tecken. Idealisk för branding.

aktivera Fallback (Boolesk)

Aktivera reservläge (+200 poäng). Använder automatiskt en säkerhetskopieringsmodell när innehållspolicyer är aktiverade. 99% framgång. Standard: falsk

Aktivera översättning (Boolesk)

Automatisk översättning av uppmaningen till engelska för bästa resultat. Stöder alla språk. Standard: sann

Framgångssvar (201)

{
  "framgång": sant,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "bearbetar",
    "model": "veo3_fast",
    "credits_charged": 100,
    "credits_remaining": 900,
    "estimated_time": "30-45 sekunder",
    "message": "Veo 3.1-videogenerering startade framgångsrikt"
  }
}

Felsvar (400)

{
  "framgång": falskt,
  "error": "Otillräckliga poäng. Krävs: 100, Tillgänglig: 50"
}

cURL-exempel: text-till-video

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Auktorisering: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "En golden retriever som springer genom ett fält av blommor vid solnedgången, slow motion, filmisk belysning",
    "model": "veo3_fast",
    "aspectRatio": "16:9",
    "watermark": "Mitt varumärke",
    "enableTranslation": sant
  }'

cURL-exempel - Bild-till-video med ramhantering

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Auktorisering: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Tecken vänder sakta på huvudet och ler mot kameran",
    "model": "veo3",
    "aspectRatio": "16:9",
    "imageUrls": ["https://din-domän.com/start-frame.jpg"],
    "frön": 42069,
    "enableFallback": sant
  }'

Python exempel

importförfrågningar
importtid

API_KEY = "din_api_nyckel_här"
BASE_URL = "https://ulazai.com"

# Skapa video
svar = requests.post(
    f"{BASE_URL}/veo31/api/generate/",
    rubriker={
        "Authorization": f"Token {API_KEY}",
        "Content-Type": "applikation/json"
    },
    json={
        "prompt": "En fridfull bergssjö vid soluppgången med dimma som stiger upp ur vattnet",
        "model": "veo3_fast",
        "aspectRatio": "16:9",
        "watermark": "Mitt varumärke"
    }
)

data = respons.json()
om data["framgång"]:
    task_id = data["data"]["task_id"]
    print(f"Uppgiften skapad: {task_id}")
    
    # Omröstning för slutförande
    medan det är sant:
        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"] == "slutfört":
            video_url = status_data["data"]["video_url"]
            print(f"Video redo: {video_url}")
            bryta
        elif status_data["data"]["status"] == "misslyckades":
            print(f"Genereringen misslyckades: {status_data['data']['error_message']}")
            bryta
        
        time.sleep(5) # Omröstning var 5:e sekund
annat:
    print(f"Fel: {data['error']}")
FÅ /veo31/api/status//

Kontrollera generationens status

Kontrollera statusen för ett Veo 3.1-videogenereringsjobb.

Svar - Bearbetning

{
  "framgång": sant,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "bearbetar",
    "model": "veo3_fast",
    "prompt": "En golden retriever springer genom blommor",
    "credits_charged": 100
  }
}

Svar - Slutfört

{
  "framgång": sant,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "avslutad",
    "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 - Misslyckades

{
  "framgång": sant,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "misslyckades",
    "error_message": "Brott mot innehållspolicy. Aktivera reservläge för att försöka igen.",
    "credits_refunded": 100
  }
}

cURL exempel

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

Ladda upp rambild

Ladda upp en bild för ramkontroll (första eller sista bildrutan). Returnerar en URL att använda i den genererade slutpunkten.

Begäran (multipart/form-data)

Innehållstyp: multipart/form-data

bild: (binär fildata)

Parametrar

bild * (finns)

Bildfil att ladda upp. Max 10 MB. Format som stöds: JPG, PNG. Rekommenderad upplösning: 1920x1080 eller högre.

Framgångssvar (200)

{
  "framgång": sant,
  "url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
  "message": "Bilden har laddats upp"
}

cURL exempel

curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
  -H "Auktorisering: Token YOUR_API_KEY" \
  -F "afbeelding=@/pad/naar/uw/afbeelding.jpg"

Statuskoder

200 okej - Förfrågan lyckades

201 Skapad - Generationsuppgiften har skapats framgångsrikt

400 Dålig begäran - Ogiltiga parametrar eller otillräckliga poäng

401 Obehörig - Olåst eller ogiltig API-nyckel

404 Hittade inte - Job ID hittades inte

413 Lasten är för stor - Bilden överskrider gränsen 10 MB

429 För många förfrågningar - Prisgränsen har överskridits

500 Internt serverfel - Serverfel, kontakta support

Jobbstatusvärden

i avvaktan på - Uppgift skapad, väntar på att starta

bearbetning - Video genereras

avslutad - Videogenerering lyckades, video_url tillgänglig

misslyckades - Generering misslyckas, krediter återbetalas automatiskt

💡 Bästa metoder

Använd beskrivande ledtrådar

Lägg till detaljer om åtgärder, kamerarörelser, ljus och atmosfär. Exempel: "närbild i slow motion av fallande vattendroppar, upplyst av en gyllene solnedgång, grunt skärpedjup"

Aktivera reserv för viktigt innehåll

Om videon är kritisk och du inte har råd med några misstag, aktivera reservläge (+200 krediter) för en framgångsfrekvens på 99 %.

Använd frön för konsistens

Om du vill återskapa liknande videor, använd samma startvärde (10000-99999) för mer konsekventa resultat.

Ramkontroll för branding

Ladda upp 1 bild för att centrera din video runt den, eller 2 bilder för att skapa en mjuk övergång. Perfekt för konsekventa karaktärer eller produktvideor.

Enkätstatus effektivt

Poll var 5:e sekund för snabbläge, 10 sekunder för kvalitetsläge. Omrösta inte oftare för att undvika pristak.

📝 Exempel på uppmaningar

✅ Bra uppmaning

"En majestätisk örn svävar över snötäckta berg vid soluppgången, gyllene ljus lyser upp dess vingar, slow motion kamera spårar underifrån, filmisk komposition"

✅ Bra uppmaning

"Närbild av en barista som häller lattekonst, ånga som stiger upp ur koppen, varm kafébelysning, grunt skärpedjup, makrolinsperspektiv"

❌ Dålig uppmaning

"örnflugor"

För vagt – saknade detaljer om inställning, rörelse, kameravinkel

Behöver du hjälp?

Har du problem med Veo 3.1 API? Vi är här för att hjälpa till!

Kontakta supporten Se alla dokument