> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser une API GPT Image tierce en restant connecté à Codex

> Gardez votre connexion et le chat Codex avec un Skill séparé pour BetterToken GPT Image API. Installation, génération, retouche et résolution des erreurs.

Utilisez un Skill d’images séparé : Codex poursuit les conversations avec votre compte officiel, tandis que le Skill appelle l’API avec votre BetterToken API Key et enregistre le résultat localement. Les images sont facturées aux tarifs BetterToken en vigueur.

Ce guide utilise le projet communautaire [Wangnov/gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill). Sa configuration indépendante d’API d’images compatible OpenAI permet de conserver le modèle du chat et les fichiers de connexion. Ensuite, demandez des images et des retouches en langage naturel.

## Préparer Codex et une API Key

1. Connectez votre compte officiel dans Codex App ou Codex CLI local et ouvrez un projet.
2. <a href={"https://bettertoken.ai/register"}>Créez une BetterToken API Key</a> ou utilisez une clé existante.
3. Vérifiez le modèle et le tarif actuel sur la <a href={"https://bettertoken.ai/pricing"}>model plaza</a>. Commencez avec `gpt-image-2`.

Codex doit pouvoir exécuter des scripts locaux et accéder à `bettertoken.ai`. Ce flux concerne les App et CLI locaux ; les tâches cloud nécessitent leur propre environnement et leurs identifiants.

## Étape 1 : envoyer la consigne d’installation

Copiez toute la consigne. Elle contient un emplacement réservé : aucune vraie clé n’est encore nécessaire.

```text theme={null}
Installe et configure un Skill d’images indépendant pour mon Codex local.

Dépôt : https://github.com/Wangnov/gpt-image-2-skill
Sous-dossier : skills/gpt-image-2-skill
Installe dans mon dossier utilisateur .agents/skills/gpt-image-2-skill ; vérifie et réutilise une installation existante.

Conserve ma connexion officielle, le modèle du chat, config.toml, auth.json et OPENAI_API_KEY.
Vérifie Node.js et prépare le runtime publié pour mon système selon le wrapper Node du dépôt. N’exige pas d’environnement de développement Rust.

Enregistre les paramètres dans gpt-image-2-skill/config.json sous le CODEX_HOME actuel ;
sinon utilise ~/.codex/gpt-image-2-skill/config.json.
Fusionne les réglages et conserve les autres entrées. Ajoute le service bettertoken-image :
type = openai-compatible
api_base = https://bettertoken.ai/v1
model = gpt-image-2
credentials.api_key = {"source":"file","value":"YOUR_BETTERTOKEN_API_KEY"}
Définis default_provider de ce Skill sur bettertoken-image.

Passe explicitement --provider bettertoken-image pour générer et retoucher.
N’utilise pas --provider codex, l’outil officiel intégré ou un autre service d’images.
Laisse la clé comme emplacement réservé à remplir localement ; ne demande pas la vraie clé dans le chat.
Effectue seulement l’installation et la vérification, sans requête d’image payante.
Indique les chemins absolus du Skill et de la configuration, la Base URL et le Model ID. Ne montre pas la clé.
```

Si Node.js manque, suivez Codex pour installer Node.js LTS. Le wrapper télécharge normalement le runtime publié adapté à votre système.

## Étape 2 : renseigner la clé localement

Ouvrez le fichier indiqué par Codex et remplacez l’emplacement réservé de `credentials.api_key.value` par votre BetterToken API Key.

| Système | Fichier par défaut |
| - | - |
| macOS / Linux | `~/.codex/gpt-image-2-skill/config.json` |
| Windows | `%USERPROFILE%\.codex\gpt-image-2-skill\config.json` |

Pour un `CODEX_HOME` personnalisé, utilisez le chemin absolu indiqué. Cette configuration d’images est distincte du fichier de connexion Codex.

Voici une nouvelle configuration. Dans un fichier existant, modifiez seulement l’entrée concernée :

```json theme={null}
{
  "version": 1,
  "default_provider": "bettertoken-image",
  "providers": {
    "bettertoken-image": {
      "type": "openai-compatible",
      "api_base": "https://bettertoken.ai/v1",
      "model": "gpt-image-2",
      "credentials": {
        "api_key": {
          "source": "file",
          "value": "YOUR_BETTERTOKEN_API_KEY"
        }
      }
    }
  }
}
```

Gardez ce fichier privé, hors du dépôt du projet et des captures d’écran. `providers` est un champ de configuration de l’outil communautaire.

## Étape 3 : générer la première image

Enregistrez les réglages, ouvrez un nouveau chat et envoyez :

```text theme={null}
Utilise $gpt-image-2-skill avec --provider bettertoken-image pour générer une image.
Modèle : gpt-image-2. Un PNG de 1024x1024.
Sujet : une tasse en céramique verte dans un studio blanc, lumière naturelle douce, sans texte.
Enregistre dans output/images/mug.png du projet actuel et montre l’image.
N’utilise pas l’outil officiel intégré et ne change pas de service.
En cas d’échec, indique la raison sans changer de modèle ni envoyer une autre requête.
```

Autorisez l’accès du script à l’API si Codex le demande. La génération peut prendre quelques minutes ; attendez la fin de la requête actuelle.

Vérifiez que le compte officiel reste connecté, que `output/images/mug.png` existe et s’ouvre, et que le journal BetterToken contient la requête du modèle d’images.

## Retoucher une image de référence

Placez l’image dans le projet ou fournissez son chemin local :

```text theme={null}
Utilise $gpt-image-2-skill avec --provider bettertoken-image pour retoucher une image.
Référence : output/images/mug.png.
Remplace uniquement le fond par du gris clair ; conserve la couleur, la forme de la tasse et la composition.
Utilise gpt-image-2 et enregistre dans output/images/mug-edited.png.
Ne remplace pas l’original, n’utilise pas l’outil officiel intégré et ne change pas de service.
```

Le Skill appelle l’API de retouche. Consultez la [retouche d’images](/fr/api-reference/images-edits) pour les fichiers et masques. Pour changer de modèle, précisez le Model ID complet de la model plaza.

## Résolution des problèmes

| Symptôme | Action |
| - | - |
| Skill introuvable | Faites vérifier le `SKILL.md` installé et ouvrez un nouveau chat. Redémarrez Codex si nécessaire. |
| Outil officiel utilisé | Nommez `$gpt-image-2-skill` et `--provider bettertoken-image` ; vérifiez l’URL et le modèle d’images. |
| `401` ou échec d’authentification | Vérifiez que la clé est complète et active, sans emplacement réservé. |
| `404` ou modèle introuvable | Utilisez `https://bettertoken.ai/v1`, sans `/responses` ni second `/v1` ; vérifiez le Model ID exact. |
| Réseau bloqué | Autorisez la requête de ce script et vérifiez la connexion ou le proxy local. |
| Délai dépassé, limite ou solde insuffisant | Consultez d’abord le journal et le solde BetterToken. Après un délai dépassé, confirmez le statut avant de réessayer. |

## Documentation associée

* [API de génération d’images](/fr/api-reference/images-generations)
* [Connexion officielle Codex et API de texte tierces](/fr/faq/codex/official-login-third-party-api)
* [OpenAI : installation et découverte des Skills](https://learn.chatgpt.com/docs/build-skills)
* [Configuration du Skill communautaire](https://github.com/Wangnov/gpt-image-2-skill)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.