Vai al contenuto
UlazAI

Documenti per sviluppatori UlazAI

Generazione audio API

Prezzi Pannello di controllo Studio d'immagine

API dello Studio musicale

Suno API

Crea canzoni e continuale a lavorare con la stessa API usata dallo Studio musicale.

Apri lo Studio musicale

Consulta il catalogo delle operazioni per modelli attuali, campi obbligatori e prezzi in crediti. Invia un ID richiesta univoco: riprovare una richiesta non può addebitare due volte.

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/

La tua libreria include tutte le take restituite. La modifica crea un nuovo risultato e conserva l'originale.

Generazione audio API

Genera musica, voci fuori campo ed effetti sonori utilizzando i crediti UlazAI. I risultati vengono forniti in modo asincrono: inviare un lavoro, quindi eseguire il polling dell'endpoint di stato fino al completamento.

Autenticazione: utilizzare Authorization: Bearer <ulazai_api_key> o Authorization: Token <token>.

🎵 Musica

POST /api/v1/music/generate/ Autenticazione richiesta

Genera una traccia musicale da un prompt.

Richiedi corpo

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

Risposta (201 creati)

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

Costo del credito: 12 crediti per richiesta.

OTTIENI /api/v1/music/status/<music_id>/ Autenticazione richiesta

Sondaggio per il completamento del lavoro.

Risposta (200 OK, completato)

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

🎙️ Voce fuori campo

POST /api/v1/voiceover/generate/ Autenticazione richiesta

Converti il testo in una voce fuori campo.

Corpo della richiesta (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)
}

Richiedi corpo (dialogo)

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

Costo del credito: basato sul conteggio dei caratteri. Turbo2.5: 12 crediti per 1.000 caratteri. V3/Dialogo: 14 crediti per 1.000 caratteri.

OTTIENI /api/v1/voiceover/status/<voiceover_id>/ Autenticazione richiesta

Effettua il sondaggio per il completamento e recupera l'URL dell'audio.

🔊 Effetti sonori

POST /api/v1/sound-effects/generate/ Autenticazione richiesta

Genera un effetto sonoro da un prompt.

Richiedi corpo

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

Costo del credito: 0,24 crediti/sec (arrotondato per eccesso), minimo 1 credito.

OTTIENI /api/v1/sound-effects/status/<sfx_id>/ Autenticazione richiesta

Effettua il sondaggio per il completamento e recupera l'URL dell'audio.