Instrumente muzică
Generează piese muzicale complete cu voci și versuri opționale. Toate joburile de muzică sunt asincrone: pornești cu generate_music, apoi interoghezi get_music_status până la finalizare.
#Modele muzicale disponibile și limite
Folosește get_models cu model_type=music pentru a lista modelele muzicale curente, costurile și capabilitățile. Platforma oferă în general aceste modele bazate pe Suno:
| Model | Descriere | Limită prompt (MCP) | Observații |
|---|---|---|---|
| V3.5 | Model de bază, calitate fiabilă | 400 caractere | |
| V4 | Calitate și viteză îmbunătățite | 400 caractere | |
| V4.5 | Mai rapid, versuri mai bune, mai multe opțiuni instrumentale | 400 caractere | |
| V4.5+ | Context mai mare, audio mai bun, mai rapid | 400 caractere | |
| V5 | Cel mai recent; cele mai bune voci și instrumentale, cel mai rapid | 400 caractere |
Parametri suportați:
- Prompt: Obligatoriu; max 400 caractere. Descrie muzica (stil, atmosferă, instrumente, tempo).
- Instrumental: Dacă true, generează doar instrumental (fără voci). Dacă false sau omis, generează muzică cu voci.
Sunt suportate doar prompt și instrumental; stilul, versurile, titlul și genul vocal nu sunt disponibile. Folosește get_models cu model_type=music pentru modelele și costurile curente.
#generate_music
Pornește o generare muzicală. Parametri suportați: doar prompt și instrumental.
Parametri:
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| prompt | string | Da | Descrierea muzicii; max 400 caractere. |
| instrumental | boolean | Nu | Dacă true, generează doar instrumental (fără voci). Implicit: false. |
Exemplu (cu voci):
{
"prompt": "Melodie pop veselă despre vară"
}
Exemplu (doar instrumental):
{
"prompt": "Muzică de fundal orchestrală epică",
"instrumental": true
}
Răspuns: Include generation_id, task_id, status (ex. pending) și adesea estimated_time_seconds și estimated_cost_credits. Interoghează cu get_music_status.
#get_music_status
Verifică statusul unei generări muzicale și obține URL-urile pieselor când e gata.
Parametri:
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| generation_id | string | Da | ID returnat de generate_music. |
Răspuns: Include status, progress și când e finalizat un array songs. Fiecare piesă are în general id, title, audio_url, image_url, duration, lyrics și style. De obicei primești mai multe variante de piesă per generare.
Model: Opțional. Când e omis, se folosește un model implicit (ex. V5). Folosește get_models cu model_type=music pentru a lista ID-urile modelelor curente și costurile.
Vezi Limitări pentru limite de rată și credite.