Aller au contenu

API System One. Un seul endpoint.

Appelez les modèles System One via l’API System One pour classification, scoring et contrôles oui/non. Obtenez des choix, scores et probabilités structurés ; votre application contrôle chaque action.

HTTP + JSON · Authentification par clé API · Crédits prépayés

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

Commencer à appeler System One

  1. 1

    Créer une clé

    Créez une clé API dans la console et enregistrez-la dans l’environnement serveur. La clé complète n’est affichée qu’une fois.

  2. 2

    Envoyer une requête

    Copiez l’exemple cURL ou utilisez votre client HTTP. Aucune installation de SDK n’est requise.

  3. 3

    Voir l’usage

    Consultez le statut des requêtes, les débits de crédits et le solde restant dans la console.

Définissez SYSTEM_ONE_API_KEY sur votre serveur, puis envoyez la requête à l’endpoint ci-dessus. Les évaluations réussies consomment les crédits du compte.

Documentation de l’API

Trois primitives pour des décisions structurées

Envoyez le contexte en state et définissez les questions à évaluer. Combinez Choice, Score et Noul dans une requête ; chaque question est évaluée indépendamment sur le même state.

ÉTAT PARTAGÉ

“J’ai été facturé deux fois pour cette commande. Merci de rembourser le paiement en double.”
state.message
Exemple illustratif · pas une réponse en direct

Choice : sélectionner une option

Définissez un ensemble d’options. Obtenez l’option choisie, une probabilité par option et la confiance.

01
billingFacturation et remboursements
0.92
supportSupport technique
0.06
salesVentes
0.02
RÉPONSE D’EXEMPLEanswers.department.choice → "billing"
Choisir entre Choice, Score et Noul

Ces valeurs illustrent le format de réponse. Pour un vrai résultat, lancez vos entrées dans le Playground.

Essayer cet exemple en direct

Modèle de décision : comparer Clairic et le catalogue

Cette liste présente chaque modèle de décision appelable sur system-one.dev, dont Clairic. Chaque page indique les entrées lues, le nombre de questions par appel et le coût en crédits.

Jev

1×

TypeSafe Jev structured decisions.

  • 1 crédit par question par 4KB
  • Jusqu’à 32 questions · 64KB par requête
  • Entrées : texte et JSON
  • Plafonds passerelle : 64KB pour les modèles texte ; 13MB pour les modèles image. La limite de requête du modèle sélectionné ci-dessus peut être plus basse et inclut les images base64.
  • Choix : jusqu’à 255 options ; Score : 2–10 niveaux
  • IDs de question : jusqu’à 128 caractères
  • state peut être null ; instructions optionnelles et nullable. Les IDs de question ne peuvent pas être vides.

Page du modèle

Clef Flash

3×

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

  • 3 crédits par question par 4KB
  • Jusqu’à 32 questions · 13MB par requête
  • Entrées : texte, JSON et images (PNG, JPEG, WebP)
  • Images : jusqu’à 4 · 4MB chacune · 8MB au total
  • Plafonds passerelle : 64KB pour les modèles texte ; 13MB pour les modèles image. La limite de requête du modèle sélectionné ci-dessus peut être plus basse et inclut les images base64.
  • Choix : jusqu’à 255 options ; Score : 2–10 niveaux
  • IDs de question : jusqu’à 100 caractères
  • State ne peut pas être null. Chaque question nécessite des instructions string, object ou array non vides. IDs : A–Z, a–z, 0–9, _, ., -. Les criteria Score ne peuvent pas être null ; criteria Noul omises ou objet aux seules clés true/false. Champs de question supplémentaires non pris en charge.

Page du modèle

Clef

6×

Structured decisions for demanding classification and scoring.

  • 6 crédits par question par 4KB
  • Jusqu’à 32 questions · 13MB par requête
  • Entrées : texte, JSON et images (PNG, JPEG, WebP)
  • Images : jusqu’à 4 · 4MB chacune · 8MB au total
  • Plafonds passerelle : 64KB pour les modèles texte ; 13MB pour les modèles image. La limite de requête du modèle sélectionné ci-dessus peut être plus basse et inclut les images base64.
  • Choix : jusqu’à 255 options ; Score : 2–10 niveaux
  • IDs de question : jusqu’à 100 caractères
  • State ne peut pas être null. Chaque question nécessite des instructions string, object ou array non vides. IDs : A–Z, a–z, 0–9, _, ., -. Les criteria Score ne peuvent pas être null ; criteria Noul omises ou objet aux seules clés true/false. Champs de question supplémentaires non pris en charge.

Page du modèle

Clef Omni

4×

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

  • 4 crédits par question par 4KB
  • Jusqu’à 32 questions · 13MB par requête
  • Entrées : texte, JSON et images (PNG, JPEG, WebP)
  • Images : jusqu’à 4 · 4MB chacune · 8MB au total
  • Plafonds passerelle : 64KB pour les modèles texte ; 13MB pour les modèles image. La limite de requête du modèle sélectionné ci-dessus peut être plus basse et inclut les images base64.
  • Choix : jusqu’à 255 options ; Score : 2–10 niveaux
  • IDs de question : jusqu’à 100 caractères
  • State ne peut pas être null. Chaque question nécessite des instructions string, object ou array non vides. IDs : A–Z, a–z, 0–9, _, ., -. Les criteria Score ne peuvent pas être null ; criteria Noul omises ou objet aux seules clés true/false. Champs de question supplémentaires non pris en charge.

Page du modèle

Decider

1×

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

  • 1 crédit par question par 4KB
  • Jusqu’à 32 questions · 64KB par requête
  • Entrées : texte et JSON
  • Plafonds passerelle : 64KB pour les modèles texte ; 13MB pour les modèles image. La limite de requête du modèle sélectionné ci-dessus peut être plus basse et inclut les images base64.
  • Choix : jusqu’à 255 options ; Score : 2–10 niveaux
  • IDs de question : jusqu’à 128 caractères
  • state peut être null ; instructions optionnelles et nullable. Les IDs de question ne peuvent pas être vides.

Page du modèle

Clairic

2×

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

  • Fourni par: system-one.dev
  • 2 crédits par 4KB d’entrée
  • Le nombre de champs ne change pas le prix. L’entrée inclut state, spécifications de champs et images. La sortie n’est pas facturée.

Page du modèle

Les prix sont en crédits. L’usage de tokens est indicatif ; facturation par modèle, nombre de questions et blocs de 4 Ko.

Modèles et limites de requête

Évaluez jusqu’à 32 questions sur un state partagé. Modèles texte/JSON : 64 Ko par défaut. Les modèles image acceptent PNG, JPEG et WebP en ligne dans leurs limites publiées ; plafond passerelle 13 Mo. Capacités et limites : catalogue en direct.

GET /v1/models est public et renvoie les modèles publiés, prix et limites. L’inférence exige toujours une clé API plateforme.

Documentation de l’API

Tarification à l’usage en crédits

Les requêtes sont facturées selon le modèle, le nombre de questions et la taille d’entrée. Estimez le coût en crédits dans le Playground avant une évaluation.

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

Tarifs API

Utiliser le SDK TypeScript

Définissez des questions avec choice(), score() et booleanQuestion(). Connectez-vous avec la même clé API et obtenez des résultats typés dans votre application.

Explorer le SDK

Connecter le SDK à l’API hébergée

Envoyer votre première requête HTTP

Définissez SYSTEM_ONE_API_KEY sur votre serveur, puis envoyez la requête à l’endpoint ci-dessus. Les évaluations réussies consomment les crédits du compte.

Obtenir une clé API