AI Agents
Agents de programmation sur SeedRouter
Exécutez Claude Code sur les modèles Claude de SeedRouter et Codex CLI sur GPT-6, avec une facturation sur votre solde SeedRouter.
Les agents de programmation peuvent utiliser SeedRouter comme fournisseur de modèles. Ils envoient des requêtes avec votre clé API SeedRouter, et chaque requête est facturée au token sur votre solde SeedRouter plutôt que via un abonnement.
| Agent | Point de terminaison utilisé | Modèles |
|---|---|---|
| Claude Code | Anthropic Messages, https://api.seedrouter.ai/v1/messages | Claude |
| Codex CLI | OpenAI Responses, https://api.seedrouter.ai/v1/responses | GPT-6 |
Pour permettre à un agent d'appeler les modèles d'image et de vidéo de SeedRouter, utilisez le serveur MCP ou consultez Utiliser SeedRouter depuis des agents IA.
Claude Code
Exécutez ceci dans le terminal depuis lequel vous démarrez Claude Code :
export ANTHROPIC_BASE_URL=https://api.seedrouter.ai
export ANTHROPIC_API_KEY=YOUR_API_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5
claude --model claude-opus-5-5- L'URL de base ne contient aucun chemin. Claude Code ajoute lui-même
/v1/messages. - Les trois variables
ANTHROPIC_DEFAULT_*_MODELfont pointer les aliasopus,sonnetethaikude Claude Code, également utilisés pour les tâches en arrière-plan, vers des identifiants de modèles SeedRouter. Vous pouvez aussi transmettre directement un identifiant, par exempleclaude --model claude-fable-5-1. - La clé remplace votre abonnement Claude. Lors d'une session interactive, Claude Code vous demande une seule fois d'approuver la clé ; les requêtes sont ensuite facturées sur votre solde SeedRouter. Supprimez les variables pour revenir à votre abonnement.
Pour conserver ces paramètres à chaque lancement, placez les mêmes variables dans le bloc env de ~/.claude/settings.json. Ce fichier contient alors une clé permettant de dépenser votre solde ; gardez-le donc privé.
| Identifiant du modèle | Utilisation |
|---|---|
claude-opus-5-5 | Programmation au quotidien |
claude-fable-5-1 | Refactorisations longues et débogage difficile |
claude-fable-5 | Configurations qui reposent sur le déclenchement forcé d'un appel d'outil |
claude-sonnet-5-5 | L'alias sonnet |
claude-haiku-5-5 | L'alias haiku et les tâches en arrière-plan |
Les tarifs à jour par million de tokens figurent sur la page de chaque modèle, par exemple Claude Opus 5.5. Le guide Claude Code présente la configuration complète, le fonctionnement de la mise en cache des prompts et les résultats des tests.
Codex CLI
Ajoutez SeedRouter à votre fichier utilisateur ~/.codex/config.toml, en conservant vos autres paramètres :
model = "gpt-6-sol"
model_provider = "seedrouter"
[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://api.seedrouter.ai/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"Exportez ensuite votre clé et démarrez Codex :
export SEEDROUTER_API_KEY=YOUR_API_KEY
codex- Utilisez le fichier utilisateur. Codex ignore
model_provideretmodel_providersdans le fichier.codex/config.tomld'un projet. - Choisissez le modèle avec
model, ou pour une seule session aveccodex -m gpt-6-astra. GPT-6 Astra convient aux tâches les plus difficiles, GPT-6 Sol à la programmation quotidienne et GPT-6 Luna aux étapes rapides et moins coûteuses. - Les modèles testés sont ceux de GPT-6. Codex envoie des requêtes Responses ; tout autre modèle de texte doit accepter le format Responses, indiqué dans sa référence API, et n'a pas été testé dans Codex.
Le guide GPT-6 pour Codex présente la fenêtre de contexte, les paramètres d'effort de raisonnement et les résultats des tests.
Vérifier la connexion
curl https://api.seedrouter.ai/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-haiku-5-5",
"max_tokens": 32,
"messages": [{"role": "user", "content": "Reply OK."}]
}'Une clé fonctionnelle renvoie un message contenant une courte réponse. Pour Codex, exécutez codex exec "Reply OK." après avoir effectué la configuration ci-dessus.
Coût et limites
- Les requêtes sont facturées selon les tokens de chaque réponse. Une session de programmation envoie un long préfixe de prompt à chaque requête : instructions, définitions d'outils et fichiers du projet. Lorsque le modèle prend en charge la mise en cache des prompts, les requêtes suivantes lisent ce préfixe depuis le cache à un tarif réduit.
- Chaque requête apparaît dans votre historique d'utilisation. Ajoutez des crédits sur la page Facturation.
- HTTP
429signifie qu'il y a trop de requêtes simultanées. Réduisez le nombre de sessions ou de sous-agents exécutés en parallèle et respectez le délai deRetry-Aftersi cet en-tête est présent.
Dépannage
| Symptôme | Solution |
|---|---|
401 | Vérifiez la clé. Pour Claude Code, définissez soit ANTHROPIC_API_KEY, soit ANTHROPIC_AUTH_TOKEN, mais pas les deux. |
404 à chaque requête | Claude Code nécessite ANTHROPIC_BASE_URL=https://api.seedrouter.ai ; Codex nécessite base_url = "https://api.seedrouter.ai/v1". |
| Modèle indisponible | Utilisez un identifiant de modèle indiqué ci-dessus : les modèles Claude pour Claude Code, GPT-6 pour Codex. |
| Solde insuffisant | Ajoutez des crédits sur la page Facturation. |
429 | Réduisez le nombre de sessions ou de sous-agents en parallèle ; respectez Retry-After si cet en-tête est présent. |
