UlazAI ontwikkelaarsdocumentatie
Audiogeneratie API
Muziekstudio-API
Maak liedjes en werk er in dezelfde API als Muziekstudio gewoon mee verder.
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
/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.
/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
/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.
/api/v1/voiceover/status/<voiceover_id>/
Verificatie vereist
Poll voor voltooiing en haal de audio-URL op.
🔊 Geluidseffecten
/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.
/api/v1/sound-effects/status/<sfx_id>/
Verificatie vereist
Poll voor voltooiing en haal de audio-URL op.