Naar inhoud

UlazAI ontwikkelaarsdocumentatie

Audiogeneratie API

Muziekstudio-API

Suno API

Maak liedjes en werk er in dezelfde API als Muziekstudio gewoon mee verder.

Open Muziekstudio

Lees de operatiecatalogus voor de huidige modellen, verplichte velden en creditprijzen. Stuur een uniek request-ID mee, zodat het opnieuw versturen van een verzoek niet dubbel kan afrekenen.

GET  /api/v1/music/studio/catalog/
POST /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/<id>/
POST /api/v1/music/studio/upload/

Je bibliotheek bevat alle opgeleverde takes. Bewerken maakt een nieuw resultaat en laat het origineel staan.

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/music/generate/ 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.

KRIJG /api/v1/music/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/generate/ 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.

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

Poll voor voltooiing en haal de audio-URL op.

🔊 Geluidseffecten

POST /api/v1/sound-effects/generate/ 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 krediet.

KRIJG /api/v1/sound-effects/status/<sfx_id>/ Verificatie vereist

Poll voor voltooiing en haal de audio-URL op.