Saltar al contenido

API System One. Un solo endpoint.

Llama a los modelos System One por la API System One para clasificación, puntuación y comprobaciones sí/no. Obtén opciones, puntuaciones y probabilidades estructuradas; tu aplicación controla cada acción.

HTTP + JSON · Autenticación con clave API · Créditos prepagos

https://system-one.dev/v1
cURL · POST /v1/systemone
curl 'https://system-one.dev/v1/systemone' \  -H "Authorization: Bearer $SYSTEM_ONE_API_KEY" \  -H 'Content-Type: application/json' \  --data '{    "state": { "message": "I was charged twice." },    "questions": {      "team": {        "type": "choice",        "instructions": "Who should handle this?",        "criteria": {          "billing": "Payments and refunds",          "support": "Technical issues"        }      }    }  }'

Empezar a llamar a System One

  1. 1

    Crear una clave

    Crea una clave API en la consola y guárdala en el entorno del servidor. La clave completa se muestra una sola vez.

  2. 2

    Enviar una petición

    Copia el ejemplo cURL o usa tu cliente HTTP. No hace falta instalar el SDK.

  3. 3

    Revisar el uso

    Revisa el estado de las peticiones, los cargos de créditos y el saldo restante en la consola.

Configura SYSTEM_ONE_API_KEY en tu servidor y envía la petición al endpoint de arriba. Las evaluaciones correctas usan créditos de tu cuenta.

Documentación de la API

Tres primitivas para decisiones estructuradas

Envía el contexto como state y define las preguntas a evaluar. Combina Choice, Score y Noul en una petición; cada pregunta se evalúa de forma independiente sobre el mismo state.

ESTADO COMPARTIDO

“Me cobraron dos veces por este pedido. Por favor, reembolsen el pago duplicado.”
state.message
Ejemplo ilustrativo · no es una respuesta en vivo

Choice: seleccionar una opción

Define un conjunto de opciones. Obtén la opción seleccionada, una probabilidad por opción y la confianza.

01
billingFacturación y reembolsos
0.92
supportSoporte técnico
0.06
salesVentas
0.02
RESPUESTA DE EJEMPLOanswers.department.choice → "billing"
Elige entre Choice, Score y Noul

Estos valores ilustran el formato de respuesta. Para un resultado real, ejecuta tus entradas en el Playground.

Probar este ejemplo en vivo

Modelo de decisión: comparar Clairic y el catálogo

Esta lista muestra cada modelo de decisión que puedes llamar en system-one.dev, incluido Clairic. Cada página indica entradas, preguntas por llamada y créditos.

Jev

1×

TypeSafe Jev structured decisions.

  • 1 crédito por pregunta por 4KB
  • Hasta 32 preguntas · 64KB por solicitud
  • Entradas: texto y JSON
  • Topes de puerta de enlace: 64KB para modelos solo texto; 13MB para modelos con imagen. El límite de petición del modelo seleccionado arriba puede ser menor e incluye imágenes base64.
  • Elegir uno: hasta 255 opciones; Score: 2–10 niveles
  • IDs de pregunta: hasta 128 caracteres
  • state puede ser null; instructions opcionales y nullable. Los IDs de pregunta no pueden estar en blanco.

Página del modelo

Clef Flash

3×

Structured classification and routing for high-volume, cost-sensitive work.

  • 3 créditos por pregunta por 4KB
  • Hasta 32 preguntas · 13MB por solicitud
  • Entradas: texto, JSON e imágenes (PNG, JPEG, WebP)
  • Imágenes: hasta 4 · 4MB cada una · 8MB en total
  • Topes de puerta de enlace: 64KB para modelos solo texto; 13MB para modelos con imagen. El límite de petición del modelo seleccionado arriba puede ser menor e incluye imágenes base64.
  • Elegir uno: hasta 255 opciones; Score: 2–10 niveles
  • IDs de pregunta: hasta 100 caracteres
  • State no puede ser null. Cada pregunta necesita instrucciones string, object o array no vacías. IDs: A–Z, a–z, 0–9, _, ., -. Los criteria de Score no pueden ser null; los de Noul se omiten o son un objeto solo con claves true/false. No se admiten campos de pregunta adicionales.

Página del modelo

Clef

6×

