Vai alla navigazione

Progettazione della voce

Deprecated
Crea una voce da un prompt di testo.

Header

xi-api-keystringOpzionale

Parametri di query

output_formatenumOpzionale
Il formato di output dell'audio generato.

Richiesta

This endpoint expects an object.
voice_descriptionstringObbligatorio20-1000 characters
Descrizione da usare per la voce creata.
textstring or nullOpzionale100-1000 characters

Testo da generare; la lunghezza deve essere compresa tra 100 e 1000 caratteri.

auto_generate_textbooleanOpzionalePredefinito a false
Indica se generare automaticamente un testo adatto alla descrizione della voce.
loudnessdoubleOpzionale-1-1Predefinito a 0.5

Controlla il livello del volume della voce generata. -1 è il più basso, 1 è il più alto, 0 corrisponde a circa -24 LUFS.

qualitydoubleOpzionale-1-1Predefinito a 0.9

Una qualità superiore migliora l'output vocale, ma riduce la varietà.

seedinteger or nullOpzionale0-2147483647
Numero casuale che controlla la generazione della voce. Lo stesso seed con gli stessi input produce la stessa voce.
guidance_scaledoubleOpzionale0-100Predefinito a 5

Controlla quanto fedelmente l'IA segue il prompt. Valori più bassi lasciano all'IA maggiore libertà creativa, mentre valori più alti la vincolano maggiormente al prompt. Valori alti possono far sembrare la voce artificiale o robotica. Ti consigliamo di usare prompt più lunghi e dettagliati con una Guidance Scale più bassa.

should_enhancebooleanOpzionalePredefinito a false

Indica se migliorare la descrizione della voce con l'IA per aggiungere dettagli e migliorare la qualità della generazione vocale. Se abilitata, il sistema espanderà automaticamente i prompt semplici in descrizioni della voce più dettagliate. Il valore predefinito è False

Risposta

Risposta riuscita
previewslist of objects
Le anteprime delle voci generate.
textstring
Il testo usato per l'anteprima delle voci.

Errori

409
Conflict Error
422
Unprocessable Entity Error