configuration API Cockpit Tools

Cockpit Tools gère des profils Codex. Suivez l’ordre « ajouter le fournisseur → l’associer à une instance → activer et démarrer » pour que Codex utilise réellement l’API 穷哥么.

Configuration rapide

Chemin
Page Codex → Onglet Fournisseurs de modèles → Ajouter un fournisseur personnalisé
Base URL
https://qionggeme.com/v1
N’utilisez ni le site de documentation ni /docs comme endpoint API.
API Key
Clé API générée dans la console 穷哥么
La documentation ne doit contenir qu’un espace réservé, jamais une vraie clé.
wireApi
responses
Ne choisissez pas chat_completions.
Modèle
gpt-5.3-codex-spark
La liste réellement visible pour votre jeton fait foi.
Action requise
Associer le fournisseur → Activer et démarrer
Enregistrer ne signifie pas basculer.

Prérequis :

Dans cette chaîne d’intégration, Cockpit Tools gère les fichiers auth.json et config.toml du profil Codex. Utilisez de préférence l’interface de Cockpit pour basculer de fournisseur et n’éditez pas simultanément les fichiers gérés pendant qu’il les contrôle.

Étapes de configuration

  1. Ouvrir l’onglet des fournisseurs de modèles Codex

    Dans Cockpit Tools, ouvrez la page Codex, passez à l’onglet « Fournisseurs de modèles », puis cliquez sur « Ajouter un fournisseur personnalisé ». Ne placez pas la Base URL de ce guide dans le champ d’adresse du service local de Cockpit : elle correspond à un fournisseur de modèles externe.

  2. Renseigner le nom, la Base URL et la clé API

    • Nom : par exemple qionggeme-codex pour reconnaître le fournisseur.
    • Base URL : https://qionggeme.com/v1
    • API Key : collez votre propre clé qionggeme sans guillemet ni espace superflu.

    La Base URL est l’entrée API, pas l’adresse du site de contenu. N’ajoutez jamais /docs.

  3. Choisir responses pour wireApi et indiquer le modèle

    Dans le champ de protocole wireApi, sélectionnez responses. Vous pouvez utiliser gpt-5.3-codex-spark comme exemple. S’il n’est pas accessible à votre jeton, remplacez-le par un modèle compatible Codex de la liste de la console ; la page des tarifs peut servir de référence. Ne choisissez pas chat_completions, car ce guide utilise le protocole natif Codex Responses.

  4. Enregistrer le fournisseur

    Enregistrez la configuration et vérifiez que la carte du fournisseur apparaît dans la liste. Cet enregistrement ne fait que sauvegarder les données dans Cockpit : il ne bascule automatiquement aucune instance Codex.

  5. Revenir à l’instance et lui associer le fournisseur

    Dans la zone de gestion des instances Codex, sélectionnez l’instance concernée et associez-lui le fournisseur personnalisé. Sans cette association, le profil Codex n’utilisera pas le fournisseur, même s’il a été correctement enregistré.

  6. Exécuter explicitement « Activer et démarrer »

    Après l’association, lancez explicitement « Activer et démarrer » et observez l’état de l’instance. C’est cette action qui oriente le profil Codex vers le fournisseur choisi. Encore une fois : enregistrer ne signifie pas basculer.

  7. Vérifier que Codex utilise le nouveau fournisseur

    Lorsque l’instance est indiquée comme démarrée, lancez ou redémarrez Codex depuis cette instance et envoyez une requête simple. Si un ancien terminal Codex ou un ancien profil était actif avant la bascule, fermez-le afin qu’il ne continue pas à lire l’ancienne configuration.

Exemple de configuration

# Cockpit Tools → Codex → Fournisseurs de modèles → Ajouter un fournisseur personnalisé
Nom: qionggeme-codex
Base URL: https://qionggeme.com/v1
API Key:  <VOTRE_CLÉ_API_QIONGGEME>
wireApi:  responses
Modèle:   gpt-5.3-codex-spark (ou un modèle Codex visible pour le jeton actuel)

