Configurer une clé API personnalisée dans Cline

Cline est le client de codage. Le fournisseur API fournit le modèle, authentifie la demande et facture les jetons. Une clé API personnalisée connecte ces deux couches ; cela ne rend pas l'utilisation du modèle gratuite et ne contourne pas les règles d'accès d'un fournisseur.

La configuration officielle compatible OpenAI de Cline expose les champs nécessaires à cette connexion : fournisseur API, Base URL, clé API et Model ID. Avec OmniaKey, une clé peut atteindre Claude, GPT, Gemini, DeepSeek et d'autres modèles pris en charge via cette interface.

Paramètres des touches Cline personnalisés API

Ouvrez Cline dans VS Code, sélectionnez l'icône des paramètres, puis saisissez :

Le suffixe /v1 fait partie du OpenAI compatible Base URL. N'utilisez pas l'origine nue ici et n'ajoutez pas /chat/completions ; Cline crée le chemin de la requête.

Configurez Cline étape par étape

1. Créer une clé API distincte

Connectez-vous à OmniaKey, financez le solde prépayé et créez une clé API. Une clé distincte pour Cline facilite l'examen des plafonds, de la rotation et de l'utilisation plutôt que le partage d'un identifiant pour chaque outil.

Ne mettez jamais la clé littérale dans le code source, un fichier de référentiel, un problème ou une capture d'écran. Collez-le uniquement dans le champ Clé API de Cline.

2. Sélectionnez OpenAI Compatible

Ouvrez les paramètres Cline et choisissez OpenAI Compatible sous Fournisseur API. Ne choisissez pas le fournisseur officiel OpenAI lorsque la clé appartient à un autre fournisseur : le choix du fournisseur détermine les champs de configuration et le point de terminaison que Cline utilise.

3. Entrez le Base URL

Utilisez exactement :

https://api.omniakey.com/v1

Valeurs erronées courantes : https://api.omniakey.com, un /v1/v1 dupliqué ou le chemin complet /v1/chat/completions.

4. Entrez un Model ID exact

Commencez par un modèle actuellement répertorié dans le catalogue de modèles OmniaKey :

Ces exemples ne sont pas des alias. Les suffixes de casse, de ponctuation et de version sont importants. Copiez l'ID plutôt que de le retaper depuis la mémoire.

5. Vérifier avant d'attribuer une tâche réelle

Utilisez le contrôle Vérifier de Cline s'il est affiché pour le fournisseur sélectionné. Exécutez ensuite une tâche étroite et réversible :

Read package.json and name the package manager. Do not edit files.

Une vérification utile établit quatre choses :

1. Cline a accepté les paramètres du fournisseur personnalisé.
2. Le fournisseur a accepté la clé API.
3. Le modèle exact existe pour cette clé.
4. Une réponse de modèle simple est renvoyée sans modification ni boucle d'outil.

Ensuite seulement, passez à une tâche de changement de référentiel. La présentation de la configuration de l'agent de codage couvre le flux de travail plus large.

Comment fonctionne la facturation Cline BYOK

BYOK signifie apporter votre propre clé. Cline envoie des demandes à l'aide des paramètres du fournisseur que vous avez fournis, et le fournisseur facture l'utilisation du modèle en fonction de ce compte. Cline ne transforme pas un API payant en utilisation gratuite.

Examinez les jetons d’entrée réels, d’entrée en cache et de sortie plutôt que d’estimer à partir de la réponse visible. Le travail de l'agent inclut le contexte du référentiel, les appels d'outils, les tentatives et le raisonnement intermédiaire. Le guide de facturation transparent explique pourquoi le coût d'une tâche terminée est plus utile qu'un taux de jeton global.

Si le choix du modèle est encore ouvert, comparez les familles dans le guide des modèles d'agent de codage avant d'optimiser la configuration Cline.

Dépanner une clé Cline API qui ne fonctionne pas

Clé API non valide ou HTTP 401

Un 401 signifie que le point de terminaison n’a pas accepté les informations d’identification fournies avec la demande.

Vérifiez que :

• la clé provenait du même fournisseur que le Base URL ;
• aucun espace de début ou de fin n'a été collé ;
• la clé est active et n'a pas été pivotée ou supprimée ;
• le compte a un solde utilisable ;
• Cline est toujours défini sur OpenAI Compatible.

La création d'un nouvel ID de modèle ne répare pas un échec d'authentification.

