Siirry sisältöön
UlazAI

UlazAI kehittäjädokumentit

Äänen sukupolvi API

Hinnoittelu Kojelauta Kuvastudio

Musiikkistudion API

Suno API

Luo kappaleita ja jatka niiden työstämistä samalla API:lla, jota musiikkistudio käyttää.

Avaa musiikkistudio

Lue operaatioluettelosta ajantasaiset mallit, pakolliset kentät ja kreditihinnat. Lähetä yksilöllinen pyyntötunnus, jotta pyynnön uudelleenyritys ei veloita kahta kertaa.

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/

Kirjastosi sisältää kaikki palautetut versiot. Muokkaaminen luo uuden tuloksen ja säilyttää alkuperäisen.

Äänen sukupolvi API

Luo musiikkia, selostuksia ja äänitehosteita käyttämällä UlazAI-pisteitä. Tulokset toimitetaan asynkronisesti: lähetä työ ja tee sitten kysely tilan päätepisteestä, kunnes se on valmis.

Todennus: käyttö Authorization: Bearer <ulazai_api_key> tai Authorization: Token <token>.

🎵 Musiikki

POST /api/v1/music/generate/ Todennus vaaditaan

Luo musiikkikappale prompt:stä.

Pyynnön elin

{
  "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
}

Vastaus (201 luotu)

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

Luottokulut: 12 krediittejä pyynnöstä.

GET /api/v1/music/status/<music_id>/ Todennus vaaditaan

Äänestys työn valmistumisesta.

Vastaus (200 OK, valmis)

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

🎙️ Voiceover

POST /api/v1/voiceover/generate/ Todennus vaaditaan

Muunna teksti selostukseksi.

Pyyntöteksti (TTS)

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

Pyyntöteksti (vuoropuhelu)

{
  "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."}
  ]
}

Gemini 3.8 Flash TTS / Gemini 3.8 Flash-Lite TTS

{
  "model": "gemini_38_flash",  // or "gemini_38_lite"
  "text": "Welcome to UlazAI Studio. <short pause> Let's create something amazing.",
  "voice": "Sulafat",          // Optional, default "Fola" (70 voices: Kore, Puck, Achernar, ...)
  "style": "Warm and calm, like a friendly teacher.",  // Optional
  "temperature": 1             // Optional (0 - 2)
}

// Dialogue: max 2 voices, optional style per line
{
  "model": "gemini_38_flash",
  "dialogue": [
    {"voice": "Kore", "text": "We need a new hook for this ad.", "style": "Tired, dry"},
    {"voice": "Puck", "text": "Let's make it shorter and punchier. <laugh>"}
  ],
  "filler_words": true         // Optional, only with exactly 2 voices
}

// Gemini 3.8 Flash: 4 credits / 1,000 chars
// Gemini 3.8 Flash-Lite: 3 credits / 1,000 chars

Luottokustannukset: perustuu merkkien määrään. Turbo 2.5: 12 krediittejä 1 000 merkkiä kohden. V3/Dialogi: 14 krediittejä 1 000 merkkiä kohden.

GET /api/v1/voiceover/status/<voiceover_id>/ Todennus vaaditaan

Tee kysely loppuun ja hae äänen URL-osoite.

🔊 Äänitehosteet

POST /api/v1/sound-effects/generate/ Todennus vaaditaan

Luo äänitehoste prompt:stä.

Pyynnön elin

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

Luottokulut: 0,24 krediittiä/s (pyöristettynä), minimi 1 luotto.

GET /api/v1/sound-effects/status/<sfx_id>/ Todennus vaaditaan

Tee kysely loppuun ja hae äänen URL-osoite.