Intégrations

La règle commune

Tout outil qui sait parler à une API « compatible OpenAI » fonctionne avec deux réglages, et deux seulement :

Adresse de base (base URL) : https://app.netaix.fr/v1
Clé d'API                   : VOTRE_CLE_NETAIX
Modèle                      : netaix-auto, ou un identifiant du catalogue

ANTHROPIC_BASE_URL = https://app.netaix.fr
ANTHROPIC_API_KEY  = VOTRE_CLE_NETAIX
ANTHROPIC_MODEL    = netaix-powerful, ou un identifiant du catalogue

Deux points à vérifier dans l'outil que vous configurez :

• La présence du /v1. Certains outils l'ajoutent eux-mêmes, d'autres non. Un 404 ou un 401 au premier appel vient presque toujours de là.
• La liste des modèles. Beaucoup d'outils la récupèrent par GET /v1/models et vous laissent choisir. Si l'outil exige un nom écrit à la main, netaix-auto est le choix le plus sûr.

Continue, dans VS Code

Installez l'extension Continue, ouvrez ~/.continue/config.yaml depuis l'engrenage du panneau Continue, puis remplacez son contenu par :

name: Netaix
version: 1.0.0
schema: v1
models:
  - name: Netaix - équilibré
    provider: openai
    model: netaix-balanced
    apiBase: https://app.netaix.fr/v1
    apiKey: VOTRE_CLE_NETAIX
    roles:
      - chat
      - edit
      - apply

L'application Netaix génère ce fichier avec la liste des modèles de votre catalogue et votre clé déjà insérée : c'est plus sûr que de le recopier.

LangChain

import os
from langchain_openai import ChatOpenAI

modele = ChatOpenAI(
    base_url="https://app.netaix.fr/v1",
    api_key=os.environ["NETAIX_API_KEY"],
    model="netaix-balanced",
)
print(modele.invoke("Bonjour").content)

Claude Code

Claude Code parle à POST /v1/messages, qui suit le format de l'API d'Anthropic : consigne système en blocs, définitions d'outils, blocs tool_use et tool_result, images, paramètres de génération, séquences d'arrêt et flux d'événements nommés. L'usage agent fonctionne donc, appels d'outils compris.

export ANTHROPIC_BASE_URL=https://app.netaix.fr
export ANTHROPIC_AUTH_TOKEN=VOTRE_CLE_NETAIX
export ANTHROPIC_MODEL=netaix-powerful
export ANTHROPIC_SMALL_FAST_MODEL=netaix-fast

• Pas de /v1 dans l'adresse de base : le client ajoute le chemin lui-même.
• Les deux en-têtes d'authentification sont acceptés. ANTHROPIC_AUTH_TOKEN envoie un Authorization: Bearer, ANTHROPIC_API_KEY un x-api-key. Utilisez l'un ou l'autre ; si les deux arrivent, c'est x-api-key qui est lu.
• Un niveau netaix-* est le réglage le plus durable : vous n'avez pas à suivre les noms de modèles. Un identifiant du catalogue fonctionne aussi, il se lit dans GET /v1/models.
• La route de comptage de jetons est ouverte (POST /v1/messages/count_tokens) : le client peut gérer sa fenêtre de contexte sans recevoir de 404. Ce qu'elle rend est une estimation faite par la passerelle, sans appel à un modèle.
• Les noms de ces variables appartiennent au client, pas à la passerelle : vérifiez-les dans la documentation de la version que vous utilisez.

Les autres clients au format Anthropic

Le SDK anthropic officiel fonctionne en changeant seulement l'adresse de base, en bloc comme en flux.

export ANTHROPIC_BASE_URL=https://app.netaix.fr
export ANTHROPIC_API_KEY=VOTRE_CLE_NETAIX

Votre propre application

Si vous écrivez le client vous-même, le chemin le plus court est d'utiliser un SDK officiel, OpenAI ou Anthropic, en changeant l'adresse de base : vous héritez de sa gestion du flux, des réessais et des erreurs. Les quatre points à ne pas oublier sont dans Erreurs et limites : l'enveloppe d'erreur unique, le fragment d'erreur en cours de flux, les refus qu'il ne faut pas réessayer, et ce qui se passe quand un fournisseur tombe.

Un conseil de mise en service : commencez par GET /v1/models. C'est l'appel qui vérifie d'un coup l'adresse, la clé et ce que votre clé peut appeler. Il compte dans la limite de débit, comme les autres.