L’OpenAI Agents SDK avec une URL de base personnalisée
Donnez ce client au SDK, basculez-le sur chat completions et désactivez le traçage : vos agents s’exécutent alors sur les modèles Claude, GPT et Grok avec votre clé AIGROW.
Vous avez déjà un code ? Utilisez-le sur l’accès API, puis créez une clé.
Python, avant de créer un agent
from openai import AsyncOpenAI
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
client = AsyncOpenAI(base_url="https://aigrow.gg/v1", api_key="ag_your_key_here")
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)
agent = Agent(name="Assistant", model="claude-opus-5.5")
result = Runner.run_sync(agent, "Reply with the word ready")
print(result.final_output)Remplacez ag_your_key_here par une clé obtenue sur l’accès API.
Où se trouve le réglage
- Package Python
pip install openai-agents
Ou un agent à la fois
OpenAIChatCompletionsModel place un seul agent sur chat completions via son propre client et laisse inchangés les paramètres par défaut du SDK.
from openai import AsyncOpenAI
from agents import Agent, OpenAIChatCompletionsModel, set_tracing_disabled
set_tracing_disabled(True)
client = AsyncOpenAI(base_url="https://aigrow.gg/v1", api_key="ag_your_key_here")
agent = Agent(
name="Assistant",
model=OpenAIChatCompletionsModel(model="gpt-6-astra", openai_client=client),
)Ou avec des variables d’environnement
Le client OpenAI lit lui-même les deux premières, et la dernière désactive le traçage. Votre code appelle toujours set_default_openai_api("chat_completions") avant la première exécution.
export OPENAI_BASE_URL=https://aigrow.gg/v1
export OPENAI_API_KEY=ag_your_key_here
export OPENAI_AGENTS_DISABLE_TRACING=1Quel modèle choisir
Saisissez l’identifiant exactement comme il est écrit ici.
- Claude Opus 5.5
claude-opus-5.5 - Le modèle par défaut dans chaque bloc de cette page, et le modèle Claude le moins cher ici par token envoyé et reçu. Contexte : 1 000 000 tokens.
- Grok 4.7
grok-4.7 - Le prix de sortie le plus bas ici. Son contexte fait la moitié de celui des modèles Claude. Contexte : 500 000 tokens.
- GPT-6 Astra
gpt-6-astra - Pour un modèle GPT. Il coûte autant par token que Fable, et plus qu’Opus. Contexte : 1 050 000 tokens.
- Claude Fable 5.1
claude-fable-5.1 - Coûte plus cher par token qu’Opus. Comparez les deux dans le classement du code avant de changer. Contexte : 1 000 000 tokens.
La grille tarifaire indique chaque identifiant et son tarif en crédits, les tarifs de l’API Claude donnent les prix publics, et le classement des modèles pour le code compare les modèles sur des requêtes de programmation.
Vérifier que tout fonctionne
D’abord la clé seule, puis OpenAI Agents SDK avec cette clé.
La clé
Demandez la liste des modèles. Il faut une clé valide, et cela ne coûte rien.
curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"{
"object": "list",
"data": [
{ "id": "claude-opus-5.5", "object": "model", ... },
{ "id": "claude-fable-5.1", "object": "model", ... },
{ "id": "gpt-6-astra", "object": "model", ... },
{ "id": "claude-sonnet-5.5", "object": "model", ... },
{ "id": "gpt-6.1-sol", "object": "model", ... },
{ "id": "grok-4.7", "object": "model", ... },
...
],
"has_more": false
}OpenAI Agents SDK
Enregistrez le bloc sous le nom check.py, ajoutez votre clé et exécutez-le.
python check.pyreadyEn cas d’échec
D’abord les erreurs propres à OpenAI Agents SDK, puis les réponses que l’endpoint renvoie à n’importe quel outil.
- 404 à chaque exécution
- Le SDK utilise encore l’API Responses, son réglage par défaut. Appelez set_default_openai_api("chat_completions") avant la première exécution, ou donnez à l’agent un OpenAIChatCompletionsModel.
- Erreur 401 du client de traçage
- Le traçage envoie chaque exécution à OpenAI avec la même clé que les appels au modèle, et une clé AIGROW n’est pas une clé OpenAI. set_tracing_disabled(True) l’arrête ; set_tracing_export_api_key avec une clé de platform.openai.com le conserve.
- Mon outil affiche une erreur 401 ou d’authentification
- La clé est absente ou mal saisie. Copiez-la de nouveau depuis Accès API sur le tableau de bord, et vérifiez qu’elle est bien transmise comme clé, et non comme nom de modèle. Une clé révoquée provoque la même erreur : créez-en une nouvelle et remplacez-la.
- J’obtiens une erreur 402 ou un message sur le crédit
- Votre solde est vide. Ouvrez Accès API sur le tableau de bord, activez un code ou achetez un autre pack, et la requête suivante passera. Rien d’autre à modifier.
- J’obtiens une erreur 404 ou « Unknown model »
- Le modèle doit être l’un de ceux que l’endpoint propose, par exemple claude-opus-5.5. Les écritures propres aux fournisseurs fonctionnent aussi (claude-opus-5-5, anthropic/claude-opus-5.5), mais un identifiant daté ou tout modèle hors du catalogue est rejeté avant que la requête soit transmise, et rien n’est facturé. Envoyez GET /v1/models avec votre clé pour obtenir la liste à jour, ou consultez les identifiants dans la grille tarifaire.
- Les requêtes sont rejetées avec l’erreur 429
- La capacité de l’endpoint est partagée entre tous les clients : environ 20 requêtes par minute et 4 simultanément. Chaque erreur 429 contient un en-tête retry-after, et les SDK OpenAI et Anthropic attendent ce délai puis réessaient automatiquement. Dans votre propre boucle, attendez le nombre de secondes indiqué ou réduisez le nombre de requêtes simultanées.
- Le modèle est indisponible pour le moment
- Une erreur 404 indiquant que le modèle n’est pas disponible pour le moment signifie qu’il est brièvement hors service chez le fournisseur en amont. Ce n’est pas un problème lié à votre clé ou à votre solde. Réessayez dans un instant ou envoyez la requête à un autre modèle.
- J’obtiens une erreur 502 ou 503
- Un incident passager en amont ou de configuration, sans débit sur votre solde. Réessayez la requête ; si l’échec persiste, contactez-nous via la boutique et nous examinerons le problème.
Ce qui ne fonctionne pas avec AIGROW
Les outils hébergés, comme WebSearchTool et FileSearchTool, qu’OpenAI ne propose que sur l’API Responses. Les outils de type fonction que vous écrivez s’exécutent dans votre propre code et fonctionnent.
Les traces sur le tableau de bord OpenAI, sans clé OpenAI. L’envoi nécessite une clé de platform.openai.com, définie avec set_tracing_export_api_key.
Des champs que seule la Responses API connaît, comme previous_response_id et conversation_id. Avec chat completions, le SDK les ignore sans afficher d’erreur.
Recherche web en direct au sein du modèle. Un outil de recherche web envoyé avec une requête reçoit une réponse fondée sur ce que le modèle sait déjà, sans résultats en direct. Un outil qui récupère des pages sur votre propre machine continue de fonctionner.
Tout point d’accès autre que ces trois : /v1/messages, /v1/chat/completions et /v1/models. L’API Responses, les embeddings et le comptage de tokens renvoient une erreur 404.
Les champs de routage tels que models, route, provider et plugins. Ils sont ignorés : une requête va donc toujours au seul modèle qu’elle indique.
Ce que coûte un mois d’utilisation d’OpenAI Agents SDK
L’utilisation d’OpenAI Agents SDK est facturée au token, aux tarifs en crédits de la grille tarifaire. Un agent renvoie toute la conversation à chaque étape : une longue tâche coûte donc plus que son dernier message ne le laisse penser. Le journal d’activité de l’accès API indique le coût de chaque requête.
Questions sur OpenAI Agents SDK et une API personnalisée
- Le SDK OpenAI Agents peut-il utiliser un autre fournisseur ?
- Oui, avec n’importe quel endpoint qui parle le protocole OpenAI. Passez à set_default_openai_client un client AsyncOpenAI avec base_url https://aigrow.gg/v1 et votre clé, puis appelez set_default_openai_api("chat_completions").
- Pourquoi le SDK Agents renvoie-t-il une erreur 404 avec une base URL personnalisée ?
- Il appelle la Responses API par défaut, alors que l’endpoint ne gère que chat completions. set_default_openai_api("chat_completions") ou OpenAIChatCompletionsModel règle le problème.
- Que fait le tracing sans clé OpenAI ?
- Le tracing est activé par défaut et envoie chaque exécution à OpenAI avec la même clé que les appels au modèle. Avec une clé AIGROW, l’envoi échoue donc avec une erreur de tracing 401. Désactivez-le avec set_tracing_disabled(True) ou OPENAI_AGENTS_DISABLE_TRACING=1, ou fournissez-lui une clé OpenAI avec set_tracing_export_api_key.
- Un agent peut-il fonctionner avec un modèle Claude ?
- Oui. L’endpoint propose les modèles Claude via le protocole OpenAI : model="claude-opus-5.5" fonctionne donc avec le client du bloc, sans adaptateur à installer.
Sources : OpenAI Agents SDK Models · OpenAI Agents SDK Configuration · OpenAI Agents SDK Tracing · OpenAI Agents SDK Tools. Consulté le 21 octobre 2026.
Configurer un autre outil
- Claude CodeProtocole Anthropic
Quatre variables d’environnement, dans le shell ou dans settings.json.
- ClineProtocole OpenAI
Le fournisseur OpenAI Compatible, quatre champs dans l’écran des paramètres.
- Roo CodeProtocole OpenAI
Le fournisseur OpenAI Compatible, avec les mêmes champs que dans Cline.
- Kilo CodeProtocole OpenAI
Un fournisseur personnalisé dans l’onglet Providers ; la liste des modèles se remplit toute seule.
- ContinueProtocole OpenAI
Une entrée models dans config.yaml, avec provider openai et un apiBase.
- AiderProtocole OpenAI
OPENAI_API_BASE et OPENAI_API_KEY, puis openai/ avant l’identifiant du modèle.
- OpenCodeProtocole OpenAI
Un bloc provider dans opencode.json et la clé via /connect.
- ZedProtocoles Anthropic et OpenAI
Un fournisseur compatible Anthropic pour Claude, un fournisseur compatible OpenAI pour GPT et Grok.
- GooseProtocole OpenAI
Le fournisseur OpenAI avec OPENAI_HOST, ou un fichier de fournisseur personnalisé.
- Vercel AI SDKProtocoles Anthropic et OpenAI
Le fournisseur OpenAI Compatible pour tous les modèles, ou le fournisseur Anthropic pour Claude.
- LangChainProtocoles Anthropic et OpenAI
ChatOpenAI avec base_url pour tous les modèles, ou ChatAnthropic pour Claude.
Le guide de l’API présente les SDK, curl, les endpoints et les limites de débit.
Collez le bloc : OpenAI Agents SDK fonctionne alors avec votre crédit.
Achetez un pack de crédits, utilisez le code reçu par e-mail sur l’accès API, créez une clé et placez-la à la place de ag_your_key_here.