Saltar al contenido principal
Escuelas de idiomas

Puntúa el sonido que el alumno acaba de fallar.

Las escuelas de idiomas necesitan que el alumno hable cada día. Un profesor no puede sentarse con cada alumno en cada fonema. La API devuelve una nota por sonido, por palabra y por frase para que el siguiente ejercicio sea obvio.

El problema en el aula de idiomas

Una nota sobre la frase entera

La tarea de habla vuelve como apto/no apto o una marca vaga de acento. El alumno no sabe qué sonido corregir, así que el siguiente intento es una conjetura.

Los evaluadores humanos no siguen el ritmo diario

Dos profesores no marcan la misma grabación igual. Tampoco pueden escuchar cada práctica diaria de una cohorte completa.

Una transcripción no es devolución

Texto a partir del habla escribe lo dicho. No dice al alumno qué tan cerca quedó cada sonido de la frase objetivo.

Lo que devuelve la API

Una nota en cada sonido

Notas de fono, palabra y frase en una escala 0–100. Colórealas en la lección. El reintento es la misma frase, no una nueva.

Comparable de un intento al siguiente

El mismo enunciado, puntuado igual, es lo que hace posible el hábito diario de hablar. El número tiene que significar lo mismo mañana.

El resto de la lección sigue en un producto

Una clave para pronunciación, voz a texto y síntesis. El curso no monta una segunda pila de audio para enviar el ejercicio.

Ejecútalo: puntúa la pronunciación

Esto es una llamada de pronunciación, no una etiqueta de texto. Sube un clip corto de la frase objetivo y lee las notas en esta página.

Resultado visible — notas por palabra, no una etiqueta de categoría
  1. Hello90
  2. world82
  3. overall86
{
  "overallScore": 86,
  "sentenceScore": 84,
  "decodedTranscript": "Hello world",
  "words": [
    { "word": "Hello", "score": 90 },
    { "word": "world", "score": 82 }
  ]
}

Respuesta de ejemplo de POST /v1/pronunciation/assess/base64. Ejecuta la misma llamada abajo con tu audio.

Pronunciación

Haz tu primera llamada ahora

Una primera llamada con puntuación. Las notas por palabra y por fonema aparecen en esta página.

El audio de ejemplo de la frase de referencia ya está cargado. Ejecuta la llamada o cambia el archivo.

Endpoint
POST /v1/pronunciation/assess/base64
Solicitud
{
  "audio": "<base64-wav>",
  "text": "Hello world"
}

El audio de ejemplo está cargado. Puedes sustituirlo por tu grabación de la frase de referencia.

Preparando tu clave de API…

Resultado de ejemplo

General86/100
Frase84/100

Hello world

Puntuación por fonema

Todos los fonemas de la frase

/h/HH94
/ɛ/EH88
/l/L91
/oʊ/OW87
/w/W86
/ɝ/ER78
/l/L84
/d/D80
Ejemplo de código
curl -X POST https://api.brainiall.com/v1/pronunciation/assess/base64 \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio":"<base64-wav>","text":"Hello world"}'
Colección lista para ejecutar
{
  "name": "Brainiall first call",
  "baseUrl": "https://api.brainiall.com",
  "authorization": "Bearer $BRAINIALL_API_KEY",
  "requests": [
    {
      "id": "pronunciation",
      "method": "POST",
      "path": "/v1/pronunciation/assess/base64",
      "url": "https://api.brainiall.com/v1/pronunciation/assess/base64",
      "body": {
        "audio": "UklGRmQBAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YUABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
        "text": "Hello world"
      }
    },
    {
      "id": "tts",
      "method": "POST",
      "path": "/v1/tts/synthesize",
      "url": "https://api.brainiall.com/v1/tts/synthesize",
      "body": {
        "text": "Hello, welcome.",
        "voice": "brainiall-aria"
      }
    },
    {
      "id": "nlp",
      "method": "POST",
      "path": "/v1/nlp/toxicity",
      "url": "https://api.brainiall.com/v1/nlp/toxicity",
      "body": {
        "text": "This product is absolutely amazing"
      }
    }
  ]
}

La misma petición, lista para pegar fuera de este navegador. Sustituye el marcador por tu clave — la clave nunca se muestra aquí.

Qué cambia para el alumno

Ve el sonido que falló

Una nota baja en un fonema es un ejercicio. Una cruz roja en toda la frase no lo es.

Repite el mismo día

El curso intenta formar un hábito de habla. El bucle es: decirlo, ver el sonido, decirlo otra vez.

El profesor revisa la clase, no cada archivo

Los sonidos que el grupo sigue fallando aparecen sin volver a escuchar cada grabación.

El número, con su fuente

PCC de fono 0.682 (premium) frente a 0.555 entre evaluadores humanos Publicado en la página del producto de pronunciación, con el conjunto de prueba y la línea base de acuerdo humano.

Puntúa tu propio audio

Crea una clave y ejecuta la misma llamada de pronunciación. La siguiente pantalla es este trabajo, no un endpoint genérico de etiqueta.

La siguiente pantalla es el mismo trabajo: una clave, luego esta llamada.

Brainiall para escuelas de idiomas — pronunciación puntuada por sonido | Brainiall