Diseño de voz

Deprecated
Crea una voz a partir de un prompt de texto.

Encabezados

xi-api-keystringOpcional

Parámetros de consulta

output_formatenumOpcional
El formato de salida del audio generado.

Solicitud

This endpoint expects an object.
voice_descriptionstringRequerido20-1000 characters

Descripción que se utilizará para la voz creada.

textstring or nullOpcional100-1000 characters

Texto que se generará; su longitud debe estar entre 100 y 1000 caracteres.

auto_generate_textbooleanOpcionalValor predeterminado: false

Indica si se debe generar automáticamente un texto adecuado para la descripción de la voz.

loudnessdoubleOpcional-1-1Valor predeterminado: 0.5

Controla el nivel de volumen de la voz generada. -1 es el nivel más bajo, 1 el más alto y 0 corresponde aproximadamente a -24 LUFS.

qualitydoubleOpcional-1-1Valor predeterminado: 0.9

Una calidad más alta produce una mejor voz, pero con menos variedad.

seedinteger or nullOpcional0-2147483647

Número aleatorio que controla la generación de voz. La misma semilla con las mismas entradas produce la misma voz.

guidance_scaledoubleOpcional0-100Valor predeterminado: 5

Controla hasta qué punto la IA sigue el prompt. Los valores más bajos dan a la IA más libertad creativa, mientras que los más altos la obligan a ceñirse más al prompt. Los valores altos pueden hacer que la voz suene artificial o robótica. Recomendamos utilizar prompts más largos y detallados con una escala de orientación más baja.

should_enhancebooleanOpcionalValor predeterminado: false

Indica si se debe mejorar la descripción de la voz mediante IA para añadir más detalle y mejorar la calidad de generación de voz. Cuando está activado, el sistema ampliará automáticamente los prompts sencillos para convertirlos en descripciones de voz más detalladas. El valor predeterminado es False.

Respuesta

Respuesta correcta.
previewslist of objects
Las vistas previas de las voces generadas.
textstring
El texto utilizado para previsualizar las voces.

Errores

409
Conflict Error
422
Unprocessable Entity Error