Structured decisions for demanding classification and scoring.

  • 6 créditos por pregunta por 4KB
  • Hasta 32 preguntas · 13MB por solicitud
  • Entradas: texto, JSON e imágenes (PNG, JPEG, WebP)
  • Imágenes: hasta 4 · 4MB cada una · 8MB en total
  • Topes de puerta de enlace: 64KB para modelos solo texto; 13MB para modelos con imagen. El límite de petición del modelo seleccionado arriba puede ser menor e incluye imágenes base64.
  • Elegir uno: hasta 255 opciones; Score: 2–10 niveles
  • IDs de pregunta: hasta 100 caracteres
  • State no puede ser null. Cada pregunta necesita instrucciones string, object o array no vacías. IDs: A–Z, a–z, 0–9, _, ., -. Los criteria de Score no pueden ser null; los de Noul se omiten o son un objeto solo con claves true/false. No se admiten campos de pregunta adicionales.

Página del modelo

Clef Omni

4×

Text, JSON, and image decisions for classification, routing, and scoring.

  • 4 créditos por pregunta por 4KB
  • Hasta 32 preguntas · 13MB por solicitud
  • Entradas: texto, JSON e imágenes (PNG, JPEG, WebP)
  • Imágenes: hasta 4 · 4MB cada una · 8MB en total
  • Topes de puerta de enlace: 64KB para modelos solo texto; 13MB para modelos con imagen. El límite de petición del modelo seleccionado arriba puede ser menor e incluye imágenes base64.
  • Elegir uno: hasta 255 opciones; Score: 2–10 niveles
  • IDs de pregunta: hasta 100 caracteres
  • State no puede ser null. Cada pregunta necesita instrucciones string, object o array no vacías. IDs: A–Z, a–z, 0–9, _, ., -. Los criteria de Score no pueden ser null; los de Noul se omiten o son un objeto solo con claves true/false. No se admiten campos de pregunta adicionales.

Página del modelo

Decider

1×

Text and JSON decisions for classification, routing, and scoring.

  • 1 crédito por pregunta por 4KB
  • Hasta 32 preguntas · 64KB por solicitud
  • Entradas: texto y JSON
  • Topes de puerta de enlace: 64KB para modelos solo texto; 13MB para modelos con imagen. El límite de petición del modelo seleccionado arriba puede ser menor e incluye imágenes base64.
  • Elegir uno: hasta 255 opciones; Score: 2–10 niveles
  • IDs de pregunta: hasta 128 caracteres
  • state puede ser null; instructions opcionales y nullable. Los IDs de pregunta no pueden estar en blanco.

Página del modelo

Clairic

2×

An extraction model that returns typed values from text, JSON and images.

  • Proporcionado por: system-one.dev
  • 2 créditos por 4KB de entrada
  • El número de campos no cambia el precio. La entrada incluye state, especificaciones de campos e imágenes. La salida no se cobra.

Página del modelo

Los precios están en créditos. El uso de tokens es solo referencia; se cobra por modelo, número de preguntas y bloques de 4 KB.

Modelos y límites de solicitud

Evalúa hasta 32 preguntas sobre un state compartido. Modelos de texto y JSON: 64 KB por defecto. Los modelos con imagen aceptan PNG, JPEG y WebP en línea dentro de sus límites publicados; tope de puerta de enlace 13 MB. Capacidades y límites: catálogo en vivo.

GET /v1/models es público y devuelve modelos publicados, precios y límites. La inferencia sigue requiriendo una clave API de plataforma.

Documentación de la API

Precios de créditos por uso

Las peticiones se cobran por modelo, número de preguntas y tamaño de entrada. Estima el coste en créditos en el Playground antes de evaluar.

questions × max(1, ⌈request bytes / model block size⌉) × model rate

Precios de la API

Usar el SDK TypeScript

Define preguntas con choice(), score() y booleanQuestion(). Conéctate con la misma clave API y obtén resultados tipados en tu aplicación.

Explorar el SDK

Conectar el SDK a la API alojada

Haz tu primera petición HTTP

Configura SYSTEM_ONE_API_KEY en tu servidor y envía la petición al endpoint de arriba. Las evaluaciones correctas usan créditos de tu cuenta.

Obtener una clave API