For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Crea un proyecto con Audio Native activado, inicia la conversión de forma opcional y devuelve el ID del proyecto y un fragmento de HTML insertable.
Encabezados
xi-api-keystringOpcional
Solicitud
This endpoint expects a multipart form containing an optional file.
namestringRequerido
Nombre del proyecto.
imagestring or nullOpcionalDeprecated
(Obsoleto) URL de la imagen utilizada en el reproductor. Si no se proporciona, se utiliza la imagen predeterminada configurada en los ajustes del reproductor.
authorstring or nullOpcional
Autor utilizado en el reproductor e insertado al inicio del artículo subido. Si no se proporciona, se utilizará el autor predeterminado configurado en los ajustes del reproductor.
titlestring or nullOpcional
Título utilizado en el reproductor e insertado al principio del artículo subido. Si no se proporciona, se utiliza el título predeterminado configurado en los ajustes del reproductor.
(Obsoleto) Indica si se utiliza el reproductor pequeño. Si no se proporciona, se utiliza el valor predeterminado configurado en los ajustes del reproductor.
text_colorstring or nullOpcional
Color de texto utilizado en el reproductor. Si no se proporciona, se usa el color de texto predeterminado configurado en los ajustes del reproductor.
background_colorstring or nullOpcional
Color de fondo utilizado en el reproductor. Si no se proporciona, se utilizará el color de fondo predeterminado configurado en los ajustes del reproductor.
(Obsoleto) Especifica durante cuántos minutos se mantiene la sesión tras recargar la página. Si no se proporciona, se utiliza la configuración de sesión predeterminada de los ajustes del reproductor.
voice_idstring or nullOpcional
ID de voz utilizado para locutar el contenido. Si no se proporciona, se usa el ID de voz predeterminado configurado en los ajustes del reproductor.
model_idstring or nullOpcional
ID del modelo TTS utilizado en el reproductor. Si no se proporciona, se utiliza el ID de modelo predeterminado configurado en los ajustes del reproductor.
filefileOpcional
Archivo de entrada txt o HTML que contiene el contenido del artículo. El HTML debe tener el siguiente formato: ‘<html><body><div><p>Tu contenido</p><h3>Más contenido</h3><p>Algo más de contenido</p></div></body></html>’
Indica si el proyecto se debe convertir automáticamente a audio.
apply_text_normalizationenum or nullOpcional
Este parámetro controla la normalización de texto con cuatro modos: 'auto', 'on', 'apply_english' y 'off'.
Cuando se establece en 'auto', el sistema decidirá automáticamente si aplicar la normalización de texto
(por ejemplo, escribir los números con letras). Con 'on', la normalización de texto se aplicará siempre, mientras que
con 'off' se omitirá. 'apply_english' funciona igual que 'on', pero asumirá que el texto está en inglés.
Valores permitidos:
pronunciation_dictionary_locatorslist of stringsOpcional
Una lista de localizadores de diccionarios de pronunciación (pronunciation_dictionary_id, version_id) codificada como una lista de cadenas JSON para aplicar los diccionarios de pronunciación al texto. Se requiere una lista de cadenas codificadas en JSON, ya que los proyectos pueden añadirse mediante formData en lugar de jsonBody. Para especificar varios diccionarios, usa varias líneas --form en tu curl, como --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"Vmd4Zor6fplcA7WrINey\",\"version_id\":\"hRPaxjlTdR7wFMhV4w0b\"}"' --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"JzWtcGQMJ6bnlWwyMo7e\",\"version_id\":\"lbmwxiLu4q6txYxgdZqn\"}"'.
Respuesta
Respuesta correcta.
project_idstring
El ID del proyecto de Audio Native creado.
convertingboolean
Indica si el proyecto se está convirtiendo actualmente.
html_snippetstring
El fragmento HTML para insertar el reproductor Audio Native.
Este parámetro controla la normalización de texto con cuatro modos: ‘auto’, ‘on’, ‘apply_english’ y ‘off’.
Cuando se establece en ‘auto’, el sistema decidirá automáticamente si aplicar la normalización de texto
(por ejemplo, escribir los números con letras). Con ‘on’, la normalización de texto se aplicará siempre, mientras que
con ‘off’ se omitirá. ‘apply_english’ funciona igual que ‘on’, pero asumirá que el texto está en inglés.
Una lista de localizadores de diccionarios de pronunciación (pronunciation_dictionary_id, version_id) codificada como una lista de cadenas JSON para aplicar los diccionarios de pronunciación al texto. Se requiere una lista de cadenas codificadas en JSON, ya que los proyectos pueden añadirse mediante formData en lugar de jsonBody. Para especificar varios diccionarios, usa varias líneas —form en tu curl, como —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“Vmd4Zor6fplcA7WrINey”,“version_id”:“hRPaxjlTdR7wFMhV4w0b”}”’ —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“JzWtcGQMJ6bnlWwyMo7e”,“version_id”:“lbmwxiLu4q6txYxgdZqn”}”’.
