UlazAI API Documentatie

Fullständig API-referens

Komplett dokumentation av alla UlazAI API-slutpunkter, autentiseringsmetoder och felhantering.

📋 Innehållsförteckning

🔐 Autentisering

UlazAI stöder två autentiseringsmetoder: Token-autentisering i API-nyckelautentisering.

POSTA /api/register/

Skapa ett nytt användarkonto

Begäran kropp

{
  "username": "johndoe",
  "email": "[email protected]",
  "password": "secure_password123"
}

Kommentar (201 skapade)

{
  "token": "din-auth-token-här",
  "användare": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "credits_balance": 0
  }
}
POSTA /api/login/

Logga in med användarnamn och lösenord för att få en autentiseringstoken

Begäran kropp

{
  "username": "johndoe",
  "password": "secure_password123"
}

Svar (200 OK)

{
  "token": "din-auth-token-här",
  "användare": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "credits_balance": 100
  }
}
POSTA /api/api-nycklar/ Verifiering krävs

Skapa en ny API-nyckel för autentisering

Begär rubriker

Auktorisering: Token

Begäran kropp

{
  "name": "Production API Key"
}

Kommentar (201 skapade)

{
  "id": "uuid-här",
  "name": "Production API Key",
  "key": "ulazai_live_abc123...", // Visas endast en gång!
  "key_preview": "ulazai_li...",
  "created_at": "2025-01-15T10:00:00Z"
}

⚠️ Viktig: Den fullständiga API-nyckeln visas endast en gång under skapandet. Håll det säkert!

Använd autentisering

Token-autentisering

Auktorisering: Token

API-nyckelautentisering

Auktorisation: Bärare ulazai_live_abc123...

🎨 Skapa bild

POSTA /api/v1/generera/ Verifiering krävs

Skapa en ny bild från en textuppmaning

Begäran kropp

{
  "prompt": "En vacker solnedgång över bergen med en sjö i förgrunden",
  "size": "3:2" // Alternativ: "1:1", "3:2", "2:3"
}

Kommentar (201 skapade)

{
  "framgång": sant,
  "data": {
    "generation_id": "uuid-här",
    "status": "bearbetar",
    "credits_used": 8,
    "credits_remaining": 92,
    "message": "Bildgenerering startade framgångsrikt"
  }
}

Kreditkostnader

Alla bildstorlekar kostar 8 poäng per generation

FÅ /api/v1/generate/history/ Verifiering krävs

Få din generationshistoria

Frågeparametrar

?limit=20&offset=0&type=image

🎬 Videogenerering

POSTA /api/v1/generate/video/ Verifiering krävs

Skapa en ny video från text eller bild

Begäran kropp

{
  "prompt": "En katt som leker i en trädgård",
  "video_model": "veo3_fast", // Alternativ: "veo3_fast", "veo3"
  "aspect_ratio": "16:9", // Alternativ: "16:9", "9:16"
  "watermark_text": "Mitt varumärke", // Valfritt, max 50 tecken
  "source_image_urls": [], // Valfritt, för bild-till-video
  "prompt_directory_optin": true // 💰 Få 10 krediter rabatt! (standard: sant)
}

💰 Spara 10 poäng: Uppsättning prompt_directory_optin: sant för att dela din video i vår offentliga promptkatalog och få 10 krediter per generation!

Kreditkostnader

• veo3_fast (16:9): 130 poäng

• veo3_fast (9:16): 150 poäng

• veo3 (alla förhållanden): 300 poäng

🎬 Google I See 3.1 API NY

✨ NY: Google Veo 3.1 med ramhantering, vattenstämplar och 99 % konverteringsfrekvens. Se hela dokumentationen →

POSTA /veo31/api/generera/ Verifiering krävs

Generera 8-sekunders videor med Google Veo 3.1 - Har kontroll över första och sista bildruta

Begäran kropp

{
  "prompt": "En golden retriever springer genom blommor vid solnedgången",
  "model": "veo3_fast", // "veo3_fast" eller "veo3"
  "aspectRatio": "16:9", // "16:9", "9:16", "Auto"
  "imageUrls": [], // Valfritt: 1-2 bildrutor
  "watermark": "MyBrand", // Valfritt: max 50 tecken
  "enableFallback": false, // +200 poäng för 99% framgång
  "enableTranslation": sant // Översätt automatiskt till engelska
}

Kreditkostnader

• Veo 3.1 Snabb: 100 poäng (generation 30-45 år)

• Veo 3.1 kvalitet: 250 poäng (45-60s, bättre kvalitet)

• Reservläge: +200 poäng (valfritt, 99 % framgång)

Kommentar (201 skapade)

{
  "framgång": sant,
  "data": {
    "task_id": "veo31_abc123",
    "status": "bearbetar",
    "model": "veo3_fast",
    "credits_charged": 100,
    "estimated_time": "30-45 sekunder"
  }
}

Kontrollera status

GET /veo31/api/status/{task_id}/

Reaktion:
{
  "framgång": sant,
  "data": {
    "status": "avslutad",
    "video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
    "resolution": "1080p",
    "varaktighet": 8
  }
}