Modèle introuvable ou HTTP 404

Un 404 peut signifier que le Base URL est erroné ou que le Model ID n'est pas disponible. Confirmez d’abord que Base URL se termine une fois dans /v1. Copiez ensuite l'ID exact du modèle à partir du catalogue.

Si le point de terminaison fonctionne avec un modèle répertorié mais pas avec un autre, la connexion est valide et le problème restant concerne la disponibilité ou la dénomination du modèle.

Erreur de connexion

Confirmez que https://api.omniakey.com/v1 est accessible à partir du même ordinateur exécutant Cline. Les règles VPN, proxy, DNS, inspection TLS et pare-feu peuvent affecter l'EDI même lorsqu'une page du navigateur se charge ailleurs.

Ne désactivez pas la vérification TLS pour masquer une erreur de certificat. Corrigez plutôt la configuration du réseau ou de la confiance.

Le modèle répond mais les outils échouent

Une réponse textuelle réussie ne prouve qu'une génération de base. Cline dépend également d'appels d'outils structurés pour la lecture, la modification et l'exécution de commandes. Testez une tâche de référentiel en lecture seule avant un changement autonome important.

Si un modèle produit à plusieurs reprises des appels d'outils mal formés, comparez un modèle documenté pour le travail des agents plutôt que d'augmenter aveuglément les limites de sortie.

Les coûts sont plus élevés que prévu

Un contexte de référentiel long peut dominer la facture même lorsque la réponse finale est courte. Commencez par une tâche précise, conservez les dossiers non liés hors de leur contexte et comparez le coût par modification acceptée.

Utilisez des clés ou des capuchons séparés pour les expériences. Un plafond limite l’exposition financière ; cela ne réduit pas les jetons consommés par une tâche inefficace.

Liste de contrôle de sécurité

• Utilisez une clé Cline dédiée au lieu d'un identifiant partagé avec les services de production.
• Fixez un plafond adapté à la taille du projet et de la tâche.
• Faites pivoter une clé apparue dans un référentiel, un enregistrement de terminal, une capture d'écran ou un problème.
• Vérifiez les autorisations de l'outil avant d'autoriser les commandes shell ou les modifications de fichiers.
• Démarrez des référentiels nouveaux ou non fiables avec des tâches en lecture seule.
• Vérifiez le journal d'utilisation du fournisseur après la première session réussie.

La clé API contrôle l'accès au modèle. Les autorisations de fichiers et de commandes de Cline contrôlent ce que l'agent peut faire localement. Traitez-les comme des frontières de sécurité distinctes.

Questions fréquemment posées

Puis-je utiliser ma propre clé API avec Cline ?

Oui. Sélectionnez OpenAI Compatible, puis entrez la clé Base URL, API et Model ID exacte du fournisseur. Le fournisseur doit exposer un API compatible avec l'interface attendue par Cline.

Une clé Cline personnalisée API est-elle gratuite ?

Le numéro BYOK change la personne qui authentifie et facture la demande de modèle. Le fournisseur peut toujours facturer les jetons d’entrée, d’entrée en cache et de sortie.

Quel Base URL Cline doit-il utiliser pour OmniaKey ?

Utilisez https://api.omniakey.com/v1. N'ajoutez pas /chat/completions et ne dupliquez pas /v1.

Quel modèle dois-je utiliser dans Cline ?

Commencez par un modèle actuel du catalogue qui correspond à la tâche. gpt-5.6-terra est un point de départ équilibré ; n'utilisez des modèles plus solides ou moins chers qu'après avoir comparé les résultats des tâches acceptées.

Pourquoi Cline indique-t-il Modèle introuvable ?

Vérifiez les Model ID et Base URL exacts. Une clé API valide peut toujours ne pas avoir accès à un modèle particulier, et une clé 404 peut également provenir d'une URL mal formée.

Cline stocke-t-il ma clé dans le référentiel ?

Les informations d'identification du fournisseur appartiennent aux paramètres de Cline, et non aux fichiers de projet. Quelle que soit l'implémentation du stockage du client, ne copiez pas la clé dans la source, les invites, les captures d'écran ou les rapports de problèmes.

Sources vérifiées

• Cline : fournisseur compatible OpenAI
• Cline : autorisation et BYOK
• Référence de configuration OmniaKey Cline
• Catalogue de modèles OmniaKey