Zum Inhalt springen

UlazAI Entwicklerdokumentation

Audio-Generierung API

Musikstudio-API

Suno API

Erstelle Songs und arbeite über dieselbe API wie im Musikstudio an ihnen weiter.

Musikstudio öffnen

Im Operationskatalog findest du aktuelle Modelle, Pflichtfelder und Credit-Preise. Sende eine eindeutige Request-ID mit, damit ein erneuter Versuch nicht doppelt abrechnen kann.

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/

Deine Bibliothek enthält alle gelieferten Takes. Bearbeiten erzeugt ein neues Ergebnis und behält das Original.

Audio-Generierung API

Generieren Sie Musik, Voiceovers und Soundeffekte mit UlazAI-Credits. Ergebnisse werden asynchron geliefert: Senden Sie einen Job und fragen Sie dann den Statusendpunkt ab, bis er abgeschlossen ist.

Authentifizierung: verwenden Authorization: Bearer <ulazai_api_key> oder Authorization: Token <token>.

🎵 Musik

POST /api/v1/music/generate/ Authentifizierung erforderlich

Generieren Sie einen Musiktitel aus einem prompt.

Anforderungstext

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

Antwort (201 erstellt)

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

Kreditkosten: 12 Credits pro Anfrage.

ERHALTEN /api/v1/music/status/<music_id>/ Authentifizierung erforderlich

Umfrage zur Auftragserfüllung.

Antwort (200 OK, abgeschlossen)

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

🎙️ Voiceover

POST /api/v1/voiceover/generate/ Authentifizierung erforderlich

Wandeln Sie Text in ein Voiceover um.

Anfragetext (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)
}

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

Kreditkosten: basierend auf der Anzahl der Charaktere. Turbo 2.5: 12 Credits pro 1.000 Zeichen. V3/Dialog: 14 Credits pro 1.000 Zeichen.

ERHALTEN /api/v1/voiceover/status/<voiceover_id>/ Authentifizierung erforderlich

Führen Sie eine Umfrage zur Fertigstellung durch und rufen Sie die Audio-URL ab.

🔊 Soundeffekte

POST /api/v1/sound-effects/generate/ Authentifizierung erforderlich

Erzeugen Sie einen Soundeffekt aus einem prompt.

Anforderungstext

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

Kreditkosten: 0,24 Credits/Sek. (aufgerundet), Minimum 1 Kredit.

ERHALTEN /api/v1/sound-effects/status/<sfx_id>/ Authentifizierung erforderlich

Führen Sie eine Umfrage zur Fertigstellung durch und rufen Sie die Audio-URL ab.