UlazAI API Dokumentation

Audiogenerierung 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 einer Eingabeaufforderung.

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.

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

GET /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

Generieren Sie einen Soundeffekt aus einer Eingabeaufforderung.

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.

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

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