Référence de l'API

Toutes les routes sont sous https://app.netaix.fr/v1 et demandent une clé (voir Authentification). Une description lisible par une machine est disponible : openapi.json.

GET /v1/models

Aucun paramètre. Rend la liste des niveaux Netaix puis celle des modèles que la clé peut appeler. Le détail de la réponse et la façon de l'utiliser sont dans Modèles et routage.

POST /v1/chat/completions

La route principale. Elle suit le format d'OpenAI pour la requête comme pour la réponse.

Paramètres

Les champs inconnus sont acceptés sans erreur, comme le fait l'API d'origine. La colonne « État » dit ce que la passerelle en fait réellement : un paramètre marqué « ignoré » est accepté mais n'a aucun effet, ce qu'il valait mieux écrire que laisser découvrir.

Réponse

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1793664000,
  "model": "mistral-large-latest",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 1240,
    "completion_tokens": 318,
    "total_tokens": 1558,
    "prompt_tokens_details": {"cached_tokens": 980},
    "cache_write_tokens": 0
  }
}

Le flux

Avec "stream": true, la réponse est un flux d'événements serveur (text/event-stream). Chaque ligne utile commence par data: et porte un objet chat.completion.chunk. Le flux se termine par data: [DONE].

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1793664000,"model":"gpt-4.1","choices":[{"index":0,"delta":{"role":"assistant","content":"Bon"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1793664001,"model":"gpt-4.1","choices":[{"index":0,"delta":{"content":"jour"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1793664002,"model":"gpt-4.1","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":18,"completion_tokens":2,"total_tokens":20,"prompt_tokens_details":{"cached_tokens":0},"cache_write_tokens":0}}

data: [DONE]

• Le premier fragment de texte porte delta.role. Les suivants ne portent que delta.content.
• Le dernier fragment porte finish_reason et le bloc usage, sans qu'il faille le demander.
• Quand une recherche web a servi, un fragment supplémentaire porte un champ search_results de premier niveau, avec delta vide. C'est la convention employée par les fournisseurs qui exposent leurs sources ; un client strict l'ignore.
• Une erreur survenue après le début du flux arrive sous la forme data: {"error": {...}}, suivie de data: [DONE]. Le code HTTP, lui, est déjà parti en 200 : votre code doit donc inspecter les fragments, pas seulement le statut.

Les outils

Envoyez vos définitions dans tools au format OpenAI. La passerelle fait un tour d'inférence et vous rend les tool_calls demandés par le modèle. Elle n'exécute pas vos outils : c'est votre code qui les exécute, puis renvoie le résultat dans un message de rôle tool au tour suivant. C'est le fonctionnement standard, en flux comme en bloc.

{
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": null,
      "tool_calls": [{
        "id": "call_...",
        "type": "function",
        "function": {"name": "chercher_facture",
                     "arguments": "{\"numero\": \"F-2026-114\"}"}
      }]
    },
    "finish_reason": "tool_calls"
  }]
}

POST /v1/messages

La même passerelle, au format de l'API d'Anthropic. Elle sert les clients écrits pour ce format, Claude Code et le SDK anthropic compris, usage agent inclus. Avec un SDK Anthropic, l'adresse de base est https://app.netaix.fr sans /v1 : le SDK ajoute le chemin lui-même.

Les deux routes sont servies par le même moteur : facturation, filtre des données sensibles, appels d'outils, comptage des jetons et comportement en cas d'erreur sont identiques sur /v1/chat/completions et ici. Le choix de la route est donc celui du format que parle votre client, pas celui des fonctionnalités disponibles.

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "content": [
    {"type": "text", "text": "Je lis le fichier."},
    {"type": "tool_use", "id": "toolu_...",
     "name": "read_file", "input": {"path": "a.txt"}}
  ],
  "model": "claude-sonnet-4-5",
  "stop_reason": "tool_use",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 1240,
    "output_tokens": 318,
    "cache_read_input_tokens": 980,
    "cache_creation_input_tokens": 0
  }
}

Le flux

Avec "stream": true, la réponse suit le protocole de flux d'Anthropic : chaque événement porte sa ligne event: puis sa ligne data:, ce qui permet à un SDK Anthropic de le lire sans adaptation.

