UlazAI API Documentatie

Volledige API-referentie

Volledige documentatie van alle UlazAI API eindpunten, authenticatiemethoden en foutafhandeling.

πŸ“‹ Inhoudsopgave

πŸ” Authenticatie

UlazAI ondersteunt twee authenticatiemethoden: Token-authenticatie en API-sleutelauthenticatie.

POST /api/registreren/

Maak een nieuw gebruikersaccount aan

Verzoek lichaam

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

Reactie (201 aangemaakt)

{
  "token": "your-auth-token-here",
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "credits_balance": 0
  }
}
POST /api/inloggen/

Log in met gebruikersnaam en wachtwoord om een ​​authenticatietoken te krijgen

Verzoek lichaam

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

Reactie (200 OK)

{
  "token": "your-auth-token-here",
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "credits_balance": 100
  }
}
POST /api/api-toetsen/ Verificatie vereist

Maak een nieuwe API-sleutel aan voor authenticatie

Vraag headers aan

Authorization: Token <your_auth_token>

Verzoek lichaam

{
  "name": "Production API Key"
}

Reactie (201 aangemaakt)

{
  "id": "uuid-here",
  "name": "Production API Key",
  "key": "ulazai_live_abc123...", // Only shown once!
  "key_preview": "ulazai_li...",
  "created_at": "2025-01-15T10:00:00Z"
}

⚠️ Belangrijk: De volledige API-sleutel wordt tijdens het aanmaken slechts één keer weergegeven. Bewaar het veilig!

Authenticatie gebruiken

Token-authenticatie

Authorization: Token <your_auth_token>

API Sleutelauthenticatie

Authorization: Bearer ulazai_live_abc123...

🎨 Afbeelding genereren

POST /api/v1/genereren/ Verificatie vereist

Genereer een nieuwe afbeelding vanaf een tekstprompt

Verzoek lichaam

{
  "prompt": "A beautiful sunset over mountains with a lake in foreground",
  "size": "3:2"  // Options: "1:1", "3:2", "2:3"
}

Reactie (201 aangemaakt)

{
  "success": true,
  "data": {
    "generation_id": "uuid-here",
    "status": "processing",
    "credits_used": 8,
    "credits_remaining": 92,
    "message": "Image generation started successfully"
  }
}

Kredietkosten

Alle afbeeldingsformaten kosten 8 studiepunten per generatie

GET /api/v1/genereren/geschiedenis/ Verificatie vereist

Krijg uw generatiegeschiedenis

Queryparameters

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

🎬 Videogeneratie

POST /api/v1/genereren/video/ Verificatie vereist

Genereer een nieuwe video van tekst of afbeelding

Verzoek lichaam

{
  "prompt": "A cat playing in a garden",
  "video_model": "veo3_fast",  // Options: "veo3_fast", "veo3"
  "aspect_ratio": "16:9",      // Options: "16:9", "9:16"
  "watermark_text": "MyBrand", // Optional, max 50 chars
  "source_image_urls": [],     // Optional, for image-to-video
  "prompt_directory_optin": true  // πŸ’° Get 10 credits discount! (default: true)
}

πŸ’° Bespaar 10 tegoeden: Set prompt_directory_optin: true om uw video te delen in onze openbare Prompt Directory en 10 credits korting te krijgen op elke generatie!

Kredietkosten

β€’ veo3_snel (16:9): 130 studiepunten

β€’ veo3_fast (9:16): 150 studiepunten

β€’ veo3 (alle verhoudingen): 300 studiepunten

🎬 Google Veo 3.1 API NIEUW

✨ NIEUW: Google Veo 3.1 met framebeheer, watermerken en 99% succespercentage. Bekijk de volledige documentatie β†’

POST /veo31/api/genereren/ Verificatie vereist

Genereer video's van 8 seconden met Google Veo 3.1 - Beschikt over controle over eerste en laatste frame

Verzoek lichaam

{
  "prompt": "A golden retriever running through flowers at sunset",
  "model": "veo3_fast",           // "veo3_fast" or "veo3"
  "aspectRatio": "16:9",          // "16:9", "9:16", "Auto"
  "imageUrls": [],                // Optional: 1-2 frame images
  "watermark": "MyBrand",         // Optional: max 50 chars
  "enableFallback": false,        // +200 credits for 99% success
  "enableTranslation": true       // Auto-translate to English
}

Kredietkosten

β€’ Veo 3.1 Snel: 100 studiepunten (generatie 30-45 jaar)

β€’ Veo 3.1 Kwaliteit: 250 credits (45-60s, betere kwaliteit)

β€’ Terugvalmodus: +200 credits (optioneel, 99% succes)

Reactie (201 aangemaakt)

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123",
    "status": "processing",
    "model": "veo3_fast",
    "credits_charged": 100,
    "estimated_time": "30-45 seconds"
  }
}

Controleer status

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

