> ## 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.

# Usa una API GPT Image de terceros sin cerrar sesión en Codex

> Conserva tu sesión y el chat de Codex mientras un Skill independiente llama a BetterToken GPT Image API. Guía de instalación, generación, edición y errores.

Usa un Skill de imágenes independiente: Codex mantiene las conversaciones con tu cuenta oficial, mientras el Skill llama a la API con tu BetterToken API Key y guarda el resultado localmente. Las imágenes se facturan según los precios actuales de BetterToken.

Esta guía usa [Wangnov/gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill), un proyecto comunitario con configuración independiente para APIs de imágenes compatibles con OpenAI. Conservas el modelo del chat y los archivos de sesión; después puedes pedir imágenes y cambios en lenguaje natural.

## Prepara Codex y una API Key

1. Inicia sesión con tu cuenta oficial en Codex App o Codex CLI local y abre un proyecto.
2. <a href={"https://bettertoken.ai/register"}>Crea una BetterToken API Key</a> o utiliza una existente.
3. Consulta el modelo y el precio actual en la <a href={"https://bettertoken.ai/pricing"}>model plaza</a>. Empieza con `gpt-image-2`.

Codex necesita ejecutar scripts locales y acceder a `bettertoken.ai`. Este flujo es para App y CLI locales; las tareas en la nube necesitan su propio entorno y credenciales.

## Paso 1: envía la instrucción de instalación

Copia toda la instrucción. Contiene un marcador, por lo que todavía no necesitas compartir una clave real.

```text theme={null}
Instala y configura un Skill independiente de imágenes para mi Codex local.

Repositorio: https://github.com/Wangnov/gpt-image-2-skill
Subdirectorio: skills/gpt-image-2-skill
Instala en mi directorio de usuario .agents/skills/gpt-image-2-skill; revisa y reutiliza una instalación existente.

Conserva mi sesión oficial, modelo del chat, config.toml, auth.json y OPENAI_API_KEY.
Comprueba Node.js y prepara el runtime publicado para mi sistema según el wrapper Node del repositorio. No requieras un entorno de desarrollo Rust.

Guarda la configuración en gpt-image-2-skill/config.json dentro del CODEX_HOME actual;
si no está definido, usa ~/.codex/gpt-image-2-skill/config.json.
Combina los ajustes y conserva otras entradas. Añade el servicio 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"}
Configura default_provider de este Skill como bettertoken-image.

Para generar y editar, pasa explícitamente --provider bettertoken-image.
No uses --provider codex, la herramienta oficial integrada ni otros servicios de imágenes.
Deja la clave como marcador para que la introduzca localmente; no me pidas la clave real en el chat.
Ahora solo instala y verifica la configuración, sin solicitudes de imágenes de pago.
Indica las rutas absolutas del Skill y la configuración, la Base URL y el Model ID. No muestres la clave.
```

Si falta Node.js, sigue las indicaciones de Codex para instalar Node.js LTS. El wrapper normalmente descarga el runtime publicado para tu sistema.

## Paso 2: introduce la clave localmente

Abre el archivo indicado por Codex y sustituye el marcador de `credentials.api_key.value` por tu BetterToken API Key.

| Sistema | Archivo predeterminado |
| - | - |
| macOS / Linux | `~/.codex/gpt-image-2-skill/config.json` |
| Windows | `%USERPROFILE%\.codex\gpt-image-2-skill\config.json` |

Si utilizas un `CODEX_HOME` personalizado, sigue la ruta absoluta que indique Codex. Esta configuración de imágenes es independiente del archivo de sesión.

Una configuración nueva tiene esta estructura. Si el archivo existe, modifica solo la entrada correspondiente:

```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"
        }
      }
    }
  }
}
```

Guarda el archivo de forma privada, fuera del repositorio del proyecto y de capturas de pantalla. `providers` es un campo de la herramienta comunitaria.

## Paso 3: genera la primera imagen

Guarda la configuración, abre un chat nuevo y envía:

```text theme={null}
Usa $gpt-image-2-skill con --provider bettertoken-image para generar una imagen.
Modelo: gpt-image-2. Un PNG de 1024x1024.
Contenido: una taza de cerámica verde en un estudio blanco, luz natural suave, sin texto.
Guarda en output/images/mug.png del proyecto actual y muestra la imagen.
No uses la herramienta oficial integrada ni cambies de servicio.
Si falla, indica el motivo sin cambiar de modelo ni enviar otra solicitud.
```

Permite el acceso del script a la API cuando Codex lo solicite. La generación puede tardar unos minutos; espera a que termine la solicitud actual.

Confirma que sigues conectado con la cuenta oficial, que `output/images/mug.png` existe y se abre, y que el registro de BetterToken contiene la solicitud del modelo de imágenes.

## Edita una imagen de referencia

Añade la imagen al proyecto o proporciona su ruta local:

```text theme={null}
Usa $gpt-image-2-skill con --provider bettertoken-image para editar una imagen.
Referencia: output/images/mug.png.
Cambia solo el fondo a gris claro; conserva el color, la forma de la taza y la composición.
Usa gpt-image-2 y guarda en output/images/mug-edited.png.
No sobrescribas el original, uses la herramienta oficial integrada ni cambies de servicio.
```

El Skill llama al endpoint de edición. Consulta [edición de imágenes](/es/api-reference/images-edits) para archivos y máscaras. Para cambiar de modelo, indica el Model ID completo de la model plaza.

## Resolución de problemas

| Síntoma | Solución |
| - | - |
| No encuentra el Skill | Pide a Codex que revise el `SKILL.md` instalado y abre un chat nuevo. Reinicia Codex si sigue sin aparecer. |
| Usa la herramienta oficial | Especifica `$gpt-image-2-skill` y `--provider bettertoken-image`; revisa la URL y el modelo de imágenes. |
| `401` o error de autenticación | Comprueba que la clave sea completa y válida, no el marcador. |
| `404` o modelo inexistente | Usa `https://bettertoken.ai/v1`, sin `/responses` ni otro `/v1`; comprueba el Model ID exacto. |
| Red bloqueada | Permite la solicitud del script y revisa la conexión o el proxy local. |
| Timeout, límite o saldo insuficiente | Revisa primero el registro y saldo de BetterToken. Tras un timeout, confirma el estado antes de reintentar. |

## Documentación relacionada

* [API de generación de imágenes](/es/api-reference/images-generations)
* [Sesión oficial de Codex y APIs de texto de terceros](/es/faq/codex/official-login-third-party-api)
* [OpenAI: instalación y descubrimiento de Skills](https://learn.chatgpt.com/docs/build-skills)
* [Configuración del Skill comunitario](https://github.com/Wangnov/gpt-image-2-skill)


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