Hopp til innholdet

UlazAI utviklerdokumenter

Lydgenerering API

Musikkstudio-API

Suno API

Lag låter og jobb videre med dem via samme API som Musikkstudio bruker.

Åpne Musikkstudio

Les operasjonskatalogen for gjeldende modeller, obligatoriske felt og kreditpriser. Send med en unik forespørsels-ID slik at et nytt forsøk ikke kan belastes dobbelt.

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/

Biblioteket ditt inneholder alle returnerte takes. Redigering lager et nytt resultat og beholder originalen.

Lydgenerering API

Generer musikk, voiceovers og lydeffekter ved å bruke UlazAI-kreditter. Resultatene leveres asynkront: send inn en jobb, og spør deretter statusendepunktet til det er fullført.

Autentisering: bruk Authorization: Bearer <ulazai_api_key> eller Authorization: Token <token>.

🎵 Musikk

POST /api/v1/music/generate/ Auth påkrevd

Generer et musikkspor fra en melding.

Forespørselsorgan

{
  "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 opprettet)

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

Kredittkostnad: 12 kreditter per forespørsel.

FÅ /api/v1/music/status/<music_id>/ Auth påkrevd

Avstemning for fullføring av jobb.

Svar (200 OK, fullført)

{
  "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 påkrevd

Konverter tekst til en voiceover.

Forespørselstekst (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)
}

Forespørselstekst (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."}
  ]
}

Kredittkostnad: basert på antall tegn. Turbo 2.5: 12 kreditter per 1000 tegn. V3/Dialog: 14 kreditter per 1000 tegn.

FÅ /api/v1/voiceover/status/<voiceover_id>/ Auth påkrevd

Poll for fullføring og hent lyd-URL.

🔊 Lydeffekter

POST /api/v1/sound-effects/generate/ Auth påkrevd

Generer en lydeffekt fra en forespørsel.

Forespørselsorgan

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

Kredittkostnad: 0.24 kreditter/sek (rundet opp), minimum 1 kreditt.

FÅ /api/v1/sound-effects/status/<sfx_id>/ Auth påkrevd

Poll for fullføring og hent lyd-URL.