message_start
ping
content_block_start        (un bloc text, ou un bloc tool_use)
content_block_delta        (text_delta, ou input_json_delta pour un outil)
content_block_stop
message_delta              (porte stop_reason, stop_sequence et usage)
message_stop

• message_start et ping sont émis avant le premier appel au modèle : ils ne sont pas du contenu.
• Les blocs sont indexés dans leur ordre d'apparition. Un appel d'outil émet ses arguments par fragments, en input_json_delta.
• Une erreur survenue pendant le flux arrive sous la forme d'un événement error, le code HTTP étant déjà parti en 200 : votre code doit inspecter les événements, pas seulement le statut.

POST /v1/messages/count_tokens

Rend une estimation du nombre de jetons d'entrée d'une requête /v1/messages. C'est la route qu'un client au format Anthropic appelle pour gérer sa fenêtre de contexte. Le corps est celui de /v1/messages ; max_tokens n'est pas nécessaire.

{"input_tokens": 1284}

• Le compte porte sur la consigne système, les messages, les arguments des appels d'outils rejoués et les définitions d'outils.
• C'est une estimation faite par la passerelle, pas le compte exact d'un fournisseur : aucun modèle n'est appelé. Utilisez-la comme un ordre de grandeur, pas comme une valeur de facturation. Le compte réel d'un appel est dans le bloc usage de sa réponse.
• L'appel n'est pas décompté en crédits. Il demande une clé et compte dans la limite de débit.

POST /v1/embeddings

Transforme du texte en vecteurs, au format d'OpenAI.

curl https://app.netaix.fr/v1/embeddings \
  -H "Authorization: Bearer $NETAIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": ["Première phrase.", "Deuxième phrase."]}'

{
  "object": "list",
  "model": "mistral-embed",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0123, -0.0456]},
    {"object": "embedding", "index": 1, "embedding": [0.0789, -0.0012]}
  ],
  "usage": {"prompt_tokens": 12, "total_tokens": 12}
}

POST /v1/moderations

Rend un verdict de modération sur un texte, au format d'OpenAI. Le champ input accepte une chaîne ou une liste de blocs.

{
  "id": "modr-...",
  "model": "omni-moderation-latest",
  "results": [{
    "flagged": false,
    "categories": {"violence": false, "hate": false},
    "category_scores": {"violence": 0.0002, "hate": 0.0001}
  }]
}

Cet appel n'est pas décompté en crédits. Il est compté dans le relevé de consommation de votre clé et soumis à la limite de débit, comme les autres routes.

La modération juge la nature du texte (violence, haine). Ce n'est pas le filtre des données sensibles, qui empêche une donnée confidentielle de sortir et s'applique, lui, aux quatre routes qui transmettent du texte : voir Filtre des données sensibles.

GET /v1/netaix/usage

La consommation et les plafonds de la clé qui appelle, sans session ni mot de passe. C'est la route à utiliser pour afficher une jauge dans votre propre interface, ou pour qu'un traitement automatique sache qu'il approche de son plafond avant de se faire refuser.

Aucun paramètre : l'identité vient de la clé, jamais de la requête. Une clé ne lit que sa propre consommation, jamais celle d'une autre clé ni celle de l'organisation.

{
  "object": "netaix.usage",
  "unite": "credits",
  "cle": {"prefixe": "...", "type": "personal_token"},
  "jour": {
    "debut": "2026-11-03T00:00:00Z",
    "consomme": 1240,
    "plafond": 5000,
    "restant": 3760,
    "part": 0.248,
    "alerte": false,
    "depasse": false
  },
  "cycle": {
    "debut": "2026-11-01T00:00:00Z",
    "consomme": 8120,
    "plafond": 20000,
    "restant": 11880,
    "part": 0.406,
    "alerte": false,
    "depasse": false
  },
  "verifie_a": "2026-11-03T09:14:22Z"
}

Cette route est limitée à 30 requêtes par minute, et non 60 comme les autres. Elle n'est pas décomptée en crédits. Elle ne répond que pour une clé d'API : une instance d'agent ou une application cliente, qui n'ont pas de plafond de clé, reçoivent un 400 avec le code usage_not_available_for_this_credential.