Prețuri Sign In

Înapoi la Kubeez

Instrumente muzică

Generează piese muzicale complete. Toate joburile de muzică sunt asincrone: apelezi generate_music, apoi interoghezi get_music_status până când status este completed (sau failed).

#Cum alegi: simplu vs avansat

Instrumentul generate_music are două moduri exclusive. Agentul trebuie să aleagă unul în funcție de ce cere utilizatorul.

Mod	Când îl folosești	Cum decide API-ul
Simplu	Idee rapidă într-un singur text: gen, atmosferă, instrumente. Fără titlu fix, tag-uri de stil, versuri sau gen vocal.	Nu seta `title` sau `style` (lasă-le goale). Oferă un `prompt` nevid (max 400 caractere).
Avansat (custom)	Utilizatorul vrea titlu, stil (gen/tag-uri), gen vocal (sau random), și fie descrierea cântecului fie versuri (nu ambele), opțional negative_tags (ce să evite).	Setează ambele `title` și `style` ca șiruri nevide. `vocal_gender` este obligatoriu (`m`, `f` sau `random`). Oferă exact unul dintre `song_description` sau `lyrics` când nu e instrumental (vezi mai jos).

Reguli:

Dacă ambele title și style sunt nevide → mod avansat (custom). prompt este ignorat pentru conținut; folosește song_description / lyrics.
Dacă este setat doar title sau doar style → invalid; fie ambele, fie niciunul.
Dacă nici titlu, nici stil nu sunt setate → mod simplu; prompt este obligatoriu.

Mod avansat — descriere vs versuri (cu voce):

Alege unul: setează song_description sau lyrics, niciodată ambele. Trimiterea ambelor este respinsă (nu se concatenează).
Varianta descriere: temă/atmosferă/instrucțiuni pentru model; lasă lyrics gol.
Varianta versuri: versuri complete de la utilizator; lasă song_description gol.

Mod avansat — instrumental: setează instrumental: true și oferă doar song_description; nu trimite lyrics.

Folosește get_models cu model_type=music pentru ID-uri de modele și costuri în credite.

#Modele

Valori model acceptate (simplu și avansat): V4, V4_5, V4_5PLUS, V5, V5_5. Dacă lipsește, se aplică implicit platforma (de obicei V5_5). Nu folosi variante precum V4_5ALL.

#generate_music

#Parametri mod simplu

Parametru	Tip	Obligatoriu	Descriere
`prompt`	string	Da	O singură descriere a muzicii; max 400 caractere.
`instrumental`	boolean	Nu	Dacă `true`, doar instrumental (fără voci). Implicit: `false`.
`model`	string	Nu	`V4`, `V4_5`, `V4_5PLUS`, `V5` sau `V5_5`.

Nu trimite title, style sau vocal_gender în modul simplu (lasă-le goale).

Exemplu — simplu, cu voci:

{
  "prompt": "Melodie pop veselă despre vară",
  "instrumental": false,
  "model": "V5_5"
}

Exemplu — simplu, instrumental:

{
  "prompt": "Muzică orchestrală epică de fundal",
  "instrumental": true
}

#Parametri mod avansat

Parametru	Tip	Obligatoriu	Descriere
`title`	string	Da	Titlul cântecului; max 80 caractere.
`style`	string	Da	Stil / gen / tag-uri; max 1000 caractere.
`vocal_gender`	string	Da	`m`, `f` sau `random` (aliasuri: `male`/`female`; `random` = provider alege). Pentru instrumental, tot obligatoriu în API dar nu se aplică vocii.
`song_description`	string	XOR cu `lyrics`	Despre ce este cântecul (temă, atmosferă). Max 5000 caractere. Omite dacă folosești `lyrics`.
`lyrics`	string	XOR cu `song_description`	Versuri complete dacă utilizatorul le-a dat. Max 5000 caractere. Omite dacă folosești `song_description`.
`instrumental`	boolean	Nu	Implicit `false`. Dacă `true`, cere doar `song_description`.
`negative_tags`	string	Nu	Stiluri sau elemente de evitat; max 200 caractere.
`style_weight`	number	Nu	Implicit 0.65 (ca în aplicația web).
`weirdness_constraint`	number	Nu	Implicit 0.65.
`audio_weight`	number	Nu	Implicit 0.65.
`model`	string	Nu	Același set ca la modul simplu.

Cerință de conținut (avansat, cu voce): exact unul dintre song_description sau lyrics trebuie să fie nevid (celălalt omis sau gol).

Exemplu — avansat doar cu descriere:

{
  "title": "Neon Midnight",
  "style": "synthwave, anii 80, bas de condus, nostalgic",
  "vocal_gender": "random",
  "song_description": "Un cântec despre condus prin oraș noaptea cu reflexii neon",
  "model": "V5_5"
}

Exemplu — avansat doar cu versuri:

{
  "title": "Morning Light",
  "style": "folk acustic, chitară blândă, cald",
  "vocal_gender": "f",
  "lyrics": "[Strofa 1] ... [Refren] ..."
}

Răspuns: Include generation_id, status (ex. pending), adesea estimated_time_seconds. Interoghează cu get_music_status.

#get_music_status

Verifică starea unei generări muzicale și obține URL-urile când este gata.

Parametri:

Parametru	Tip	Obligatoriu	Descriere
`generation_id`	string	Da	ID returnat de generate_music.

Răspuns: Include status, progress, iar la final un tablou songs. Fiecare piesă are de obicei id, title, audio_url, stream_url, cover_image_url, duration, lyrics, style.

Vezi Limitări pentru rate limits și credite.