Comment utiliser la clé API GitHub Copilot avec l'API Cursor

Compréhension de la compatibilité des clés API

Lorsque les développeurs font référence à une clé API github copilot, ils font généralement référence à un token généré au sein de l'écosystème Microsoft GitHub. Cette clé authentifie les requêtes vers les serveurs de Microsoft, qui exécutent des modèles comme GPT-4o ou des variantes spécialisées optimisées pour le code. Bien que ces modèles soient puissants, ils sont soumis à des filtres de contenu spécifiques et à des limites de débit liés à votre compte Microsoft.

En revanche, l'API Cursor fonctionne comme un service indépendant. Elle ne repose pas sur l'infrastructure de Microsoft. Au lieu de cela, elle sert un seul modèle de langage large à poids ouverts optimisé pour les contextes de codage. Ce modèle est conçu pour répondre sans refus de contenu pour une utilisation adulte légale, ce qui en fait une alternative distincte pour les développeurs qui trouvent les filtres standard restrictifs.

Comprendre cette distinction est crucial. Votre clé API GitHub Copilot existante ne fonctionnera pas avec l'endpoint de l'API Cursor. Vous avez besoin d'une clé distincte générée depuis votre compte sur cursorapikey.com. Cependant, le protocole sous-jacent reste le même, ce qui signifie que votre code ne doit pas changer de manière significative.

Configuration de votre environnement

Pour utiliser l'API Cursor, vous devez d'abord générer une clé. Inscrivez-vous sur la page Obtenir la clé API avec simplement un e-mail et un mot de passe. Aucune carte bancaire n'est nécessaire pour le crédit d'essai initial. Une fois inscrit, votre clé s'affiche immédiatement. Stockez cette clé en toute sécurité dans vos variables d'environnement, généralement sous la forme OPENAI_API_KEY ou d'une variable personnalisée selon les exigences de votre agent.

La plupart des agents de codage, y compris Cursor et des outils similaires, reposent sur la norme SDK OpenAI. Cela signifie que vous n'avez pas besoin de bibliothèque personnalisée. Vous devez simplement pointer votre SDK vers la bonne URL de base. L'URL de base de l'API Cursor est https://api.cursorapikey.com/v1. Cet endpoint est entièrement compatible OpenAI, prenant en charge les mêmes structures de requête que vous connaissez déjà.

Assurez-vous que votre environnement est configuré pour envoyer des requêtes à cette nouvelle URL de base. L'ID de modèle que vous devez spécifier dans vos requêtes est uncensored. Cela indique à l'API quel modèle spécifique invoquer. Il s'agit d'un modèle à poids ouverts exécuté sur nos propres serveurs GPU, distinct de GPT, Claude ou Gemini.

Changement des URLs de base

Le passage d'une clé API GitHub Copilot à l'API Cursor implique principalement de changer l'URL de base dans la configuration de votre client. Si vous utilisez les SDK Python ou Node.js officiels d'OpenAI, il s'agit d'une modification sur une ligne. Par exemple, en Python, vous initialiseriez le client avec la nouvelle URL de base et votre nouvelle clé API.

Ce changement redirige vos requêtes des serveurs de Microsoft vers notre infrastructure. Les avantages incluent l'accès à une fenêtre de contexte de 100 000 tokens et un modèle ajusté pour moins de refus. Vous pouvez vérifier la connexion en vérifiant l'endpoint /v1/models, qui doit retourner les modèles disponibles, y compris uncensored.

Compromis : Bien que la syntaxe soit identique, vous payez désormais par token plutôt que via un abonnement Microsoft. Notre tarification est transparente : 0,25 $ par 1 M de tokens d'entrée et 1,00 $ par 1 M de tokens de sortie. Pas de frais mensuels, juste du crédit au paiement à l'usage qui n'expire jamais. Ce modèle est idéal pour les charges de travail variables où vous ne souhaitez pas vous engager dans un coût mensuel par siège.

Test de votre connexion

Avant d'intégrer l'API dans votre flux de travail principal, il est essentiel de vérifier que votre environnement peut communiquer avec l'API Cursor. Vous pouvez le faire avec une simple commande cURL ou un court script. Ce test garantit que votre clé est valide et que l'URL de base est correcte.

Exemple de requête cURL :

