Moknah Documentación
Empieza gratis
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.