Laya Model. Del contexto a la decisión.

1. Crear una clave y conectar

Inicia sesión, abre API Keys en los ajustes de tu cuenta y crea una clave. Mantén saldo suficiente y envía una solicitud POST a la URL siguiente. La ruta de la API no lleva prefijo de idioma, ni siquiera en las páginas traducidas.

Llama a la API desde el servidor de tu aplicación. Guarda la clave en la variable de entorno del servidor LAYA_API_KEY; no la incluyas en el navegador ni en repositorios públicos. La zona de pruebas utiliza tu sesión iniciada.

2. Elegir modelo y definir la solicitud

Establece model como english, multilingual o typed-decisions. Las tres opciones admiten preguntas choice, score y noul.

3. Enviar la primera solicitud

Configura LAYA_API_KEY con tu clave. El ejemplo analiza un mensaje con los tres tipos de pregunta. Ejecuta JavaScript en Node.js 18+ como archivo .mjs, o Python 3 con el módulo integrado urllib, sin instalar paquetes adicionales.

export LAYA_API_KEY="YOUR_API_KEY"

curl --fail-with-body --request POST 'https://thejevai.com/laya/v1/systemone' \
  --header "Authorization: Bearer $LAYA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "english",
  "state": "I was charged twice for my subscription. Please refund the extra payment today.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this request?",
      "criteria": {
        "billing": "Payments and refunds",
        "technical": "Bugs and outages"
      }
    },
    "priority": {
      "type": "score",
      "instructions": "How urgent is this request?",
      "criteria": [
        "Low",
        "Medium",
        "High"
      ]
    },
    "refund": {
      "type": "noul",
      "instructions": "Is the customer requesting a refund?",
      "criteria": {
        "true": "A refund is requested",
        "false": "No refund is requested"
      }
    }
  }
}'

4. Leer respuestas, uso y créditos

Comprueba el estado HTTP y code === 0 antes de usar el resultado. Las respuestas están en data.result; no es una respuesta de chat ni un flujo de texto.

Respuesta ilustrativa: las decisiones, los tokens y el tiempo varían según la solicitud.

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "model": "english",
      "answers": {
        "department": {
          "type": "choice",
          "choice": "billing",
          "probabilities": {
            "billing": 0.97,
            "technical": 0.03
          }
        },
        "priority": {
          "type": "score",
          "score": 1.8,
          "legend": {
            "0": "Low",
            "1": "Medium",
            "2": "High"
          }
        },
        "refund": {
          "type": "noul",
          "noul": 0.98
        }
      },
      "usage": {
        "input_tokens": 1200,
        "output_tokens": 0
      },
      "elapsedMs": 142
    },
    "creditsUsed": 2
  }
}

data.result.answers

Busca cada resultado por el ID de pregunta enviado. Lee choice, score o noul según el tipo; puede haber campos adicionales de probabilidades.

data.result.usage

input_tokens y output_tokens indican el uso medido de tokens. Consulta los créditos consumidos en data.creditsUsed.

data.result.elapsedMs

Tiempo de procesamiento en milisegundos. Es una medición, no una garantía de latencia.

data.creditsUsed

Créditos descontados por esta solicitud. Permite mostrar el coste real en tu aplicación.

Usa los formatos de solicitud y respuesta descritos aquí para integrar este endpoint. Si cambias a otro servicio de Laya, revisa su autenticación y estructura de respuesta y adapta tu cliente cuando sea necesario.

5. Prever límites y errores

400

JSON, modelo, contexto, tipo de pregunta o criterios inválidos. Corrige la solicitud antes de repetirla.

401

Falta autenticación o no es válida. Revisa la clave Bearer o inicia sesión.

402

Créditos insuficientes. Añade saldo suficiente y vuelve a intentarlo.

413

El cuerpo supera los 32 KiB. Acorta el contexto o divide la solicitud.

429

Solicitudes demasiado próximas. Espera el tiempo indicado en Retry-After.

502

La inferencia falló, agotó el tiempo o devolvió un resultado inválido. Revisa el mensaje antes de reintentar.

503

El servicio no está disponible. Inténtalo más tarde o contacta con soporte.

Lee el estado HTTP y message en los errores. No se admiten claves de idempotencia: repetir automáticamente tras un tiempo de espera del cliente puede generar otro cargo si la primera solicitud terminó. Confirma el resultado antes de repetir solicitudes de pago.