Envoyez une requête POST à https://api.cursorapikey.com/v1/chat/completions avec le modèle défini sur uncensored. Incluez un prompt simple dans le tableau messages. Une réponse réussie renverra une complétion dans le champ choices[0].message.content.

Si vous recevez une erreur 401, votre clé API est incorrecte. Si vous obtenez une erreur 429, vous avez dépassé la limite de 300 requêtes par minute par clé. Vous pouvez régénérer votre clé à tout moment pour invalider l'ancienne. Ce test confirme que la fonctionnalité d'entrée de texte et de sortie de texte fonctionne comme prévu.

Gestion des réponses en streaming

Pour les agents de codage, les réponses en streaming sont essentielles pour offrir une expérience utilisateur fluide. L'API Cursor prend en charge les Server-Sent Events (SSE) pour le streaming. Cela vous permet de recevoir les tokens au fur et à mesure de leur génération, plutôt que d'attendre la réponse complète.

Lors de l'utilisation du SDK OpenAI, vous pouvez activer le streaming en définissant le paramètre stream sur true. Le SDK restituera des blocs de données à leur arrivée. Cela est particulièrement utile pour les longues générations de code, où vous souhaitez afficher la progression à l'utilisateur ou injecter des tokens dans un éditeur en temps réel.

Sachez que le streaming ne modifie pas le modèle sous-jacent ni ses capacités. Il s'agit purement d'un mécanisme de livraison. Le modèle uncensored respectera toujours la fenêtre de contexte de 100 000 tokens et la même structure tarifaire. Le streaming est une fonctionnalité côté client qui améliore la latence perçue sans affecter le comportement du modèle.

Intégration de l'appel de fonctions

Les assistants de codage IA modernes reposent fortement sur l'appel de fonctions pour interagir avec le monde extérieur, comme exécuter des commandes shell ou accéder à des fichiers. L'API Cursor prend en charge cela via le format compatible OpenAI standard.

Vous pouvez définir des outils dans votre requête à l'aide du paramètre tools. Le modèle répondra par un tableau tool_calls s'il détermine qu'un outil doit être utilisé. Votre application doit ensuite exécuter l'outil et renvoyer les résultats à l'API dans un message ultérieur.

Ce processus est identique à celui que vous utiliseriez avec une clé API GitHub Copilot pour les modèles de Microsoft. L'avantage ici est la cohérence. Si vous avez déjà du code pour l'appel d'outils, vous pouvez probablement le réutiliser avec des ajustements minimaux. Assurez-vous simplement que vos définitions d'outils correspondent au schéma attendu pour le modèle uncensored.

Suivi de l'utilisation

Puisque vous payez par token, surveiller votre utilisation est important pour éviter des coûts inattendus. L'API Cursor fournit un tableau de bord où vous pouvez consulter le solde de votre crédit et l'historique d'utilisation. Vous pouvez voir combien de tokens vous avez consommés et combien de crédit reste.

Limites clés à surveiller :

• Limite de débit : 300 requêtes par minute par clé.
• Taille du corps de la requête : 8 Mo maximum par requête.
• Fenêtre de contexte : 100 000 tokens au total (entrée + sortie).

Si vous dépassez la limite de débit, vous recevrez une erreur 429. Vous pouvez surveiller votre utilisation en temps réel pour vous assurer de rester dans ces limites. De plus, vous pouvez régénérer votre clé API si vous pensez qu'elle a été compromise, ce qui invalide immédiatement l'ancienne clé.

Dépannage des problèmes courants

Même avec une API robuste, des problèmes peuvent survenir. Voici quelques problèmes courants et leurs solutions.

401 Non autorisé : Vérifiez votre clé API. Assurez-vous qu'elle est copiée correctement et ne contient ni espaces au début ni espaces à la fin. Si vous avez régénéré votre clé, assurez-vous d'utiliser la nouvelle.

429 Trop de requêtes : Vous avez dépassé la limite de 300 requêtes par minute. Implémentez une rétrogradation exponentielle dans votre client ou réduisez la fréquence de vos requêtes.

400 Mauvaise requête : Cela indique généralement un payload JSON malformé ou des champs obligatoires manquants. Assurez-vous que votre tableau messages est correctement formaté et inclut les champs role et content. Vérifiez également que le nom du modèle est exactement uncensored.

Blocage de contenu : Bien que le modèle soit sans censure, il bloque le contenu sexuel impliquant des mineurs. Si votre requête est bloquée, cela peut être dû à cette limite stricte.