UlazAI API Documentatie

Audiogeneratie API

Genereer muziek, voice-overs en geluidseffecten met UlazAI-credits. Resultaten worden asynchroon geleverd: een taak indienen en vervolgens het statuseindpunt opvragen totdat deze is voltooid.

Authenticatie: gebruik Authorization: Bearer <ulazai_api_key> of Authorization: Token <token>.

🎡 Muziek

POST /api/v1/muziek/genereren/ Verificatie vereist

Genereer een muziektrack op basis van een prompt.

Verzoek lichaam

{
  "prompt": "Upbeat synthwave track with neon retro vibes",
  "model": "V5",               // Options: "V5", "V4_5PLUS" (default: V4_5PLUS)
  "duration": 30,              // Optional (seconds)
  "instrumental": true,        // Optional (default: true)
  "title": "Neon Nights",      // Optional
  "style": "synthwave, 120bpm" // Optional
}

Reactie (201 aangemaakt)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "processing",
    "status_url": "/api/v1/music/status/uuid-here/",
    "credits_used": 12,
    "credits_remaining": 88
  }
}

Kredietkosten: 12 tegoeden per aanvraag.

GET /api/v1/muziek/status/<music_id>/ Verificatie vereist

Poll voor voltooiing van de taak.

Reactie (200 OK, voltooid)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "completed",
    "audio_url": "https://media.ulazai.com/...",
    "credits_used": 12
  }
}

πŸŽ™οΈVoice-over

POST /api/v1/voiceover/genereren/ Verificatie vereist

Converteer tekst naar een voice-over.

Verzoektekst (TTS)

{
  "model": "tts_turbo_25",     // Options: "tts_turbo_25", "tts_v3"
  "text": "Welcome to UlazAI Studio. Let's create something amazing.",
  "voice": "Rachel",          // Optional
  "speed": 1.0                // Optional (0.7 - 1.2)
}

Verzoektekst (dialoog)

{
  "model": "dialogue_v3",
  "dialogue": [
    {"voice": "Rachel", "text": "We need a new hook for this ad."},
    {"voice": "Roger",  "text": "Let's make it shorter and punchier."}
  ]
}

Kredietkosten: gebaseerd op het aantal tekens. Turbo-2,5: 12 credits per 1.000 tekens. V3/Dialoog: 14 credits per 1.000 tekens.

GET /api/v1/voiceover/status/<voiceover_id>/ Verificatie vereist

Poll voor voltooiing en haal de audio-URL op.

πŸ”Š Geluidseffecten

POST /api/v1/geluidseffecten/genereren/ Verificatie vereist

Genereer een geluidseffect vanaf een prompt.

Verzoek lichaam

{
  "text": "A futuristic UI beep with a short tail",
  "loop": false,
  "duration_seconds": 2.5
}

Kredietkosten: 0,24 credits/sec (naar boven afgerond), minimaal 1 credit.

GET /api/v1/geluidseffecten/status/<sfx_id>/ Verificatie vereist

Poll voor voltooiing en haal de audio-URL op.