Qu'est-ce que l'API Codex ?
Le terme codex api fait généralement référence à l'interface utilisée par les modèles IA entraînés spécifiquement pour la génération et la compréhension du code. Popularisé à l'origine par OpenAI, ce concept est devenu une norme plus large où divers fournisseurs proposent des endpoints compatibles OpenAI. Pour les agents de codage IA, cela signifie une structure POST /v1/chat/completions cohérente qui gère les interactions texte-entrée, texte-sortie.
Notre service fournit un modèle de langage large dédié et sans censure optimisé pour les contextes de codage. Contrairement aux relais proxy qui agrègent plusieurs fournisseurs, nous exécutons un seul modèle à poids ouverts sur nos propres serveurs GPU. Cela garantit un endpoint de modèle unique et stable avec une fenêtre de contexte de 100 000 tokens, ce qui est critique pour gérer de grands ensembles de code sans perdre le contexte.
L'API ne prend pas en charge les embeddings, la génération d'images, d'audio ou de vidéo, ni le fine-tuning. Il s'agit strictement d'un moteur de complétion basé sur le texte conçu pour s'intégrer directement dans des agents de codage comme Cursor ou Claude Code.
Pourquoi utiliser un modèle sans censure ?
Les modèles de codage standards appliquent souvent des filtres de contenu qui peuvent interférer avec les tâches techniques. Par exemple, un modèle peut refuser de générer du code pour une exploitation de sécurité ou bloquer une syntaxe spécifique d'un langage de programmation si elle ressemble à une œuvre protégée par le droit d'auteur, même lorsque le cas d'utilisation est légal et technique. Un modèle sans censure supprime ces refus arbitraires, permettant à l'agent de se concentrer purement sur la qualité et la logique du code.
Notre modèle est ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Cela est particulièrement utile pour les agents de codage IA qui doivent traiter des extraits de code variés, de la documentation ou des projets de codage créatif sans rencontrer d’erreur 403 Forbidden en raison de la politique de contenu.
Il existe une limite de contenu stricte qui s'applique toujours : pas de contenu sexuel impliquant des mineurs. Les requêtes de ce type sont bloquées. Pour tous les autres sujets adultes légaux, fictifs ou liés à la recherche en sécurité, le modèle fournira une réponse directe. Cette stabilité réduit le besoin de logique de nouvelle tentative dans le flux de travail de votre agent, économisant des tokens et du temps.
Configuration de l'IDE Cursor
L'IDE Cursor est un éditeur de code populaire alimenté par l'IA qui s'appuie sur des endpoints LLM externes. Pour utiliser notre API sans censure comme votre agent de codage principal, vous devez mettre à jour l'URL de base dans vos paramètres.
Accédez aux paramètres de Cursor et localisez la section de configuration de l'API. Modifiez l'URL de base vers https://api.getcodexapi.com/v1. Saisissez votre clé API depuis la page Obtenir la clé API. L'ID de modèle que vous devez sélectionner est uncensored.
Cette configuration garantit que toutes les suggestions et modifications de code sont traitées par notre modèle dédié. Étant donné que Cursor utilise le format compatible OpenAI, aucun middleware supplémentaire n'est requis. La fenêtre de contexte de 100 000 tokens permet à l'éditeur de maintenir le contexte sur de grands fichiers ou des tâches de refactoring multi-fichiers, ce qui est une limitation courante des modèles à petite fenêtre de contexte.
Compromis : Vous n'aurez pas accès aux modèles propriétaires comme GPT-4 ou Claude à moins de modifier manuellement la configuration. Cependant, pour la génération et l'édition de code pur, cet endpoint sans censure fournit souvent des résultats plus rapides et plus cohérents sans interruptions de politique.
Connexion à Claude Code
Claude Code est un agent en ligne de commande développé par Anthropic. Bien qu'il utilise généralement l'API d'Anthropic, il peut être configuré pour utiliser n'importe quel endpoint compatible OpenAI si le client le prend en charge. Cela fait de notre API une alternative viable pour les utilisateurs qui préfèrent le comportement sans censure de notre modèle mais aiment l'interface Claude Code.
Pour vous connecter, vous devez vous assurer que votre client prend en charge les URL de base personnalisées. Mettez à jour la configuration pour pointer vers https://api.getcodexapi.com/v1 et définissez le modèle sur uncensored. Vous devrez également fournir votre clé API.
Cette configuration est utile pour les développeurs qui souhaitent les capacités robustes d'appel d'outils d'un agent de codage mais ont besoin d'un modèle qui ne refuse pas les modèles de code complexes ou inhabituels. Notez que bien que l'interface reste la même, le comportement du modèle sous-jant diffère des modèles Claude standards. Testez toujours vos flux de travail spécifiques pour vous assurer que le modèle sans censure répond à vos normes de qualité de code.
Utilisation du SDK OpenAI
Le SDK OpenAI pour Python ou Node.js est conçu pour fonctionner avec n'importe quel endpoint compatible OpenAI. Vous pouvez basculer vers notre API en modifiant l'URL de base et la clé API.
Voici comment vous pouvez initialiser le client en Python :
from openai import OpenAI
client = OpenAI(
base_url="https://api.getcodexapi.com/v1",
api_key="your-api-key"
)
Ensuite, vous pouvez appeler l'endpoint de complétion de chat comme d'habitude :
response = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a Python function to sort a list."}]
)
Cette simplicité vous permet de remplacer le modèle sous-jacent sans réécrire la logique principale de votre agent. Le SDK gère la sérialisation et l'analyse des réponses, vous permettant de vous concentrer sur la logique de l'application.
Réponses en streaming pour une rétroaction en temps réel
Pour les agents de codage qui fournissent des suggestions de code en temps réel, le streaming est essentiel. Notre API prend en charge Server-Sent Events (SSE) pour le streaming des réponses. Cela permet à l'agent d'afficher le code au fur et à mesure de sa génération, améliorant l'expérience utilisateur.
- Définissez
stream=Truedans votre requête API. - Lisez le flux morceau par morceau.
- Mettez à jour l'interface utilisateur ou l'éditeur avec chaque morceau.
Cela réduit la latence perçue, en particulier pour les grands blocs de code. Étant donné que notre modèle dispose d'une fenêtre de contexte de 100 000 tokens, vous pouvez diffuser des réponses incluant de grandes quantités de contexte sans vous soucier de la troncature.
Remarque : Le streaming ne modifie ni la tarification ni le comptage des tokens. Les tokens sont facturés sur la base du total des entrées et des sorties, que la réponse soit diffusée en streaming ou renvoyée dans un bloc unique.
Gestion des appels de fonctions
Les agents de codage IA utilisent souvent l'appel de fonctions pour interagir avec des outils externes, comme exécuter une commande terminal ou lire un fichier. Notre API prend en charge cette fonctionnalité, vous permettant de définir des schémas de fonctions dans votre requête.
- Définissez vos fonctions dans le paramètre
functions. - Le modèle renverra une réponse contenant un objet
function_call. - Votre agent exécute la fonction et renvoie le résultat au modèle.
- Le modèle génère la réponse suivante en fonction du résultat.
Cette interaction multi-tours est cruciale pour les tâches de codage complexes. Par exemple, un agent peut devoir lire un fichier, l'analyser, puis générer une correction. Notre API gère cela sans couture, en maintenant le contexte sur plusieurs tours dans la limite de 100 000 tokens.
Gestion des limites de débit
Pour garantir une utilisation équitable et la stabilité, notre API applique une limite de 300 requêtes par minute par clé. La taille maximale du corps de la requête est de 8 Mo. Si vous dépassez ces limites, vous recevrez une erreur 429 Too Many Requests.
Bonnes pratiques :
- Mettez en œuvre une rétrogradation exponentielle dans la logique de nouvelle tentative de votre agent.
- Utilisez le streaming pour réduire le nombre d'appels API pour les grandes réponses.
- Surveillez votre utilisation via le tableau de bord pour éviter les frais inattendus.
Si vous devez faire tourner les clés, vous pouvez régénérer votre clé API à tout moment. Cela révoque l'ancienne clé, alors assurez-vous de mettre à jour vos agents avant de la régénérer.
