Ir para o conteúdo
System One

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.

Obter uma chave de APIExemplos do Playground

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

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"        }      }    }  }'

Começar a chamar o System One

  1. 1

    Criar uma chave

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

  2. 2

    Enviar uma requisição

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

  3. 3

    Revisar o uso

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

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

Documentação da API

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.

ESTADO COMPARTILHADO

“Fui cobrado duas vezes neste pedido. Por favor, reembolse o pagamento duplicado.”
state.message
Exemplo ilustrativo · não é uma resposta ao vivo

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.

01
billingCobrança e reembolsos
0.92
supportSuporte técnico
0.06
salesVendas
0.02
RESPOSTA DE EXEMPLOanswers.department.choice → "billing"
Escolha entre Choice, Score e Noul

Esses valores ilustram o formato da resposta. Para um resultado real, rode suas entradas no Playground.

Experimentar este exemplo ao vivo

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

1×

TypeSafe Jev structured decisions.

  • 1 crédito por pergunta por 4KB
  • Até 32 perguntas · 64KB por requisição
  • Entradas: texto e JSON
  • Tetos do gateway: 64KB para modelos só texto; 13MB para modelos com imagem. O limite de requisição do modelo selecionado acima pode ser menor e inclui imagens base64.
  • Escolher um: até 255 opções; Score: 2–10 níveis
  • IDs de pergunta: até 128 caracteres
  • state pode ser null; instructions opcionais e nullable. IDs de pergunta não podem ficar em branco.

Página do modelo

Clef Flash

3×

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

  • 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
  • Tetos do gateway: 64KB para modelos só texto; 13MB para modelos com imagem. O limite de requisição do modelo selecionado acima pode ser menor e inclui imagens base64.
  • Escolher um: até 255 opções; Score: 2–10 níveis
  • IDs de pergunta: até 100 caracteres
  • State não pode ser null. Cada pergunta precisa de instruções string, object ou array não vazias. IDs: A–Z, a–z, 0–9, _, ., -. Criteria de Score não podem ser null; de Noul omitidas ou objeto só com chaves true/false. Campos extras de pergunta não são suportados.

Página do modelo

Clef

6×

Structured decisions for demanding classification and scoring.

  • 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
  • Tetos do gateway: 64KB para modelos só texto; 13MB para modelos com imagem. O limite de requisição do modelo selecionado acima pode ser menor e inclui imagens base64.
  • Escolher um: até 255 opções; Score: 2–10 níveis
  • IDs de pergunta: até 100 caracteres
  • State não pode ser null. Cada pergunta precisa de instruções string, object ou array não vazias. IDs: A–Z, a–z, 0–9, _, ., -. Criteria de Score não podem ser null; de Noul omitidas ou objeto só com chaves true/false. Campos extras de pergunta não são suportados.

Página do modelo

Clef Omni

4×

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

  • 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
  • Tetos do gateway: 64KB para modelos só texto; 13MB para modelos com imagem. O limite de requisição do modelo selecionado acima pode ser menor e inclui imagens base64.
  • Escolher um: até 255 opções; Score: 2–10 níveis
  • IDs de pergunta: até 100 caracteres
  • State não pode ser null. Cada pergunta precisa de instruções string, object ou array não vazias. IDs: A–Z, a–z, 0–9, _, ., -. Criteria de Score não podem ser null; de Noul omitidas ou objeto só com chaves true/false. Campos extras de pergunta não são suportados.

Página do modelo

Decider

1×

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

  • 1 crédito por pergunta por 4KB
  • Até 32 perguntas · 64KB por requisição
  • Entradas: texto e JSON
  • Tetos do gateway: 64KB para modelos só texto; 13MB para modelos com imagem. O limite de requisição do modelo selecionado acima pode ser menor e inclui imagens base64.
  • Escolher um: até 255 opções; Score: 2–10 níveis
  • IDs de pergunta: até 128 caracteres
  • state pode ser null; instructions opcionais e nullable. IDs de pergunta não podem ficar em branco.

Página do modelo

Clairic

2×

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

  • Fornecido por: system-one.dev
  • 2 créditos por 4KB de entrada
  • A quantidade de campos não altera o preço. A entrada inclui state, especificações de campos e imagens. A saída não é cobrada.

Página do modelo

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.

Modelos e limites de requisição

Avalie até 32 perguntas sobre um state compartilhado. Modelos de texto e JSON: 64 KB por padrão. Modelos com imagem aceitam PNG, JPEG e WebP embutidos dentro dos limites publicados; teto do gateway 13 MB. Capacidades e limites: catálogo ao vivo.

GET /v1/models é público e retorna modelos publicados, preços e limites. A inferência ainda exige uma chave de API da plataforma.

Documentação da API

Idempotência e novas tentativasErros da APIVersões e mudanças da API

Preços de créditos por uso

As requisições são cobradas por modelo, número de perguntas e tamanho da entrada. Estime o custo em créditos no Playground antes de avaliar.

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

Preços da API

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.

Explorar o SDK

Conectar o SDK à API hospedada

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.

Obter uma chave de API