Aller au contenu

CENTRE DE DOCUMENTATION API

Documentation du provider : modèles, API et intégrations.

Accédez aux modèles officiels GPT, Claude, Gemini, DeepSeek et Qwen avec une seule clé et des endpoints compatibles.

Rubriques11
Procédures54
Formats8
LangueFR
PARCOURS RECOMMANDÉ

De la clé à la première requête.

Suivez ces rubriques pour connecter vos outils et suivre votre consommation.

01CréerCréez une clé et choisissez un modèle.
02ConnecterConfigurez OpenAI, Anthropic ou Codex.
03SuivreLisez les logs, tarifs et limites.
ARCHITECTURE DU SERVICE

Un gateway, plusieurs formats officiels.

Le service route vos requêtes vers les fournisseurs configurés tout en conservant une présentation unifiée des modèles, coûts et limites.

01

Clé API

Authentification Bearer et révocation immédiate.

02

Catalogue

Modèles et capacités visibles au même endroit.

03

Formats

OpenAI Chat/Responses et Anthropic Messages.

04

Routage

Sélection automatique du fournisseur disponible.

05

Logs

Tokens, statuts et coûts par requête.

06

Facturation

Crédits, remises et limites de plan.

Sécurité

Les clés fournisseurs restent côté serveur. Ne transmettez jamais une clé ou un prompt sensible dans un ticket ou une capture.

Vérifier une clé API

Cette vérification appelle uniquement GET /v1/models. La clé n'est ni enregistrée ni affichée après le test.

01 / GUIDE

Connecter une application

Créez une clé et envoyez votre première requête aux modèles disponibles.

  • Créer une clé
  • Choisir un endpoint
  • Vérifier une réponse

Pas-à-pas

  1. 01

    Créer une clé API

    Dans le tableau de bord, ouvrez Clés API, donnez un nom explicite et copiez le secret une seule fois.

    Le secret commence par aclide_sk_. Il ne sera plus affiché après fermeture de l’écran de création.
  2. 02

    Vérifier la clé

    Utilisez le vérificateur ci-dessus ou appelez GET /v1/models. Un statut 200 confirme que la clé, le compte et le forfait sont actifs.

    cURL
    curl https://aclide.com/v1/models \
      -H \"Authorization: Bearer $ACLIDE_API_KEY\"
  3. 03

    Choisir le modèle

    Copiez exactement un identifiant marqué disponible dans la réponse /v1/models. Le catalogue dépend de votre forfait.

  4. 04

    Installer le SDK côté serveur

    Pour un site Node.js, installez le SDK OpenAI officiel dans votre backend. Ne faites jamais cet appel directement depuis le navigateur.

    Shell
    npm install openai
  5. 05

    Créer le client ACLIDE

    Placez ACLIDE_API_KEY dans les variables secrètes de votre hébergeur, puis configurez la base URL compatible OpenAI.

    TypeScript (serveur)
    import OpenAI from "openai";
    
    const client = new OpenAI({
      apiKey: process.env.ACLIDE_API_KEY,
      baseURL: "https://aclide.com/v1",
    });
  6. 06

    Appeler Responses depuis une route serveur

    Votre frontend appelle votre propre route /api/chat; seule cette route serveur contacte ACLIDE.

    TypeScript (serveur)
    const response = await client.responses.create({
      model: "MODELE_DU_CATALOGUE",
      input: message,
    });
    
    return Response.json({ text: response.output_text });

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
02 / GUIDE

Clés API et sécurité

Gérez, faites tourner et révoquez vos secrets sans exposer vos identifiants.

  • Limiter les accès
  • Révoquer une clé
  • Protéger les secrets

Pas-à-pas

  1. 01

    Nommer les clés

    Utilisez un nom par projet afin d’identifier rapidement leur usage dans les logs.

  2. 02

    Révoquer immédiatement

    Dans Clés API, cliquez sur Révoquer. Toute nouvelle requête est alors refusée.

  3. 03

    Conserver côté serveur

    Les clés ne doivent apparaître ni dans le code client, ni dans les captures, ni dans les journaux.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
03 / GUIDE

Catalogue de modèles

Explorez les modèles GPT, Claude, Gemini, DeepSeek, Qwen et autres familles disponibles.

  • Comparer les modèles
  • Lire les capacités
  • Choisir le bon tarif

