Vai alla navigazione

Componi musica

Componi una canzone da un prompt o da un piano di composizione.

Header

xi-api-keystringOpzionale

Parametri di query

output_formatenumOpzionalePredefinito a auto

Formato di output dell'audio generato. Formattato come codec_sample_rate_bitrate. Usa "auto", il valore predefinito, per lasciare che l'API scelga il formato migliore per il modello selezionato: mp3_44100_128 per i modelli v1 e mp3_48000_192 per i modelli v2.

Richiesta

This endpoint expects an object.
promptstring or nullOpzionale<=4100 characters

Un semplice prompt di testo da cui generare una canzone. Non può essere usato insieme a composition_plan.

composition_planobject or nullOpzionale

Un piano di composizione dettagliato per guidare la generazione musicale. Non può essere usato insieme a prompt.

music_length_msinteger or nullOpzionale3000-600000

La durata del brano da generare in millisecondi. Utilizzata solo insieme a prompt. Deve essere compresa tra 3000 ms e 600000 ms. Facoltativo: se non specificata, il modello sceglierà una durata in base al prompt.

model_idenumOpzionalePredefinito a music_v1
Il modello da usare per la generazione.
Valori consentiti:
seedinteger or nullOpzionale0-2147483647

Seed casuale per inizializzare il processo di generazione musicale. Fornire lo stesso seed con gli stessi parametri può aiutare a ottenere risultati più coerenti, ma la riproducibilità esatta non è garantita e gli output possono cambiare con gli aggiornamenti del sistema. Non può essere utilizzato insieme a prompt.

force_instrumentalbooleanOpzionalePredefinito a false

Se true, garantisce che la canzone generata sia strumentale. Se false, la canzone potrebbe essere o non essere strumentale in base al prompt. Può essere usato solo con prompt.

finetune_idstring or nullOpzionale<=100 characters
L'ID del Finetune da usare per la generazione
respect_sections_durationsbooleanOpzionalePredefinito a true

Controlla quanto rigorosamente vengono rispettate le durate delle sezioni nel composition_plan. Viene usato solo con composition_plan e si applica solo a music_v1; per music_v2 e music_v2_5 le durate delle sezioni vengono sempre rispettate e questo parametro viene ignorato. Se è false per music_v1, il modello può modificare le durate delle singole sezioni per migliorare qualità e latenza, preservando la durata totale del brano indicata nel piano.

store_for_inpaintingbooleanOpzionalePredefinito a false
Indica se archiviare la canzone generata per l'inpainting.
sign_with_c2pabooleanOpzionalePredefinito a false
Indica se firmare la canzone generata con C2PA. Si applica solo ai file mp3.

Header di risposta

song-idstringOpzionale
Identificatore univoco della canzone generata

Risposta

Il file audio generato nel formato specificato

Errori

422
Unprocessable Entity Error