Reactie:
{
  "success": true,
  "data": {
    "status": "completed",
    "video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
    "resolution": "1080p",
    "duration": 8
  }
}

πŸ“– Volledige documentatie: Zien Veo 3.1 API Docs voor gedetailleerde voorbeelden, framecontrole en meer functies.

🎬 Kling 3.0 API NIEUW

πŸ†• Kling 3.0: Prijzen per seconde, native audio, multi-shot-prompts en start-/eindframecontrole. Bekijk de volledige documentatie β†’

POST /kling30/api/genereren/ Verificatie vereist

Genereer clips van 3-15 seconden met de modi tekst-naar-video of afbeelding-naar-video.

Verzoek lichaam

{
  "prompt": "A dramatic low-angle hero reveal with rain and neon reflections",
  "generationMode": "text_to_video",
  "durationSeconds": 8,
  "qualityMode": "pro",
  "sound": true,
  "multiShots": true,
  "aspectRatio": "16:9",
  "prompt_directory_optin": true
}

Kredietkosten

β€’ Standaard zonder audio: 20 credits/seconde

β€’ Standaard met geluid: 30 credits/seconde

β€’ Pro niet-audio: 27 studiepunten / seconde

β€’ Pro met audio: 40 credits / seconde

πŸ“– Volledige documentatie: Zien Kling 3.0 API Docs voor aanvraagvelden, statusformaat en voorbeelden.

🎬 Kling 2.6 API BESTE WAARDE

πŸ’° Goedkoopste optie: Vanaf slechts 55 credits voor video's van 5 seconden met native audio-ondersteuning. Bekijk de volledige documentatie β†’

POST /kling26/api/genereren/ Verificatie vereist

Genereer video's van 5-10 seconden met optionele native audio

Verzoek lichaam

{
  "prompt": "A dog running through a field at sunset",
  "generationMode": "text_to_video",  // or "image_to_video"
  "duration": "5",                     // "5" or "10" seconds
  "aspectRatio": "16:9",               // "16:9", "9:16", "1:1"
  "sound": false,                      // Native audio (doubles cost)
  "imageUrls": [],                     // Required for image_to_video
  "prompt_directory_optin": true       // πŸ’° Get 10 credits discount!
}

πŸ’° Bespaar 10 credits: Set prompt_directory_optin: true om uw video te delen in onze openbare Prompt Directory en 10 credits korting te krijgen!

Kredietkosten

β€’ 5s zonder audio: 55 studiepunten

β€’ 10s zonder audio: 110 studiepunten

β€’ 5s met audio: 110 studiepunten

β€’ 10s met audio: 220 studiepunten

πŸ“– Volledige documentatie: Zien Kling 2.6 API Docs voor gedetailleerde voorbeelden en parameters.

🎬 Sora 2 API OPENAI

πŸš€ OpenAI Sora 2: Premium video's van 10 seconden bij 1080p met ongelooflijke kwaliteit. Bekijk de volledige documentatie β†’

POST /api/v1/sora/generate/text-to-video/ Verificatie vereist

Genereer 1080p-video's van 10 seconden met OpenAI Sora 2

Verzoek lichaam

{
  "prompt": "A serene mountain landscape at sunrise with birds flying",
  "aspect_ratio": "landscape",  // "landscape", "portrait", "square"
  "quality": "standard",        // "standard" or "high"
  "prompt_directory_optin": true  // πŸ’° Get 10 credits discount!
}

πŸ’° Bespaar 10 credits: Set prompt_directory_optin: true om uw video te delen in onze openbare Prompt Directory en 10 credits korting te krijgen!

Kredietkosten

β€’ Tekst-naar-video: 80 credits per video

β€’ Afbeelding-naar-video: 80 credits per video

πŸ“– Volledige documentatie: Zien Sora 2 API Docs voor gedetailleerde voorbeelden, afbeelding-naar-video en meer.

🎬 Seedance 1.5 Pro API AUDIO-VIDEO

🎬 Seedance 1.5 Pro: Filmische audio-videogeneratie met clips van 4-12 seconden, resolutie van 480p/720p en optionele native audio. Bekijk de volledige documentatie β†’

POST /zaad/genereren/ Verificatie vereist

Genereer Seedance 1.5 Pro-video's met optionele invoerafbeeldingen en audio.

Verzoek lichaam

{
  "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
  "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "prompt_directory_optin": true
}

πŸ’° Folderkorting: 10 credits korting voor opties op hoog niveau (28+ credits) wanneer prompt_directory_optin: true.

Kredietkosten

β€’ 480p: 8/14 (4s), 14/28 (8s), 19/38 (12s) studiepunten

β€’ 720p: 14/28 (4s), 28/56 (8s), 42/84 (12s) studiepunten

β€’ Audiokosten weergegeven als de hogere waarde in elk paar

πŸ“– Volledige documentatie: Zien Seedance 1.5 Pro API Documenten voor volledige parameters en voorbeelden.

🎬 Wan 2.6 API T2V/I2V/V2V