Pas-à-pas

  1. 01

    Ouvrir le catalogue

    La page Modèles affiche l’identifiant, la famille, le contexte, les outils et le tarif de chaque modèle.

  2. 02

    Filtrer par capacité

    Filtrez par raisonnement, vision, outils ou vitesse.

  3. 03

    Utiliser l’identifiant exact

    Copiez l’ID affiché dans vos requêtes.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
04 / GUIDE

Format OpenAI

Connectez Chat Completions, Responses, Cursor, ChatBox et les SDK OpenAI compatibles.

  • Configurer le SDK
  • Activer le streaming
  • Gérer les erreurs

Pas-à-pas

  1. 01

    Définir la base URL

    Utilisez https://aclide.com/v1 avec le SDK OpenAI et la variable ACLIDE_API_KEY.

  2. 02

    Lister les modèles

    Appelez d’abord client.models.list() afin de reprendre un identifiant réellement autorisé à votre compte.

  3. 03

    Utiliser Responses

    Appelez client.responses.create avec model et input. N’utilisez pas Chat Completions : cette route n’est pas exposée par ACLIDE.

  4. 04

    Traiter les statuts

    401 signifie clé absente, invalide ou révoquée; 403 un forfait inactif; 429 une limite temporaire; 5xx une indisponibilité à réessayer.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
05 / GUIDE

Format Anthropic

Utilisez l’API Messages native pour Claude Code, Cline et les SDK Anthropic.

  • Configurer Messages
  • Utiliser les outils
  • Activer la vision

Pas-à-pas

  1. 01

    Définir les variables

    Utilisez ANTHROPIC_AUTH_TOKEN pour la clé ACLIDE et ANTHROPIC_BASE_URL=https://aclide.com.

  2. 02

    Utiliser Messages

    Appelez POST https://aclide.com/v1/messages avec le header Authorization généré par le client Anthropic.

  3. 03

    Sélectionner Claude

    Choisissez un modèle Claude visible dans GET /v1/models et autorisé par votre forfait.

  4. 04

    Tester avant le streaming

    Envoyez d’abord une requête sans stream. Ajoutez stream: true seulement après avoir obtenu une réponse JSON valide.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
06 / GUIDE

Codex CLI

Configurez le package officiel Codex avec un fournisseur Responses compatible.

  • Installer Codex
  • Configurer config.toml
  • Lancer Codex

Pas-à-pas

  1. 01

    Installer Codex sur Windows

    Installez le package officiel @openai/codex avec npm, puis rouvrez PowerShell.

    PowerShell
    npm install -g @openai/codex
    codex --version
  2. 02

    Préparer le dossier .codex

    Créez le dossier utilisateur et sauvegardez les fichiers existants.

    PowerShell
    New-Item -ItemType Directory -Force ~/.codex | Out-Null
    Copy-Item ~/.codex/auth.json ~/.codex/auth.json.backup -ErrorAction SilentlyContinue
    Copy-Item ~/.codex/config.toml ~/.codex/config.toml.backup -ErrorAction SilentlyContinue
  3. 03

    Choisir un modèle GPT inclus

    Dans Tableau de bord > Modèles, filtrez les modèles inclus et copiez un identifiant GPT. Codex utilise l’API Responses; privilégiez gpt-5.6-sol pour les tâches de code complexes.

    Utilisez gpt-5.6-terra pour un bon équilibre ou gpt-5.6-luna pour les tâches rapides. Les modèles Claude sont réservés en priorité au guide Claude Code.
  4. 04

    Créer auth.json

    Dans C:\Users\VOTRE_NOM\.codex, créez auth.json. Ce fichier contient uniquement votre clé ACLIDE et évite toute configuration PowerShell permanente.

    Remplacez VOTRE_CLE_ACLIDE par la clé créée dans le dashboard. Ne partagez et ne commitez jamais ce fichier.
    ~/.codex/auth.json
    {
      "OPENAI_API_KEY": "VOTRE_CLE_ACLIDE"
    }
  5. 05

    Créer config.toml

    Dans le même dossier, créez config.toml avec cette configuration Responses. Remplacez seulement le modèle si nécessaire.

    Codex n’utilise pas l’endpoint Anthropic Messages. requires_openai_auth lui fait lire la clé ACLIDE dans auth.json.
    ~/.codex/config.toml
    model_provider = "aclide"
    model = "gpt-5.6-sol"
    model_reasoning_effort = "high"
    disable_response_storage = true
    preferred_auth_method = "apikey"
    
    [model_providers.aclide]
    name = "ACLIDE"
    base_url = "https://aclide.com/v1"
    wire_api = "responses"
    requires_openai_auth = true
    request_max_retries = 4
    stream_max_retries = 5
  6. 06

    Tester réellement ACLIDE

    Lancez ce test depuis un dossier de projet. La réponse exacte confirme la clé, le modèle, Responses et le streaming.

    PowerShell / Terminal
    codex exec --skip-git-repo-check "Réponds exactement : ACLIDE CODEX OK"
  7. 07

    Démarrer Codex

    Lancez ensuite l’interface interactive dans n’importe quel dépôt. Les appels passent par https://aclide.com/v1/responses.

    PowerShell / Terminal
    codex
  8. 08

    Corriger les erreurs fréquentes

    Commande introuvable : rouvrez le terminal. 401 : corrigez la clé dans auth.json. 404 : choisissez un modèle marqué Inclus. Une connexion ChatGPT au lieu d’ACLIDE indique généralement que config.toml n’est pas dans le bon dossier.

    PowerShell
    npm update -g @openai/codex
    codex --version

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
07 / GUIDE

