GetAPI.ONE
Configurer Codex CLI pour GetAPI.ONE
Installez Codex CLI depuis la source officielle, conservez la clé ONE dans une variable d’environnement, configurez un fournisseur personnalisé compatible avec Responses et vérifiez la connexion active.
Portée et prérequis
Ce guide concerne Codex CLI dans le terminal. Il n’établit pas la compatibilité de tous les clients de bureau, extensions d’IDE, modèles ou fonctionnalités Codex.
- Un compte GetAPI.ONE disposant d’un solde utilisable ou d’un forfait applicable.
- Une clé GetAPI.ONE nommée, à portée limitée et stockée de manière privée.
- Un modèle choisi dans le catalogue actuel qui mentionne explicitement le point de terminaison Responses.
- L’autorisation d’installer Codex CLI et de modifier la configuration Codex de votre utilisateur.
1. Installer et identifier Codex CLI
Consultez la page officielle actuelle de Codex CLI pour obtenir le programme d’installation adapté à votre système d’exploitation. Le programme autonome officiel macOS/Linux examiné le 2026-09-07 utilise la commande ci-dessous. Les utilisateurs Windows doivent suivre l’onglet Windows de la page officielle plutôt que d’exécuter aveuglément une commande de shell Unix.
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex --version2. Charger la clé dans le terminal
Définissez la clé pour le shell actuel avant de lancer Codex. Ces exemples contiennent volontairement une valeur de substitution.
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"3. Configurer le fournisseur ONE
Ouvrez le fichier Codex config.toml de l’utilisateur, normalement dans votre répertoire .codex, et ajoutez le fournisseur ci-dessous. Remplacez YOUR_RESPONSES_MODEL par un modèle actuel du catalogue GetAPI.ONE qui déclare explicitement le point de terminaison Responses.
model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"
[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"4. Exécuter et vérifier
- Ouvrez un nouveau terminal si vous avez rendu la variable d’environnement persistante ; sinon, conservez le terminal actuel dans lequel elle est définie.
- Ouvrez un répertoire de projet et exécutez codex. Confirmez que le fournisseur et le modèle affichés correspondent à la configuration prévue.
- N’envoyez qu’une seule invite minimale lorsque vous acceptez qu’elle puisse être facturée.
- Une vérification réussie nécessite une réponse CLI valide et un enregistrement correspondant de requête ou d’utilisation dans la console GetAPI.ONE. Aucun appel de modèle n’a été effectué pendant la rédaction de ce guide.
Dépanner dans l’ordre
| Symptôme | Vérifications |
|---|---|
| codex: command not found | Consultez de nouveau le programme d’installation officiel de votre système d’exploitation et confirmez que le répertoire d’installation se trouve dans PATH. |
| Missing API key | Confirmez que GETAPI_ONE_API_KEY existe dans l’environnement même qui lance Codex et que env_key est orthographié exactement. |
| 401 / Unauthorized | Copiez de nouveau la clé ONE, confirmez qu’elle est activée et vérifiez qu’elle est associée à https://www.getapi.one/v1. |
| 404 / chemin incompatible | Confirmez que /v1 est conservé dans base_url et que la passerelle déclare /v1/responses. |
| Model not found | Remplacez la valeur de substitution par un nom exact du catalogue, visible pour le groupe de la clé et marqué pour le point de terminaison Responses. |
| La configuration n’a pas changé | Vérifiez que vous avez modifié le fichier utilisateur chargé par Codex, que model_provider pointe vers getapi_one et que le terminal ou le client a été redémarré. |