Documentation

Démarrage rapide de l'API

Connectez votre application ou script avec ces exemples. Pour Claude Code, Codex et les autres outils de programmation, consultez les guides de configuration.

  1. Rechargez votre portefeuille et créez une clé API.
  2. Choisissez dans le catalogue un modèle compatible avec l’endpoint utilisé.
  3. Définissez CODEBYAI_API_KEY comme indiqué ci-dessous, remplacez MODEL_ID par le modèle choisi, puis exécutez la requête. Une requête réussie consomme du solde ; ne partagez pas votre clé.

Messages prend en charge Claude. Responses accepte GPT, Codex et Claude ; Chat Completions accepte aussi Grok. Gemini utilise son propre endpoint. Un identifiant inconnu renvoie HTTP 400. Seul le champ JSON model de Messages, Responses et Chat Completions peut être omis pour utiliser le modèle par défaut. L’URL Gemini exige toujours un identifiant.

Préparer le terminal

Utilisez curl 7.76+, Python 3.10+ ou Node.js 20+, sans installer de SDK. Dans la commande de configuration, remplacez YOUR_API_KEY par votre clé et conservez le nom CODEBYAI_API_KEY. Exécutez-la dans le terminal qui servira à la requête. Il faut la redéfinir dans chaque nouveau terminal.

macOS / Linux (bash / zsh):

1
export CODEBYAI_API_KEY="YOUR_API_KEY"

Windows PowerShell, pour les exemples Python et JavaScript :

1
$env:CODEBYAI_API_KEY="YOUR_API_KEY"

Exécuter l’exemple généré

Dans le générateur de la page d’accueil, choisissez le protocole, le modèle et le langage, puis copiez l’exemple. Enregistrez les scripts en texte brut et exécutez-les depuis leur dossier, dans le terminal où la clé est définie.

LangageFichierExécution
curlAucunColler dans bash / zsh
Pythonrequest.pypython3 request.py
JavaScriptrequest.mjsnode request.mjs

Sous Windows, utilisez python request.py pour Python ; la commande Node.js reste identique. Les exemples curl utilisent la syntaxe bash / zsh : sous Windows, utilisez Git Bash ou WSL. Ne collez pas du code Python ou JavaScript directement dans le shell. Les exemples curl ci-dessous lisent la même variable d’environnement.

Si vous voyez Set CODEBYAI_API_KEY, redéfinissez la clé dans le même terminal. Une erreur HTTP affiche son statut et son contenu ; vérifiez la cause avant de relancer la requête.

Anthropic Messages

1
curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/messages \
2
  -H "x-api-key: ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "content-type: application/json" \
5
  -d '{"model":"MODEL_ID","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

Modèles Claude uniquement. Cet endpoint lit d'abord x-api-key. anthropic-version est transmis au canal Claude.

OpenAI Responses

1
curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/responses \
2
  -H "Authorization: Bearer ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \
3
  -H "content-type: application/json" \
4
  -d '{"model":"MODEL_ID","input":"Hello"}'

Modèles GPT et Codex, ainsi que claude-*, transmis au canal Claude et facturé aux tarifs Claude.

OpenAI Chat Completions

1
curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/chat/completions \
2
  -H "Authorization: Bearer ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \
3
  -H "content-type: application/json" \
4
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Hello"}]}'

Chat Completions accepte GPT, Codex, Claude et Grok. Responses ne prend pas en charge Grok. L’URL de base du SDK OpenAI est https://www.codebyai.net/api/agent/v1 ou https://www.codebyai.net/api/agent.

Gemini

1
curl --fail-with-body --max-time 120 "https://www.codebyai.net/api/agent/v1beta/models/MODEL_ID:generateContent" \
2
  -H "x-goog-api-key: ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \
3
  -H "content-type: application/json" \
4
  -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'

Modèles Gemini uniquement. L'en-tête de clé est x-goog-api-key.

Vérifier la réponse

Une requête réussie renvoie HTTP 200. Ces champs contiennent le texte généré et l’utilisation des tokens ; la réponse complète dépend du modèle.

ProtocoleTexte généréTokens utilisés
Messagescontent[].textusage
Responsesoutput[].content[].textusage
Chat Completionschoices[].message.contentusage
Geminicandidates[].content.parts[].textusageMetadata

En cas de 400, vérifiez le modèle et l’endpoint. Pour les erreurs de clé ou de solde, consultez les erreurs courantes.

Ensuite