Hoppa till innehållet

UlazAI utvecklardokument

Ljudgenerering API

Musikstudio-API

Suno API

Skapa låtar och fortsätt arbeta med dem via samma API som Musikstudio använder.

Öppna Musikstudio

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

POST /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.

FÅ /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

POST /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.

FÅ /api/v1/voiceover/status/<voiceover_id>/ Auth krävs

Omröstning för slutförande och hämta ljud-URL.

🔊 Ljudeffekter

POST /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.

FÅ /api/v1/sound-effects/status/<sfx_id>/ Auth krävs

Omröstning för slutförande och hämta ljud-URL.