📖 Fullständig dokumentation: Att se Jag ser 3.1 API-dokument för detaljerade förhandsvisningar, ramkontroll och fler funktioner.

🎬 Kling 3.0 API NY

🆕 Kling 3.0: Prissättning per sekund, inbyggt ljud, flerbildsuppmaningar och kontroll av start/slutbild. Se hela dokumentationen →

POSTA /kling30/api/generate/ Verifiering krävs

Skapa 3-15 sekunder långa klipp med text-till-video- eller bild-till-video-lägen.

Begäran kropp

{
  "prompt": "En dramatisk hjälteavslöjande i låg vinkel med regn- och neonreflektioner",
  "generationMode": "text_till_video",
  "durationSeconds": 8,
  "qualityMode": "pro",
  "ljud": sant,
  "multiShots": sant,
  "aspectRatio": "16:9",
  "prompt_directory_optin": sant
}

Kreditkostnader

• Standard utan ljud: 20 hp/sekund

• Standard med ljud: 30 hp/sekund

• Pro icke-ljud: 27 hp/sekund

• Pro med ljud: 40 poäng/sekund

📖 Fullständig dokumentation: Att se Kling 3.0 API-dokument för förfrågningsfält, statusformat och exempel.

🎬 Kling 2.6 API BÄSTA VÄRDE

💰 Billigaste alternativet: Börjar på bara 55 krediter för 5-sekunders videor med inbyggt ljudstöd. Se hela dokumentationen →

POSTA /kling26/api/generate/ Verifiering krävs

Skapa 5-10 sekunders videor med valfritt inbyggt ljud

Begäran kropp

{
  "prompt": "En hund springer genom ett fält vid solnedgången",
  "generationMode": "text_to_video", // eller "image_to_video"
  "duration": "5", // "5" eller "10" sekunder
  "aspectRatio": "16:9", // "16:9", "9:16", "1:1"
  "sound": false, // Native audio (dubbel kostnad)
  "imageUrls": [], // Krävs för bild_till_video
  "prompt_directory_optin": true // 💰 Få 10 krediter rabatt!
}

💰 Spara 10 poäng: Uppsättning prompt_directory_optin: sant att dela din video i vår offentliga promptkatalog och få 10 krediter rabatt!

Kreditkostnader

• 5s utan ljud: 55 poäng

• 10s utan ljud: 110 poäng

• 5s med ljud: 110 poäng

• 10s träffade ljud: 220 poäng

📖 Fullständig dokumentation: Att se Kling 2.6 API-dokument för detaljerade exempel och parametrar.

🎬 Sister 2 API OPENAI

🚀 OpenAI Sora 2: Premiumvideor på 10 sekunder i 1080p med otrolig kvalitet. Se hela dokumentationen →

POSTA /api/v1/sora/generate/text-to-video/ Verifiering krävs

Generera 10-sekunders 1080p-videor med OpenAI Sora 2

Begäran kropp

{
  "prompt": "Ett fridfullt bergslandskap vid soluppgången med fåglar som flyger",
  "aspect_ratio": "landskap", // "landskap", "porträtt", "fyrkantig"
  "kvalitet": "standard", // "standard" eller "hög"
  "prompt_directory_optin": true // 💰 Få 10 krediter rabatt!
}

💰 Spara 10 poäng: Uppsättning prompt_directory_optin: sant att dela din video i vår offentliga promptkatalog och få 10 krediter rabatt!

Kreditkostnader

• Text-till-video: 80 poäng per video

• Bild-till-video: 80 poäng per video

📖 Fullständig dokumentation: Att se Sora 2 API-dokument för detaljerade exempel, bild-till-video och mer.

🎬 Seedance 1.5 Pro API LJUD-VIDEO

🎬 Seedance 1.5 Pro: Cinematisk ljud- och videogenerering med 4-12 sekunders klipp, 480p/720p upplösning och valfritt inbyggt ljud. Se hela dokumentationen →

POSTA /frö/generera/ Verifiering krävs

Generera Seedance 1.5 Pro-videor med valfria bilder och ljud.

Begäran kropp

{
  "prompt": "En filmisk närbild av en kock som vänder nudlar i slow motion",
  "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generera_ljud": sant,
  "prompt_directory_optin": sant
}

💰 Broschyrrabatt: 10 poäng rabatt för alternativ på hög nivå (28+ poäng) när prompt_directory_optin: sant.

Kreditkostnader

• 480p: 8/14 (4s), 14/28 (8s), 19/38 (12s) poäng

• 720p: 14/28 (4s), 28/56 (8s), 42/84 (12s) poäng

• Ljudkostnaden visas som det högre värdet i varje par

📖 Fullständig dokumentation: Att se Seedance 1.5 Pro API-dokument för fullständiga parametrar och exempel.

🎬 Wan 2.6 API T2V/I2V/V2V

🎬 Wan 2.6: Alibabas filmiska multi-shot videomodell med T2V, I2V och V2V lägen, inbyggt ljud och videor på upp till 15 sekunder. Prova Wan 2.6 Playground →

