Referencia de la API
Lista de voces
Obtener las voces disponibles para TTS
POST
/api/v1/voices/
Devuelve una lista de todas las voces que el usuario autenticado tiene permitido usar con la API de texto a voz.
Autenticación
Incluye tu clave de API en el encabezado Authorization como Bearer YOUR_API_KEY.
Cuerpo de la solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| language | opcional | string | Idioma de los nombres de voz y de los valores de las insignias, por ejemplo ar, fr o zh-hans (también se acepta como ?language= en la URL). Si una voz no tiene texto en ese idioma, se usa el inglés, igual que con un código ausente o no admitido. La cabecera de respuesta Content-Language indica el idioma usado. |
| engine | opcional | string | Tu clave API solo lista las voces de su propio tipo (estándar o avanzada, elegido al crear la clave). Si envías engine, debe coincidir con el tipo de la clave. |
Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| voice_id | entero | Identificador único de la voz |
| voice_name | string | Nombre visible de la voz |
| voice_sample_url | string | URL del archivo de audio de muestra de la voz |
| voice_fees | float | Costo por usar esta voz (0 significa gratis) |
| voice_badges | object | Metadatos adicionales de la voz, p. ej., idioma, género, edad, caso de uso |
| voice_engine | string | standard o advanced. Las voces del motor Estándar usan mode; las voces del motor Avanzado usan context, setting, style y pace. Consulta Motores y modos. |
Ejemplo
curl "https://moknah.io/api/v1/voices/" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.post(
"https://moknah.io/api/v1/voices/",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
voices = response.json()
for voice in voices:
print(voice["voice_name"], voice["voice_sample_url"])
const response = await fetch(
'https://moknah.io/api/v1/voices/',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const voices = await response.json();
console.log(voices);
Ejemplo de respuesta
[
{
"voice_id": 1328,
"voice_name": "Adnan",
"voice_sample_url": "https://storage.moknah.io/media/voice_samples/Adnan.mp3",
"voice_fees": 0.0,
"voice_badges": {
"language": "Arabic",
"gender": "Male",
"age": "Young Adult",
"use_case": "Documentary, Audiobook, Article",
},
"voice_engine": "standard"
}
]
Soporte de API
Para preguntas o problemas relacionados con la API, contáctanos en api@moknah.io.