Przejdź do treści
UlazAI

Dokumentacja programisty UlazAI

Generacja dźwięku API

Wycena Panel Pracownia obrazu

API Studia muzyki

Suno API

Twórz piosenki i kontynuuj nad nimi pracę przez to samo API, którego używa Studio muzyki.

Otwórz Studio muzyki

Przeczytaj katalog operacji: aktualne modele, wymagane pola i ceny w kredytach. Prześlij unikalny identyfikator żądania, aby ponowne wysłanie żądania nie zostało rozliczone dwa razy.

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/

Twoja biblioteka zawiera wszystkie zwrócone wersje. Edycja tworzy nowy wynik i zachowuje oryginał.

Generacja dźwięku API

Generuj muzykę, narrację i efekty dźwiękowe, korzystając z kredytów UlazAI. Wyniki są dostarczane asynchronicznie: przesłać zadanie, a następnie sondować punkt końcowy stanu aż do jego zakończenia.

Uwierzytelnianie: użyj Authorization: Bearer <ulazai_api_key> lub Authorization: Token <token>.

🎵 Muzyka

POST /api/v1/music/generate/ Wymagane uwierzytelnienie

Wygeneruj ścieżkę muzyczną z prompt.

Treść żądania

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

Odpowiedź (201 utworzonych)

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

Koszt kredytu: 12 kredyty na żądanie.

DOBIERZ /api/v1/music/status/<music_id>/ Wymagane uwierzytelnienie

Ankieta dotycząca zakończenia pracy.

Odpowiedź (200 OK, zakończona)

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

🎙️ Voiceover

POST /api/v1/voiceover/generate/ Wymagane uwierzytelnienie

Konwertuj tekst na lektora.

Treść żądania (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)
}

Treść żądania (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."}
  ]
}

Koszt kredytu: na podstawie liczby znaków. Turbo 2,5: 12 kredytów za 1000 znaków. V3/Dialog: 14 kredytów za 1000 znaków.

DOBIERZ /api/v1/voiceover/status/<voiceover_id>/ Wymagane uwierzytelnienie

Ankieta o zakończenie i pobranie adresu URL dźwięku.

🔊 Efekty dźwiękowe

POST /api/v1/sound-effects/generate/ Wymagane uwierzytelnienie

Wygeneruj efekt dźwiękowy z prompt.

Treść żądania

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

Koszt kredytu: 0,24 kredyty/s (zaokrąglone w górę), minimalne 1 kredyt.

DOBIERZ /api/v1/sound-effects/status/<sfx_id>/ Wymagane uwierzytelnienie

Ankieta o zakończenie i pobranie adresu URL dźwięku.