OpenCode

Installez OpenCode et déclarez ACLIDE comme fournisseur Responses personnalisé.

  • Installer OpenCode
  • Créer opencode.json
  • Choisir un modèle

Pas-à-pas

  1. 01

    Installer OpenCode

    Installez le CLI puis vérifiez que la commande est accessible.

    PowerShell / Terminal
    npm install -g opencode-ai
    opencode --version
  2. 02

    Charger la clé ACLIDE

    Conservez la clé hors du fichier JSON. OpenCode remplacera {env:ACLIDE_API_KEY} au démarrage.

    PowerShell
    $env:ACLIDE_API_KEY = "VOTRE_CLE_ACLIDE"
  3. 03

    Lister les modèles autorisés

    Copiez l’identifiant exact d’un modèle disponible pour votre forfait.

    PowerShell
    $headers = @{ Authorization = "Bearer $env:ACLIDE_API_KEY" }
    (Invoke-RestMethod https://aclide.com/v1/models -Headers $headers).data |
      Where-Object available | Select-Object id
  4. 04

    Créer opencode.json

    Ajoutez le fichier dans votre projet. Le package @ai-sdk/openai utilise l’API Responses exposée par ACLIDE.

    opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "model": "aclide/MODELE_DISPONIBLE",
      "provider": {
        "aclide": {
          "npm": "@ai-sdk/openai",
          "name": "ACLIDE",
          "options": {
            "baseURL": "https://aclide.com/v1",
            "apiKey": "{env:ACLIDE_API_KEY}"
          },
          "models": {
            "MODELE_DISPONIBLE": { "name": "ACLIDE - modèle principal" }
          }
        }
      }
    }
  5. 05

    Vérifier le modèle

    Démarrez OpenCode, ouvrez la liste des modèles et sélectionnez ACLIDE. L’identifiant déclaré dans models doit être identique à celui du catalogue.

    OpenCode
    opencode
    # Dans OpenCode : /models
  6. 06

    Tester puis diagnostiquer

    Envoyez un prompt court. En cas de 401, vérifiez la variable; en cas de 404, corrigez l’identifiant; si ACLIDE n’apparaît pas, validez le JSON et le nom provider aclide.

    PowerShell
    opencode auth list

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
08 / GUIDE

Claude Code

Branchez Claude Code sur le format Messages compatible ACLIDE.

  • Choisir un client
  • Régler la base URL
  • Valider le streaming

