InvAPI Guide

Guide de configuration

Comment utiliser une Base URL et une clé API ?

Connectez un fournisseur d’intelligence artificielle à une application compatible avec une Base URL, une API Key et un modèle pris en charge.

1. Récupérer vos informations de connexion

Avant de commencer, vous devez disposer de deux informations fournies par votre prestataire d’IA.

  • Base URL : l’adresse du serveur API auquel votre application enverra ses requêtes.
  • API Key : votre clé personnelle permettant de vous authentifier auprès du serveur.

Ces informations sont généralement disponibles dans votre espace client ou dans la documentation de votre fournisseur.

Exemple fictif
Base URL : https://api.exemple.com
API Key : sk-votre-cle-api

Utilisez toujours les informations exactes fournies par votre prestataire. L’adresse et le format de la clé peuvent varier selon le service.

2. Ouvrir les paramètres de votre application

Lancez l’application dans laquelle vous souhaitez utiliser votre fournisseur d’IA. Recherchez une rubrique portant un nom similaire à :

  • Settings / Paramètres
  • Providers / Fournisseurs
  • Custom Provider / Fournisseur personnalisé
  • API Configuration / Configuration API

Selon l’application, ces paramètres peuvent se trouver dans le menu principal ou dans les réglages du modèle utilisé.

3. Ajouter un fournisseur personnalisé

Si l’application permet d’ajouter un fournisseur personnalisé, sélectionnez cette option et renseignez les champs demandés.

Nom du fournisseur

Choisissez le nom que vous souhaitez afficher, par exemple Mon fournisseur IA.

Base URL

Copiez-collez l’adresse API fournie par votre prestataire, par exemple https://api.exemple.com. Vérifiez qu’elle ne contient aucune faute de frappe. N’ajoutez pas de chemin supplémentaire si celui-ci n’est pas demandé.

API Key

Collez votre clé API dans le champ prévu à cet effet, par exemple sk-votre-cle-api. Ne partagez jamais votre clé publiquement.

Modèle

Si l’application demande un identifiant, indiquez un modèle pris en charge, par exemple nom-du-modele. L’identifiant doit correspondre exactement à celui accepté par le serveur.

4. Choisir le bon format d’API

Toutes les API d’IA ne fonctionnent pas de la même manière. Certaines utilisent un format compatible avec OpenAI, d’autres avec Anthropic Claude, et certaines leur propre protocole.

  • Format OpenAI : pour les fournisseurs compatibles avec l’API OpenAI.
  • Format Anthropic / Claude : pour les fournisseurs compatibles avec l’API Anthropic.
  • Format personnalisé : pour un protocole spécifique pris en charge par l’application.

Une Base URL valide et une API Key correcte ne suffisent pas si le format choisi est incompatible.

5. Enregistrer et tester la connexion

  1. Enregistrez la configuration.
  2. Sélectionnez le fournisseur ajouté.
  3. Choisissez un modèle disponible, si nécessaire.
  4. Envoyez un message de test.

Si le modèle répond correctement, votre configuration fonctionne.

6. Résoudre les problèmes fréquents

401 — UnauthorizedClé absente, incorrecte, expirée ou non autorisée.
403 — ForbiddenLe compte ou la clé n’a peut-être pas les autorisations nécessaires.
404 — Not FoundBase URL, chemin API ou modèle incorrect.
429 — Too Many RequestsLimite de requêtes, débit ou crédits atteinte.
500 / 503Problème temporaire du fournisseur ou modèle non pris en charge.

Consulter le solde : envoyez une requête GET https://landcock.com/v1/credits avec votre clé dans Authorization: Bearer sk-... ou x-api-key. La réponse indique le nombre de crédits restants pour votre clé.

Si le modèle ne répond pas malgré une configuration correcte, vérifiez le format d’API, l’identifiant du modèle et la compatibilité de l’application.

Conseils de sécurité
  • Ne publiez jamais votre clé dans un dépôt public ou une capture d’écran.
  • Ne la partagez pas avec des personnes non autorisées.
  • Si elle est exposée, révoquez-la et générez-en une nouvelle.
  • Vérifiez les limites d’utilisation et les frais éventuels.

7. Comment utiliser CC Switch avec Claude Desktop ou ChatGPT ?

CC Switch est une application de bureau qui permet de gérer les fournisseurs d’IA, les clés API et les modèles depuis un seul endroit. Elle prend en charge Claude Desktop, Claude Code, Codex et OpenCode.

Téléchargez CC Switch depuis le dépôt officiel GitHub.

Option A — Connecter un fournisseur personnalisé à Claude Desktop

1. Installer : téléchargez la dernière version pour Windows ou macOS, installez-la et sélectionnez la section Claude Desktop. Ne la confondez pas avec Claude Code.

2. Ajouter : cliquez sur +, choisissez un preset ou une configuration personnalisée, puis renseignez le nom, la Base URL, l’API Key et le modèle.

Exemple : Base URL https://api.example.com, API Key sk-your-api-key, modèle claude-sonnet-4-5. Utilisez les valeurs exactes de votre fournisseur.

3. Compatibilité : si CC Switch propose Needs model mapping, activez-le lorsque les identifiants de modèles ne sont pas reconnus directement.

4. Activer : enregistrez, cliquez sur Enable, quittez complètement Claude Desktop, relancez-le et testez une conversation.

Option B — Utiliser un fournisseur personnalisé avec ChatGPT ou Codex

CC Switch peut gérer des configurations Codex, mais ne redirige pas automatiquement les conversations de l’application officielle ChatGPT vers une Base URL personnalisée.

Méthode : ouvrez CC Switch, sélectionnez Codex, cliquez sur +, choisissez une configuration personnalisée, renseignez l’endpoint, la clé et le modèle, sélectionnez le protocole adapté, puis activez le fournisseur et redémarrez Codex si nécessaire.

