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

# 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

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

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

[Choisir entre Choice, Score et Noul](https://docs.system-one.dev/fr/docs/primitives)
## Choice : sélectionner une option

Définissez un ensemble d’options. Obtenez l’option choisie, une probabilité par option et la confiance.
## Score : noter selon une grille

Décrivez des niveaux ordonnés. Obtenez un score pondéré par probabilités pouvant se situer entre eux, plus la distribution et la confiance.
## Noul : estimer une probabilité oui/non

Posez une question oui/non. Obtenez P(true) de 0 à 1, puis choisissez un seuil dans votre code si vous avez besoin d’un booléen.
## 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.

[Connecter le SDK à l’API hébergée](https://docs.system-one.dev/fr/docs/getting-started)
## 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

Fourni par: system-one.dev

TypeSafe Jev structured decisions.

- Fourni par: system-one.dev
- 1 crédit par question par 4KB
- Jusqu’à 32 questions · 64KB par requête
- Entrées : texte et JSON
- Choix : jusqu’à 255 options ; Score : 2–10 niveaux
- Publié le 2026-09-18

[Page du modèle](https://system-one.dev/fr/models/jev)

### Clef Flash

Fourni par: system-one.dev

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

- Fourni par: system-one.dev
- 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
- Choix : jusqu’à 255 options ; Score : 2–10 niveaux
- Publié le 2026-10-01

[Page du modèle](https://system-one.dev/fr/models/clef-flash)

### Clef

Fourni par: system-one.dev

Structured decisions for demanding classification and scoring.

- Fourni par: system-one.dev
- 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
- Choix : jusqu’à 255 options ; Score : 2–10 niveaux
- Publié le 2026-10-01

[Page du modèle](https://system-one.dev/fr/models/clef)

### Clef Omni

Fourni par: system-one.dev

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

- Fourni par: system-one.dev
- 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
- Choix : jusqu’à 255 options ; Score : 2–10 niveaux
- Publié le 2026-10-09

[Page du modèle](https://system-one.dev/fr/models/clef-omni)

### Decider

Fourni par: system-one.dev

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

- Fourni par: system-one.dev
- 1 crédit par question par 4KB
- Jusqu’à 32 questions · 64KB par requête
- Entrées : texte et JSON
- Choix : jusqu’à 255 options ; Score : 2–10 niveaux
- Publié le 2026-10-07

[Page du modèle](https://system-one.dev/fr/models/decider-v1-1)

### Clairic

Fourni par: system-one.dev

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

- Fourni par: system-one.dev
- 2 crédits par 4KB d’entrée
- Entrées : texte, JSON et images (PNG, JPEG, WebP)
- Images : jusqu’à 4 · 4MB chacune · 8MB au total
- Publié le 2026-10-19

[Page du modèle](https://system-one.dev/fr/models/clairic)

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


## Commencer à appeler System One

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

### Envoyer une requête

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

### Voir l’usage

Consultez le statut des requêtes, les débits de crédits et le solde restant dans la 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/fr/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/fr)
- [Versioning and deprecation](https://docs.system-one.dev/fr/docs/api/versioning)
- [Idempotence et nouvelles tentatives](https://docs.system-one.dev/fr/docs/api/idempotency)
- [Erreurs API](https://docs.system-one.dev/fr/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/fr/sdk)
- [API reference](https://system-one.dev/fr/api)
- [Models](https://system-one.dev/fr/models)
- [Catalogue de modèles](https://docs.system-one.dev/fr/docs/models)
- [Authentication](https://system-one.dev/fr/auth.md)
- [Pricing](https://system-one.dev/fr/pricing)
- [Facturation des crédits](https://docs.system-one.dev/fr/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/fr/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/fr/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/fr/about)
- [Contact](https://system-one.dev/fr/contact)
- [Playground samples](https://system-one.dev/fr/demo)
- [Blog](https://system-one.dev/fr/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)