Documentación

Empieza con una llamada que funciona

Tres recetas. Cada una tiene entrada real, llamada, respuesta de ejemplo y el primer error que vas a ver.

Casos de uso

Ver si una frase es tóxica

Tienes texto de usuario y necesitas una señal de pasa/no pasa antes de mostrarlo.

Entrada

{
  "text": "This product is absolutely amazing"
}

Llamada

Comprobación de toxicidad · Llamada

curl -X POST https://api.brainiall.com/v1/nlp/toxicity \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"This product is absolutely amazing"}'

Respuesta de ejemplo

{
  "label": "not_toxic",
  "score": 0.001
}

El texto vacío se rechaza. Envía un campo text no vacío e inténtalo de nuevo.

Decir una frase

Tienes palabras y necesitas audio para reproducir o guardar.

Entrada

{
  "text": "Hello, welcome.",
  "voice": "brainiall-aria"
}

Llamada

Audio hablado · Llamada

curl -X POST https://api.brainiall.com/v1/tts/synthesize \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, welcome.","voice":"brainiall-aria"}' \
  --output speech.wav

Respuesta de ejemplo

{
  "content_type": "audio/wav",
  "note": "Binary audio. Save the body to speech.wav."
}

El texto vacío se rechaza. Envía un campo text no vacío. La voz debe ser un id del catálogo en GET /v1/tts/voices.

Puntuar una frase hablada

Alguien pronunció una frase. Necesitas una nota frente al texto de referencia.

Entrada

{
  "audio": "<base64-wav>",
  "text": "Hello world"
}

Llamada

Pronunciación · Llamada

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"}'

Respuesta de ejemplo

{
  "overallScore": 86,
  "sentenceScore": 84,
  "decodedTranscript": "Hello world",
  "words": [
    { "word": "Hello", "score": 90 },
    { "word": "world", "score": 82 }
  ]
}

Sin audio se rechaza. Envía audio en base64 en el campo audio y el texto de referencia.

Autenticación

Todas las llamadas usan el mismo encabezado. Sustituye el marcador por tu clave.

Authorization: Bearer YOUR_KEY

URL basehttps://api.brainiall.com

NLP Suite Endpoints

Detect toxic, offensive, or harmful content in text.

Ejemplo de código

curl -X POST https://api.brainiall.com/v1/nlp/toxicity \
 -H "Authorization: Bearer $BRAINIALL_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"text":"This product is absolutely amazing"}'

Siguiente: ejecuta esta llamada ahora

Comprobación de toxicidad

Haz tu primera llamada ahora

Comprueba si una frase es tóxica. Vuelven una etiqueta y una puntuación.

Una llamada de texto. El motor indica si la frase es tóxica.

Endpoint

POST /v1/nlp/toxicity

Solicitud

{
  "text": "This product is absolutely amazing"
}

Preparando tu clave de API…

Ejemplo de código

curl -X POST https://api.brainiall.com/v1/nlp/toxicity \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"This product is absolutely amazing"}'

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í.