POSTA /wan26/generera/ Verifiering krävs

Generera videor med Wan 2.6 - stöder text-till-video, bild-till-video och video-till-video-lägen

Begäran kropp

{
  "prompt": "En filmisk bild av en kvinna som går genom Tokyo på natten",
  "mode": "text-till-video", // eller "bild-till-video", "video-till-video"
  "duration": "5", // "5", "10" eller "15" sekunder
  "resolution": "1080p", // "720p" eller "1080p"
  "image_url": "...", // Krävs för bild-till-video
  "video_url": "..." // Krävs för video-till-video
}

Kreditkostnader

• 720p: 70 (5s) / 140 (10s) / 210 (15s) poäng

• 1080p: 105 (5s) / 210 (10s) / 315 (15s) poäng

📖 Prova nu: Besök Wan 2.6 Lekplats för detaljerade exempel, I2V, V2V-lägen och mer.

📊 Statuskontroll

FÅ /api/v1/generate/{generation_id}/ Verifiering krävs

Kontrollera statusen för varje generation (bild eller video)

Svar (200 OK)

{
  "id": "uuid-här",
  "generation_type": "video",
  "status": "avslutad",
  "prompt": "En katt som leker i en trädgård",
  "video_url": "https://cdn.ulazai.com/videos/...",
  "video_model": "veo3_fast",
  "credits_used": 130,
  "created_at": "2025-01-15T10:00:00Z",
  "completed_at": "2025-01-15T10:01:30Z"
}

👤 Användarhantering

FÅ /api/profil/ Verifiering krävs

Ta emot aktuell användarprofilinformation

Svar (200 OK)

{
  "id": 1,
  "username": "johndoe",
  "email": "[email protected]",
  "credits_balance": 92,
  "total_images_generated": 12,
  "enable_watermark": sant,
  "watermark_text": "Mitt varumärke",
  "created_at": "2025-01-10T08:00:00Z"
}
LÄGG NED /api/profil/ Verifiering krävs

Uppdatera användarprofilinställningarna

Begäran kropp

{
  "enable_watermark": sant,
  "watermark_text": "MyBrand.com"
}

💳 Betalningar och krediter

FÅ /payments/api/credits/ Verifiering krävs

Få aktuell kredit

Svar (200 OK)

{
  "credits_balance": 92,
  "total_spent": "25.00",
  "total_credits_purchased": 2400
}
FÅ /payments/api/transactions/ Verifiering krävs

Hämta transaktionshistorik

❌ Felhantering

Standardformat för felsvar

{
  "framgång": falskt,
  "error": "Felmeddelande här",
  "detaljer": {
    "field_name": "Specifikt fältfel"
  }
}
400 Dålig begäran Ogiltiga begärandeparametrar

Begäran är felaktigt formaterad eller saknar obligatoriska fält

401 Obehörig Saknas eller ogiltig autentisering

Ingen giltig autentiseringstoken eller API-nyckel tillhandahålls

402 Betalning krävs Otillräckliga poäng

Otillräckliga poäng för att slutföra den begärda operationen

403 Förbjudet Åtkomst nekad

Du har inte tillgång till den här resursen

404 Hittade inte Källan hittades inte

Den begärda resursen finns inte

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

För många förfrågningar på kort tid. Vänligen sakta ner

500 Internt serverfel Serverfout

Något gick fel hos oss. Försök igen

🚦 Prisgränser

Autentiserade användare 100 förfrågningar/minut
Demo användare 10 förfrågningar/timme
Samtidiga generationer 5 per användare

📝 Komplett exempel

Python exempel

importförfrågningar
importtid

# Konfiguration
API_KEY = "ulazai_live_uw_api_key_hier"
BASE_URL = "https://ulazai.com"

rubriker = {
    "Authorization": f"Bärare {API_KEY}",
    "Content-Type": "applikation/json"
}

# Generera en video
video_data = {
    "prompt": "En vacker solnedgång timelapse över havet",
    "video_model": "veo3_fast",
    "aspect_ratio": "16:9",
    "watermark_text": "Mitt varumärke"
}

response = requests.post(f"{BASE_URL}/api/v1/generate/video/", 
                        json=video_data, headers=headers)

if response.status_code == 201:
    resultat = respons.json()
    generation_id = resultat["data"]["generation_id"]
    print(f"Videogeneration gestart: {generation_id}")
    
    # Enkät för status
    medan det är sant:
        status_response = requests.get(
            f"{BASE_URL}/api/v1/genereren/{generation_id}/", 
            headers=headers
        )
        status_data = status_response.json()
        
        if status_data["status"] == "slutförd":
            print(f"Video klar: {status_data['video_url']}")
            bryta
        elif status_data["status"] == "misslyckades":
            print(f"Generation misslyckades: {status_data.get('error_message')}")
            bryta
        
        print(f"Status: {status_data['status']}...")
        time.sleep(10) # Se 10 sekunder för nästa kontroll
annat:
    print(f"Förslag: {response.json()}")

🤝 Behöver du hjälp?

• WhatsApp: Fråga oss vad som helst

• Dokumentation: docs.ulazai.com