---
title: "API System One. Um endpoint."
description: "Chame os modelos System One pela API System One para classificação, scoring e checagens sim/não. Receba escolhas, scores e probabilidades estruturados; sua aplicação controla cada ação."
canonical: "https://system-one.dev/pt-BR/api"
language: "pt-BR"
---

# API System One. Um endpoint.

Chame os modelos System One pela API System One para classificação, scoring e checagens sim/não. Receba escolhas, scores e probabilidades estruturados; sua aplicação controla cada ação.

HTTP + JSON · Autenticação por chave de API · Créditos pré-pagos

## Faça sua primeira requisição HTTP

Defina SYSTEM_ONE_API_KEY no servidor e envie a requisição ao endpoint acima. Avaliações bem-sucedidas usam créditos da conta.

```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"
        }
      }
    }
  }'
```
## Três primitivas para decisões estruturadas

Envie o contexto como state e defina as perguntas a avaliar. Combine Choice, Score e Noul em uma requisição; cada pergunta é avaliada de forma independente sobre o mesmo state.

[Escolha entre Choice, Score e Noul](https://docs.system-one.dev/pt-BR/docs/primitives)
## Choice: selecionar uma opção

Defina um conjunto de opções. Receba a opção escolhida, uma probabilidade por opção e a confiança.
## Score: avaliar conforme uma rubrica

Descreva níveis ordenados. Receba um score ponderado por probabilidade que pode cair entre eles, com a distribuição e a confiança.
## Noul: estimar uma probabilidade sim/não

Faça uma pergunta sim/não. Receba P(true) de 0 a 1 e escolha um limiar no código quando precisar de um booleano.
## Usar o SDK TypeScript

Defina perguntas com choice(), score() e booleanQuestion(). Conecte com a mesma chave de API e obtenha resultados tipados na aplicação.

[Conectar o SDK à API hospedada](https://docs.system-one.dev/pt-BR/docs/getting-started)
## Modelo de decisão: comparar Clairic e o catálogo

Esta lista mostra cada modelo de decisão que você pode chamar em system-one.dev, incluindo Clairic. Cada página indica entradas, perguntas por chamada e créditos.

### Jev

Fornecido por: system-one.dev

TypeSafe Jev structured decisions.

- Fornecido por: system-one.dev
- 1 crédito por pergunta por 4KB
- Até 32 perguntas · 64KB por requisição
- Entradas: texto e JSON
- Escolher um: até 255 opções; Score: 2–10 níveis
- Lançado em 2026-09-18

[Página do modelo](https://system-one.dev/pt-BR/models/jev)

### Clef Flash

Fornecido por: system-one.dev

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

- Fornecido por: system-one.dev
- 3 créditos por pergunta por 4KB
- Até 32 perguntas · 13MB por requisição
- Entradas: texto, JSON e imagens (PNG, JPEG, WebP)
- Imagens: até 4 · 4MB cada · 8MB no total
- Escolher um: até 255 opções; Score: 2–10 níveis
- Lançado em 2026-10-01

[Página do modelo](https://system-one.dev/pt-BR/models/clef-flash)

### Clef

Fornecido por: system-one.dev

Structured decisions for demanding classification and scoring.

- Fornecido por: system-one.dev
- 6 créditos por pergunta por 4KB
- Até 32 perguntas · 13MB por requisição
- Entradas: texto, JSON e imagens (PNG, JPEG, WebP)
- Imagens: até 4 · 4MB cada · 8MB no total
- Escolher um: até 255 opções; Score: 2–10 níveis
- Lançado em 2026-10-01

[Página do modelo](https://system-one.dev/pt-BR/models/clef)

### Clef Omni

Fornecido por: system-one.dev

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

- Fornecido por: system-one.dev
- 4 créditos por pergunta por 4KB
- Até 32 perguntas · 13MB por requisição
- Entradas: texto, JSON e imagens (PNG, JPEG, WebP)
- Imagens: até 4 · 4MB cada · 8MB no total
- Escolher um: até 255 opções; Score: 2–10 níveis
- Lançado em 2026-10-09

[Página do modelo](https://system-one.dev/pt-BR/models/clef-omni)

### Decider

Fornecido por: system-one.dev

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

- Fornecido por: system-one.dev
- 1 crédito por pergunta por 4KB
- Até 32 perguntas · 64KB por requisição
- Entradas: texto e JSON
- Escolher um: até 255 opções; Score: 2–10 níveis
- Lançado em 2026-10-07

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

### Clairic

Fornecido por: system-one.dev

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

- Fornecido por: system-one.dev
- 2 créditos por 4KB de entrada
- Entradas: texto, JSON e imagens (PNG, JPEG, WebP)
- Imagens: até 4 · 4MB cada · 8MB no total
- Lançado em 2026-10-19

[Página do modelo](https://system-one.dev/pt-BR/models/clairic)

Os preços são em créditos. O uso de tokens é só referência; a cobrança é por modelo, número de perguntas e blocos de 4 KB.


## Começar a chamar o System One

### Criar uma chave

Crie uma chave de API no console e salve-a no ambiente do servidor. A chave completa é exibida apenas uma vez.

### Enviar uma requisição

Copie o exemplo cURL ou use seu cliente HTTP. Não é necessário instalar o SDK.

### Revisar o uso

Veja o status das requisições, cobranças de créditos e saldo restante no console.

## 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/pt-BR/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/pt-BR)
- [Versioning and deprecation](https://docs.system-one.dev/pt-BR/docs/api/versioning)
- [Idempotência e novas tentativas](https://docs.system-one.dev/pt-BR/docs/api/idempotency)
- [Erros da API](https://docs.system-one.dev/pt-BR/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/pt-BR/sdk)
- [API reference](https://system-one.dev/pt-BR/api)
- [Models](https://system-one.dev/pt-BR/models)
- [Catálogo de modelos](https://docs.system-one.dev/pt-BR/docs/models)
- [Authentication](https://system-one.dev/pt-BR/auth.md)
- [Pricing](https://system-one.dev/pt-BR/pricing)
- [Cobrança de créditos](https://docs.system-one.dev/pt-BR/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/pt-BR/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/pt-BR/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/pt-BR/about)
- [Contact](https://system-one.dev/pt-BR/contact)
- [Playground samples](https://system-one.dev/pt-BR/demo)
- [Blog](https://system-one.dev/pt-BR/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)