Une API compatible OpenAI n’est pas forcément compatible avec tous les endpoints Codex. Vérifiez notamment si le fournisseur prend en charge le protocole Responses API.

Résolution des problèmes CC Switch

  • Claude Desktop ne reconnaît pas le modèle : vérifiez le protocole Anthropic Messages et le model mapping.
  • Codex renvoie une erreur : vérifiez Base URL, clé, modèle, protocole et présence éventuelle de /v1.
  • L’application utilise encore le fournisseur officiel : activez le bon fournisseur dans la bonne section et redémarrez l’application.
  • Les requêtes échouent : vérifiez les crédits, les autorisations et la compatibilité du modèle.
À retenir : la Base URL indique où envoyer les requêtes, l’API Key authentifie votre accès et le modèle détermine quelle IA vous utilisez. Les trois éléments doivent être compatibles.

Configuration guide

How to Use a Base URL and API Key

Connect an AI provider to a compatible application using a Base URL, an API Key, and a supported model.

1. Get Your Connection Details

Before getting started, you need two pieces of information provided by your AI service provider.

  • Base URL: the address of the API server your application will send requests to.
  • API Key: your personal authentication key used to access the API.

You can usually find these details in your provider’s dashboard or API documentation.

Example configuration
Base URL: https://api.example.com
API Key: sk-your-api-key

Always use the exact details provided by your service provider. URLs and API key formats may vary between services.

2. Open Your Application Settings

Launch the application you want to connect to your AI provider. Look for a section with a name similar to:

  • Settings
  • Providers
  • Custom Provider
  • API Configuration

Depending on the application, these settings may be located in the main menu or in the configuration settings for your AI model.

3. Add a Custom Provider

If your application supports custom providers, select the option to add a new provider and fill in the required fields.

Provider Name

Choose a name to identify your provider, for example My AI Provider.

Base URL

Paste the API address supplied by your provider, such as https://api.example.com. Make sure it contains no typos. Do not add extra paths unless your provider or application requires them.

API Key

Paste your key into the designated field, such as sk-your-api-key. Never share it publicly or expose it to unauthorized users.

Model

If required, enter a supported model identifier, such as your-model-name. It must exactly match one accepted by the API server.

4. Select the Correct API Format

Not all AI APIs use the same protocol. Some support the OpenAI format, others the Anthropic Claude format, and some use a custom protocol.

  • OpenAI-compatible: for providers that support the OpenAI API format.
  • Anthropic / Claude-compatible: for providers that support the Anthropic API format.
  • Custom: for a specific protocol supported by your application.

A valid Base URL and API Key are not enough if the selected API format is incompatible with your provider.

5. Save and Test Your Connection

  1. Save the configuration.
  2. Select your newly added provider.
  3. Choose an available model, if required.
  4. Send a test message.

If the model responds successfully, your configuration is working.

6. Troubleshooting Common Errors

401 — UnauthorizedYour API key may be missing, incorrect, expired, or unauthorized.
403 — ForbiddenYour account or key may not have the required permissions.
404 — Not FoundThe Base URL, endpoint path, or model identifier may be incorrect.
429 — Too Many RequestsYou may have reached a request limit, rate limit, or usage quota.
500 / 503The provider may be experiencing a temporary issue or may not support the requested model.

Check your balance: send GET https://landcock.com/v1/credits with your key in Authorization: Bearer sk-... or x-api-key. The response shows the credits remaining for your key.

If the model does not respond despite a correct configuration, check the selected API format, model identifier, and compatibility between your application and provider.

Security Tips
  • Never publish your API key in a public repository or screenshot.
  • Do not share it with unauthorized users.
  • If it is exposed, revoke it and generate a new one.
  • Check usage limits and any applicable fees.

7. How to Use CC Switch with Claude Desktop or ChatGPT

CC Switch is a desktop application that helps you manage AI providers, API keys, and model configurations from one place. It supports Claude Desktop, Claude Code, Codex, and OpenCode.

Download CC Switch from the official GitHub repository.

Option A — Connect a Custom Provider to Claude Desktop

1. Install: download the latest version for Windows or macOS, install it, and select the Claude Desktop section. Do not confuse it with Claude Code.

2. Add: click +, select a preset or custom configuration, then enter the provider name, Base URL, API Key, and model.

Example: Base URL https://api.example.com, API Key sk-your-api-key, model claude-sonnet-4-5. Use your provider’s exact values.

3. Compatibility: if CC Switch offers Needs model mapping, enable it when your provider’s model identifiers are not recognized directly.

4. Enable: save the configuration, click Enable, fully quit Claude Desktop, reopen it, and test a conversation.

Option B — Use a Custom Provider with ChatGPT or Codex

CC Switch can manage Codex configurations, but it does not automatically redirect the official ChatGPT desktop application to an arbitrary custom Base URL.

Method: open CC Switch, select Codex, click +, choose a custom configuration, enter the endpoint, key, and model, select the appropriate protocol, enable the provider, and restart Codex if necessary.

Do not assume that every OpenAI-compatible provider supports every Codex endpoint. Check whether your provider supports the Responses API when required.

CC Switch Troubleshooting

  • Claude Desktop does not recognize the model: check Anthropic Messages support and model mapping.
  • Codex returns an API error: check the Base URL, key, model, protocol, and whether /v1 is required.
  • The application still uses the official provider: enable the correct provider in the correct section and restart the application.
  • Requests fail after enabling the provider: check credits, permissions, and model compatibility.
Key takeaway: the Base URL specifies where requests are sent, the API Key authenticates access, and the model determines which AI you use. All three must be compatible.