Pas-à-pas

  1. 01

    Installer Claude Code sur Windows

    Installez le CLI officiel avec npm. Git for Windows ou WSL est requis par Claude Code.

    PowerShell
    npm install -g @anthropic-ai/claude-code
    claude --version
    claude doctor
  2. 02

    Préparer le dossier de configuration

    Créez le dossier .claude et sauvegardez l’ancien fichier avant de le modifier.

    PowerShell
    New-Item -ItemType Directory -Force ~/.claude | Out-Null
    Copy-Item ~/.claude/settings.json ~/.claude/settings.json.backup -ErrorAction SilentlyContinue
  3. 03

    Choisir les modèles inclus

    Dans Tableau de bord > Modèles, filtrez les modèles inclus et copiez les identifiants Claude. L’exemple ci-dessous correspond à la structure réellement testée sur Windows.

    Si un modèle de l’exemple n’est pas inclus dans votre offre, remplacez-le par un modèle Claude marqué Inclus.
  4. 04

    Créer settings.json

    Créez ~/.claude/settings.json. Sur Windows, ~ correspond à C:\Users\VOTRE_NOM; sur macOS, à /Users/VOTRE_NOM.

    Claude Code utilise l’endpoint Anthropic Messages https://aclide.com/v1/messages. Ne lui donnez pas la configuration Responses de Codex.
    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_API_KEY": "VOTRE_CLE_ACLIDE",
        "ANTHROPIC_BASE_URL": "https://aclide.com",
        "ANTHROPIC_MODEL": "claude-sonnet-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
        "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-4-5-20251001",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
        "CLAUDE_CODE_SUBPROCESS_ENV_SCRUB": "1"
      },
      "model": "sonnet",
      "effortLevel": "high"
    }
  5. 05

    Fermer l’ancienne session Anthropic

    Si Claude Code continue d’utiliser un abonnement Anthropic déjà connecté, exécutez la déconnexion une seule fois puis relancez-le. Le fichier settings.json reste en place.

    Claude Code
    claude auth logout
  6. 06

    Tester en condition réelle

    Le mode non interactif doit répondre exactement avec le texte demandé. Cela valide l’endpoint Messages, la clé, le modèle et le streaming ACLIDE.

    PowerShell / Terminal
    claude -p "Réponds exactement : ACLIDE CLAUDE OK"
  7. 07

    Démarrer Claude Code

    Lancez ensuite Claude Code normalement dans votre projet. Une erreur 401 signifie que la clé du fichier est invalide ou révoquée; une erreur de modèle signifie qu’il n’est pas inclus dans l’offre.

    PowerShell / Terminal
    claude

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
09 / GUIDE

Logs et consommation

Suivez les requêtes, coûts, modèles et limites depuis le tableau de bord.

  • Lire un log
  • Comprendre un coût
  • Diagnostiquer une erreur

Pas-à-pas

  1. 01

    Filtrer les appels

    Filtrez par clé, modèle, statut, période et format d’API.

  2. 02

    Comparer tokens et prix

    Chaque ligne affiche tokens, multiplicateur de route et coût facturé.

  3. 03

    Analyser un échec

    Utilisez le code HTTP et l’identifiant de requête sans transmettre le prompt.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
10 / GUIDE

Tarifs, crédits et limites

Comprenez les plans mensuels, annuels et trimestriels, les crédits et les multiplicateurs.

  • Comparer les plans
  • Lire les limites
  • Suivre les crédits

Pas-à-pas

  1. 01

    Choisir une période

    Le sélecteur mensuel, trimestriel ou annuel affiche le prix et la remise.

  2. 02

    Comprendre les routes

    Les routes discountées consomment 0,5×; les premium jusqu’à 3×.

  3. 03

    Surveiller le solde

    Le dashboard affiche crédits restants, renouvellement et alertes.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
11 / GUIDE

Dépannage API

Résolvez rapidement les erreurs d’authentification, quota, modèle et réseau.

  • Identifier le code
  • Vérifier la configuration
  • Contacter le support

Pas-à-pas

  1. 01

    Lire le code HTTP

    401 clé invalide, 402 solde insuffisant, 404 endpoint ou modèle inconnu, 429 limite, 503 indisponibilité.

  2. 02

    Rejouer une requête minimale

    Retirez outils et historique puis testez un modèle de base.

  3. 03

    Partager un diagnostic sûr

    Fournissez identifiant, heure et code HTTP, jamais la clé ni le contenu sensible.

Conseils

  • Gardez vos clés côté serveur et consultez le catalogue officiel.

Vérifications

  • La configuration est valide
  • Aucun secret n’est exposé
AIDE RAPIDE

Réponses essentielles.

Les réponses aux questions les plus fréquentes sur l’API.

Où créer une clé API ?

Dans le tableau de bord, ouvrez Clés API puis cliquez sur Créer une clé.

Comment protéger mes secrets ?

Gardez-les côté serveur, révoquez toute clé exposée et ne les mettez jamais dans Git ou le navigateur.

PRÊT À COMMENCER

Connectez votre premier outil.

Créez une clé, choisissez un modèle et envoyez une requête test.