---
title: "API System One. Un solo endpoint."
description: "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."
canonical: "https://system-one.dev/es/api"
language: "es"
---

# 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

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

```sh
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"
        }
      }
    }
  }'
```
## 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.

[Elige entre Choice, Score y Noul](https://docs.system-one.dev/es/docs/primitives)
## Choice: seleccionar una opción

Define un conjunto de opciones. Obtén la opción seleccionada, una probabilidad por opción y la confianza.
## Score: valorar según una rúbrica

Describe niveles ordenados. Obtén una puntuación ponderada por probabilidad que puede quedar entre ellos, con la distribución y la confianza.
## Noul: estimar una probabilidad sí/no

Haz una pregunta sí/no. Obtén P(true) de 0 a 1 y elige un umbral en tu código cuando necesites un booleano.
## 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.

[Conectar el SDK a la API alojada](https://docs.system-one.dev/es/docs/getting-started)
## 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

Proporcionado por: system-one.dev

TypeSafe Jev structured decisions.

- Proporcionado por: system-one.dev
- 1 crédito por pregunta por 4KB
- Hasta 32 preguntas · 64KB por solicitud
- Entradas: texto y JSON
- Elegir uno: hasta 255 opciones; Score: 2–10 niveles
- Publicado el 2026-09-18

[Página del modelo](https://system-one.dev/es/models/jev)

### Clef Flash

Proporcionado por: system-one.dev

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

- Proporcionado por: system-one.dev
- 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
- Elegir uno: hasta 255 opciones; Score: 2–10 niveles
- Publicado el 2026-10-01

[Página del modelo](https://system-one.dev/es/models/clef-flash)

### Clef

Proporcionado por: system-one.dev

Structured decisions for demanding classification and scoring.

- Proporcionado por: system-one.dev
- 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
- Elegir uno: hasta 255 opciones; Score: 2–10 niveles
- Publicado el 2026-10-01

[Página del modelo](https://system-one.dev/es/models/clef)

### Clef Omni

Proporcionado por: system-one.dev

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

- Proporcionado por: system-one.dev
- 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
- Elegir uno: hasta 255 opciones; Score: 2–10 niveles
- Publicado el 2026-10-09

[Página del modelo](https://system-one.dev/es/models/clef-omni)

### Decider

Proporcionado por: system-one.dev

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

- Proporcionado por: system-one.dev
- 1 crédito por pregunta por 4KB
- Hasta 32 preguntas · 64KB por solicitud
- Entradas: texto y JSON
- Elegir uno: hasta 255 opciones; Score: 2–10 niveles
- Publicado el 2026-10-07

[Página del modelo](https://system-one.dev/es/models/decider-v1-1)

### Clairic

Proporcionado por: system-one.dev

Extract typed values with confidence and p_null from text and images.

- Proporcionado por: system-one.dev
- 2 créditos por 4KB de entrada
- Entradas: texto, JSON e imágenes (PNG, JPEG, WebP)
- Imágenes: hasta 4 · 4MB cada una · 8MB en total
- Publicado el 2026-10-19

[Página del modelo](https://system-one.dev/es/models/clairic)

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.


## Empezar a llamar a System One

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

### Enviar una petición

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

### Revisar el uso

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

## Authentication

Sign in or create an account, complete any required email verification, then open API keys and create a named key. The complete key is displayed once. Copy it into your server environment or secret manager. The website Playground uses the signed-in session; external applications use the platform key.

[Authentication](https://system-one.dev/es/auth.md)
## Failure and retry accounting

Credits are reserved before inference and returned on a recorded failed inference. A successful replay using the same Idempotency-Key and body incurs no new inference or debit while its replay record remains available. Different input with the same key is rejected. After a timeout or uncertain result, check recorded usage before retrying and preserve the key. Reconciliation can be pending; do not assume a refund until the recorded outcome confirms it.

## Start here

- [Developer documentation](https://docs.system-one.dev/es)
- [Versioning and deprecation](https://docs.system-one.dev/es/docs/api/versioning)
- [Idempotencia y reintentos](https://docs.system-one.dev/es/docs/api/idempotency)
- [Errores de la API](https://docs.system-one.dev/es/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/es/sdk)
- [API reference](https://system-one.dev/es/api)
- [Models](https://system-one.dev/es/models)
- [Catálogo de modelos](https://docs.system-one.dev/es/docs/models)
- [Authentication](https://system-one.dev/es/auth.md)
- [Pricing](https://system-one.dev/es/pricing)
- [Facturación de créditos](https://docs.system-one.dev/es/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/es/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/es/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/es/about)
- [Contact](https://system-one.dev/es/contact)
- [Playground samples](https://system-one.dev/es/demo)
- [Blog](https://system-one.dev/es/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)