UlazAI utvecklardokument
Ljudgenerering API
Musikstudio-API
Skapa låtar och fortsätt arbeta med dem via samma API som Musikstudio använder.
Läs operationskatalogen för aktuella modeller, obligatoriska fält och kreditpriser. Skicka med ett unikt begärande-ID så att ett nytt försök inte kan debiteras två gånger.
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/
Ditt bibliotek innehåller alla returnerade takes. Redigering skapar ett nytt resultat och behåller originalet.
Ljudgenerering API
Skapa musik, voiceovers och ljudeffekter med hjälp av UlazAI-krediter. Resultaten levereras asynkront: skicka ett jobb och polla sedan statusslutpunkten tills det är klart.
Autentisering: använd Authorization: Bearer <ulazai_api_key> eller
Authorization: Token <token>.
🎵 Musik
/api/v1/music/generate/
Auth krävs
Skapa ett musikspår från en prompt.
Begäran kropp
{
"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
}
Svar (201 skapade)
{
"success": true,
"data": {
"music_id": "uuid-here",
"status": "processing",
"status_url": "/api/v1/music/status/uuid-here/",
"credits_used": 12,
"credits_remaining": 88
}
}
Kreditkostnad: 12 krediter per begäran.
/api/v1/music/status/<music_id>/
Auth krävs
Enkät för slutförande av jobb.
Svar (200 OK, klar)
{
"success": true,
"data": {
"music_id": "uuid-here",
"status": "completed",
"audio_url": "https://media.ulazai.com/...",
"credits_used": 12
}
}
🎙️ Voiceover
/api/v1/voiceover/generate/
Auth krävs
Konvertera text till en voiceover.
Begäran kropp (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)
}
Begäran (dialog)
{
"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."}
]
}
Kreditkostnad: baserat på antal tecken. Turbo 2.5: 12 krediter per 1 000 tecken. V3/Dialog: 14 krediter per 1 000 tecken.
/api/v1/voiceover/status/<voiceover_id>/
Auth krävs
Omröstning för slutförande och hämta ljud-URL.
🔊 Ljudeffekter
/api/v1/sound-effects/generate/
Auth krävs
Generera en ljudeffekt från en prompt.
Begäran kropp
{
"text": "A futuristic UI beep with a short tail",
"loop": false,
"duration_seconds": 2.5
}
Kreditkostnad: 0,24 krediter/sek (avrundat uppåt), minimum 1 kredit.
/api/v1/sound-effects/status/<sfx_id>/
Auth krävs
Omröstning för slutförande och hämta ljud-URL.