# Étapes obligatoires après l’enregistrement
1. Revenir à l’instance
2. Associer ce fournisseur
3. Exécuter « Activer et démarrer »

# Attention
Enregistrer ne bascule pas l’instance. Ne modifiez pas simultanément auth.json ou config.toml lorsqu’ils sont gérés par Cockpit.

Dépannage

Le fournisseur est enregistré, mais Codex utilise encore l’ancienne route

L’enregistrement ne fait que persister la configuration. Revenez à l’instance, vérifiez que le fournisseur lui est associé, exécutez explicitement « Activer et démarrer », puis redémarrez Codex. Contrôlez l’état de l’instance, pas seulement la présence de la carte du fournisseur.

chat_completions a été choisi par erreur et Responses échoue

Modifiez le fournisseur, définissez wireApi sur responses et conservez https://qionggeme.com/v1 comme Base URL. Ce guide n’utilise ni conversion Chat Completions ni routage local.

Le fournisseur existe, mais n’est pas appliqué à l’instance

Vérifiez qu’il est réellement associé à l’instance courante. L’association est une action distincte ; si vous changez d’instance, contrôlez-la à nouveau puis exécutez « Activer et démarrer ».

L’instance ne démarre pas ou son port est anormal

Examinez l’état d’exécution et le port dans Cockpit. Vérifiez que le service est démarré et que le port n’est pas occupé par un autre processus. Identifiez le processus avant toute action ; ne le terminez pas à l’aveugle. Après un changement de port, redémarrez l’instance et testez à nouveau.

Un ancien profil reste chargé ou l’édition manuelle a désynchronisé l’état

Arrêtez l’instance gérée, contrôlez l’association et l’état d’activation, puis laissez Cockpit exécuter à nouveau « Activer et démarrer ». Cockpit gère auth.json et config.toml du profil Codex et restaure le profil sauvegardé selon son propre mécanisme. N’éditez pas ces fichiers simultanément pendant la prise en charge.

Prêt à commencer ?

Créez un compte 穷哥么 pour obtenir une clé API et accéder aux modèles disponibles.

Créer un compte

Questions fréquentes

Quelle Base URL utiliser dans Cockpit Tools ?

Utilisez https://qionggeme.com/v1, l’entrée de l’API Codex de qionggeme. N’utilisez ni l’adresse du site de contenu ni une URL contenant /docs.

Pourquoi wireApi doit-il valoir responses ?

Codex utilise le protocole natif Responses. chat_completions est un autre protocole ; le choisir peut provoquer une incompatibilité de format ou de routage.

Le fournisseur est-il actif dès qu’il est enregistré ?

Non. Vous devez encore revenir à l’instance, lui associer le fournisseur, exécuter explicitement « Activer et démarrer », puis vérifier l’état et une requête réelle.

Quels fichiers Codex sont gérés par Cockpit Tools ?

Cockpit gère auth.json et config.toml dans le profil Codex. Lors de l’activation, il oriente le profil cible vers le fournisseur sélectionné. Utilisez le mécanisme de Cockpit pour désactiver ou restaurer et évitez l’édition manuelle simultanée.

gpt-5.3-codex-spark est-il toujours disponible ?

Il s’agit d’un exemple de configuration. La liste visible dans la console pour votre jeton fait foi. Si cet ID manque, choisissez un autre modèle compatible Codex ; la page des tarifs n’est qu’une référence des modèles mis en avant.

Guides associés

configuration API personnalisée Codex CLI

Utilisez le mécanisme officiel de model provider de Codex pour accéder à 穷哥么. La clé reste dans une variable d’environnement et le fournisseur utilise l’API Responses.

Lire le guide →

configuration API CC Switch

Utilisez en priorité l’import direct de la console 穷哥么 pour transmettre à CC Switch le fournisseur, l’endpoint, le modèle et la clé API. Une configuration manuelle est également décrite en cas d’échec.

Lire le guide →

configuration Cherry Studio New API

Ajoutez 穷哥么 comme fournisseur selon la documentation officielle de Cherry Studio, avec un type compatible OpenAI et l’adresse racine du domaine principal.

Lire le guide →