Sari la conținut
UlazAI

UlazAI documente pentru dezvoltatori

Generație audio API

Prețuri Bord Studio de imagine

API-ul Studioului de muzică

Suno API

Creează melodii și continuă să lucrezi la ele prin același API folosit de Studioul de muzică.

Deschide Studioul de muzică

Citește catalogul de operațiuni pentru modelele actuale, câmpurile obligatorii și prețurile în credite. Trimite un ID unic de cerere, astfel încât reîncercarea unei cereri să nu taxeze de două ori.

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/

Biblioteca ta include toate variantele returnate. Editarea creează un rezultat nou și păstrează originalul.

Generație audio API

Generați muzică, voce off și efecte sonore folosind credite UlazAI. Rezultatele sunt livrate asincron: trimiteți o lucrare, apoi interogați punctul final de stare până se finalizează.

Autentificare: utilizare Authorization: Bearer <ulazai_api_key> sau Authorization: Token <token>.

🎵 Muzică

POSTĂ /api/v1/music/generate/ Autentificare necesară

Generați o piesă muzicală dintr-un prompt.

Organismul de solicitare

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

Răspuns (201 create)

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

Costul creditului: 12 credite la cerere.

GET /api/v1/music/status/<music_id>/ Autentificare necesară

Sondaj pentru finalizarea jobului.

Răspuns (200 OK, finalizat)

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

🎙️ Voce off

POSTĂ /api/v1/voiceover/generate/ Autentificare necesară

Convertiți textul într-o voce off.

Organismul de solicitare (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)
}

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

Costul creditului: pe baza numărului de caractere. Turbo 2.5: 12 credite la 1.000 de caractere. V3/Dialog: 14 credite la 1.000 de caractere.

GET /api/v1/voiceover/status/<voiceover_id>/ Autentificare necesară

Interogați pentru finalizare și preluați adresa URL audio.

🔊 Efecte sonore

POSTĂ /api/v1/sound-effects/generate/ Autentificare necesară

Generați un efect sonor dintr-un prompt.

Organismul de solicitare

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

Costul creditului: 0,24 credite/sec (rotunjit în sus), minim 1 credit.

GET /api/v1/sound-effects/status/<sfx_id>/ Autentificare necesară

Interogați pentru finalizare și preluați adresa URL audio.