API TypeSafe

Endpoint HTTP de evaluación

El cuerpo de la solicitud tiene tres campos de nivel superior. state es obligatorio y puede ser una cadena, un objeto o un arreglo de texto. model también es obligatorio; los ejemplos de la documentación usan jev-latest. questions es un mapa de objetos Question tipados. Tú eliges cada clave y la respuesta correspondiente se devuelve con el mismo ID. La clave no se envía al modelo subyacente ni se usa durante la inferencia.

Un Noul mínimo tiene este aspecto: {"state": "¡Ayuda! Mis pagos llevan 3 días fallando.", "model": "jev-latest", "questions": {"is_urgent": {"type": "noul", "instructions": "¿Esto transmite urgencia?"}}}. Choice añade un mapa de criterios que asocia cada nombre de opción con una descripción. Score añade un arreglo ordenado de criterios por niveles. Los tres comparten type e instructions; cada uno incorpora su propia estructura de criteria.

Obtén una clave API en https://console.typesafe.ai/settings/keys. Si llamas directamente por HTTP, gestiona los errores 429 mediante retry-after. Los límites de Jev 1.13 son 250,000 tokens por segundo y 1,200 solicitudes por minuto, y pueden cambiar sin previo aviso. Los SDK reintentan con espera incremental de forma predeterminada. Para enumerar los modelos, usa GET /v1/models con el mismo token Bearer.

SDK oficiales

Python: pip install typesafe-sdk. Importa TypeSafeClient desde typesafe_sdk. Usa TypeSafeClient() como cliente: client.system_one(state, questions). Los constructores como Noul, Choice y Score están incluidos en el paquete, para que no tengas que escribir a mano el campo «type» del JSON. El modelo predeterminado es jev-latest. Se requiere Python 3.10 o posterior.

JavaScript: npm install @typesafe-ai/sdk. Importa { TypeSafeClient } desde "@typesafe-ai/sdk". El cliente se comunica con el mismo endpoint. El entorno de ejecución es Node.js 20+. El repositorio es https://github.com/typesafe-ai/typesafe-sdk-js.. Ambos SDK ofrecen models.list() para consultar el catálogo de alias.

El entorno de pruebas de https://console.typesafe.ai/playground es una consola que requiere iniciar sesión, no un módulo público incrustable. Pega texto como state, añade un Noul como «¿Este mensaje expresa urgencia?» y combina más preguntas en una sola llamada. Es la forma más rápida de probar la evaluación en paralelo antes de configurar las claves de producción.

Primera solicitud con curl

Ejecuta curl -X POST https://api.typesafe.ai/v1/systemone con Authorization: Bearer $TYPESAFE_API_KEY y Content-Type: application/json. Cuerpo: state con un mensaje de fallo de Stripe Connect, model jev-latest y questions.urgency con type noul e instructions «¿Este mensaje expresa urgencia?». Ese es el ejemplo de inicio rápido. Sin una segunda ida y vuelta, añade un Choice llamado department con criterios billing / technical / sales y un Score llamado frustration con niveles ordenados.

Cuando algo falle, consulta jaggedness antes de añadir más texto a las instrucciones. La lectura literal exige que la condición exacta figure en las instrucciones y los criterios. Los cálculos deben hacerse en código. La generación requiere otro modelo. La API seguirá devolviendo una carga tipada si pides a Jev que escriba un párrafo mediante Choice encadenados, pero será lento y dará malos resultados. Usa expresiones regulares o un modelo generativo para proponer opciones y deja que Jev elija.

Cloudflare Workers AI muestra typesafe/jev como nombre de catálogo. Es una publicación de un tercero, no un sustituto de api.typesafe.ai. Steam no tiene ninguna aplicación de Jev. Conserva las claves en la consola de TypeSafe y considera no oficiales los SDK comunitarios de Awesome Jev, salvo que sigan la organización github.com/typesafe-ai.

Errores, reintentos e ID

429 Too Many Requests es la respuesta documentada cuando superas el límite de tokens por segundo o de solicitudes por minuto. Respeta retry-after. Los SDK oficiales ya aplican espera incremental. Si implementas tu propio cliente HTTP, no satures el endpoint tras un 429: seguirás dentro de la misma ventana de limitación.

Los ID de las preguntas sirven para tus trazas y nunca intervienen en la inferencia. Puedes generar desde item_0 hasta item_n en un bucle y seguir recibiendo un Noul por cada uno. Las claves deben ser únicas dentro de cada solicitud. Si reutilizas una, la pregunta anterior del mapa se sobrescribe sin aviso.

La autorización utiliza una clave API Bearer de TypeSafe obtenida en el panel. api.typesafe.ai no usa sesiones con cookies. Rota las claves desde la consola, no enviando un correo a esta wiki. La pantalla de inicio de sesión del entorno de pruebas es independiente: se trata de una consola web, no de otra API HTTP.

Copia una vez el curl de inicio rápido y después elimínalo de tu repositorio para usar el SDK. El SDK gestiona los reintentos y los constructores tipados. El acceso HTTP directo está destinado a lenguajes sin cliente oficial. Ambas opciones envían claves Bearer y el mismo cuerpo JSON a POST /v1/systemone.

GET /v1/models enumera los alias que puede enviar tu cuenta. Es posible que omita jev-1.13.0 aunque ese ID funcione en POST /v1/systemone. No interpretes la lista como los ID versionados permitidos. Trátala como un catálogo de alias y conserva el ID versionado en tu propia configuración.

Nunca confirmes TYPESAFE_API_KEY en el repositorio. Si se filtra, rótala desde el panel. contact@jevai.wiki no es el buzón adecuado para comunicar un secreto filtrado: usa los canales propios de TypeSafe.

Python 3.10 y Node.js 20 son las versiones mínimas documentadas. Los entornos anteriores no son compatibles con los clientes oficiales.