Vai alla navigazione
ElevenAPIMusic

Trasmetti in streaming la musica composta con una risposta dettagliata

Trasmette in streaming una canzone e i relativi metadati dettagliati tramite Server-Sent Events (SSE).

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
store_for_inpaintingbooleanOpzionalePredefinito a false
Indica se archiviare la canzone generata per l'inpainting.
with_timestampsbooleanOpzionalePredefinito a false
Indica se restituire i timestamp delle parole nella canzone generata.
with_waveform_visualbooleanOpzionalePredefinito a false
Indica se restituire la forma d'onda visiva della canzone generata.

Header di risposta

song-idstringOpzionale
Identificatore univoco della canzone generata

Risposta

Eventi inviati dal server per il piano di composizione, i metadati del brano, i chunk audio con timestamp delle parole e forma d'onda visiva opzionali, e il completamento.

Errori

422
Unprocessable Entity Error