🎬 Wan 2.6: Alibaba's filmische multi-shot videomodel met T2V-, I2V- en V2V-modi, native audio en video's van maximaal 15 seconden. Probeer Wan 2.6 Speeltuin β†’

POST /wan26/genereren/ Verificatie vereist

Genereer video's met Wan 2.6 - ondersteunt de modi tekst-naar-video, afbeelding-naar-video en video-naar-video

Verzoek lichaam

{
  "prompt": "A cinematic shot of a woman walking through Tokyo at night",
  "mode": "text-to-video",  // or "image-to-video", "video-to-video"
  "duration": "5",          // "5", "10", or "15" seconds
  "resolution": "1080p",    // "720p" or "1080p"
  "image_url": "...",       // Required for image-to-video
  "video_url": "..."        // Required for video-to-video
}

Kredietkosten

β€’ 720p: 70 (5s) / 140 (10s) / 210 (15s) studiepunten

β€’ 1080p: 105 (5s) / 210 (10s) / 315 (15s) studiepunten

πŸ“– Probeer het nu: Bezoek de Wan 2.6 Speeltuin voor gedetailleerde voorbeelden, I2V-, V2V-modi en meer.

πŸ“Š Statuscontrole

GET /api/v1/genereren/{generation_id}/ Verificatie vereist

Controleer de status van elke generatie (afbeelding of video)

Reactie (200 OK)

{
  "id": "uuid-here",
  "generation_type": "video",
  "status": "completed",
  "prompt": "A cat playing in a garden",
  "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"
}

πŸ‘€ Gebruikersbeheer

GET /api/profiel/ Verificatie vereist

Ontvang actuele gebruikersprofielinformatie

Reactie (200 OK)

{
  "id": 1,
  "username": "johndoe",
  "email": "[email protected]",
  "credits_balance": 92,
  "total_images_generated": 12,
  "enable_watermark": true,
  "watermark_text": "MyBrand",
  "created_at": "2025-01-10T08:00:00Z"
}
NEERZETTEN /api/profiel/ Verificatie vereist

Update de gebruikersprofielinstellingen

Verzoek lichaam

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

πŸ’³ Betalingen en tegoeden

GET /betalingen/api/tegoeden/ Verificatie vereist

Ontvang het huidige tegoed

Reactie (200 OK)

{
  "credits_balance": 92,
  "total_spent": "25.00",
  "total_credits_purchased": 2400
}
GET /betalingen/api/transacties/ Verificatie vereist

Transactiegeschiedenis ophalen

❌ Foutafhandeling

Standaard foutresponsformaat

{
  "success": false,
  "error": "Error message here",
  "details": {
    "field_name": "Specific field error"
  }
}
400 Slecht verzoek Ongeldige verzoekparameters

Het verzoek heeft een onjuiste indeling of er ontbreak verplichte velden

401 Ongeautoriseerd Ontbreakde of ongeldige authenticatie

Geen geldig authenticatietoken of API-sleutel opgegeven

402 Betaling vereist Onvoldoende kredieten

Onvoldoende credits om de gevraagde bewerking te voltooien

403 Verboden Toegang geweigerd

U heeft geen toegang tot deze bron

404 Niet gevonden Bron niet gevonden

De aangevraagde bron bestaat niet

429 Te veel verzoeken Tarieflimiet overschreden

Te veel aanvragen in een korte periode. Vertraag alstublieft

500 Interne serverfout Serverfout

Er is iets misgegaan aan onze kant. Probeer het opnieuw

🚦 Tarieflimieten

Geauthenticeerde gebruikers 100 verzoeken/minuut
Demo-gebruikers 10 aanvragen/uur
Gelijktijdige generaties 5 per gebruiker

πŸ“ Compleet voorbeeld

Python-voorbeeld

import requests
import time

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

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Genereer een video
video_data = {
    "prompt": "A beautiful sunset timelapse over the ocean",
    "video_model": "veo3_fast",
    "aspect_ratio": "16:9",
    "watermark_text": "MyBrand"
}

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

if response.status_code == 201:
    result = response.json()
    generation_id = result["data"]["generation_id"]
    print(f"Videogeneratie gestart: {generation_id}")
    
    # Poll voor status
    while True:
        status_response = requests.get(
            f"{BASE_URL}/api/v1/genereren/{generation_id}/", 
            headers=headers
        )
        status_data = status_response.json()
        
        if status_data["status"] == "completed":
            print(f"Video klaar: {status_data['video_url']}")
            break
        elif status_data["status"] == "failed":
            print(f"Generatie mislukt: {status_data.get('error_message')}")
            break
        
        print(f"Status: {status_data['status']}...")
        time.sleep(10) # Wacht 10 seconden voor de volgende controle
else:
    print(f"Fout: {response.json()}")

🀝 Hulp nodig?

β€’ WhatsApp: Vraag ons alles

β€’ Documentatie: docs.ulazai.com