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

# Генерация изображений через сторонний GPT Image API с сохранением входа в Codex

> Сохраните вход в Codex и настройки чата, подключив BetterToken GPT Image API через отдельный Skill. Установка, генерация, редактирование и устранение ошибок.

Используйте отдельный Skill для изображений: Codex продолжит вести диалог через ваш официальный аккаунт, а Skill вызовет API с BetterToken API Key и сохранит результат на компьютере. Генерация оплачивается по текущим тарифам BetterToken.

В инструкции используется проект сообщества [Wangnov/gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill). Его отдельная конфигурация OpenAI-совместимого сервиса позволяет сохранить модель чата и файлы входа Codex. После настройки запрашивайте изображения и правки обычным текстом.

## Подготовьте Codex и API Key

1. Войдите в официальный аккаунт в локальном Codex App или Codex CLI и откройте проект.
2. <a href={"https://bettertoken.ai/register"}>Создайте BetterToken API Key</a> или используйте существующий.
3. Проверьте модель изображений и текущую цену в <a href={"https://bettertoken.ai/pricing"}>model plaza</a>. Начните с `gpt-image-2`.

Codex должен запускать локальные скрипты и иметь доступ к `bettertoken.ai`. Инструкция предназначена для локальных App и CLI; облачным задачам нужны собственные среда выполнения и учетные данные.

## Шаг 1: отправьте Codex запрос на установку

Скопируйте весь запрос. Он содержит заполнитель, поэтому настоящий ключ пока не нужен.

```text theme={null}
Установи и настрой отдельный Skill для изображений в моем локальном Codex.

Репозиторий: https://github.com/Wangnov/gpt-image-2-skill
Подкаталог Skill: skills/gpt-image-2-skill
Установи в пользовательский .agents/skills/gpt-image-2-skill; существующую установку проверь и используй повторно.

Сохрани официальный вход Codex, модель чата, config.toml, auth.json и OPENAI_API_KEY.
Проверь Node.js и по инструкции Node-обертки подготовь опубликованную среду выполнения для моей системы. Не требуй установки среды разработки Rust.

Сохрани настройки изображений в gpt-image-2-skill/config.json внутри текущего CODEX_HOME;
если он не задан, используй ~/.codex/gpt-image-2-skill/config.json.
Объедини настройки, сохрани другие записи. Добавь сервис 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"}
Задай default_provider этого Skill равным bettertoken-image.

Для генерации и редактирования явно передавай --provider bettertoken-image.
Не используй --provider codex, встроенный официальный инструмент и другие сервисы изображений.
Оставь ключ заполнителем: я внесу его локально. Не проси настоящий ключ в чате.
Сейчас выполни только установку и проверку настроек, без платных запросов.
Сообщи абсолютные пути Skill и конфигурации, Base URL и Model ID. Не показывай ключ.
```

Если Node.js отсутствует, установите Node.js LTS по инструкции Codex. Обычно обертка сама загружает опубликованную среду выполнения для вашей системы.

## Шаг 2: внесите ключ на компьютере

Откройте указанный Codex файл. Замените заполнитель в `credentials.api_key.value` своим BetterToken API Key.

| Система | Конфигурация по умолчанию |
| - | - |
| macOS / Linux | `~/.codex/gpt-image-2-skill/config.json` |
| Windows | `%USERPROFILE%\.codex\gpt-image-2-skill\config.json` |

Если задан собственный `CODEX_HOME`, используйте указанный Codex абсолютный путь. Настройки изображений хранятся отдельно от файла входа Codex.

Новая конфигурация выглядит так. В существующем файле изменяйте только нужную запись:

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

Храните файл приватно, вне репозитория проекта, и не показывайте его на скриншотах. `providers` — поле конфигурации инструмента сообщества.

## Шаг 3: создайте первое изображение

Сохраните настройки, начните новый чат Codex и отправьте:

```text theme={null}
Используй $gpt-image-2-skill с --provider bettertoken-image для генерации изображения.
Модель: gpt-image-2. Один PNG размером 1024x1024.
Сюжет: зеленая керамическая кружка в белой студии, мягкий естественный свет, без текста.
Сохрани в output/images/mug.png текущего проекта и покажи изображение.
Не используй встроенный официальный инструмент и другие сервисы изображений.
При ошибке сообщи причину, не меняй модель и не отправляй новый запрос.
```

Разрешите скрипту доступ к API, если Codex запросит разрешение. Генерация может занять несколько минут; дождитесь завершения текущего запроса.

Проверьте, что официальный аккаунт Codex по-прежнему подключен, файл `output/images/mug.png` существует и открывается, а в журнале BetterToken появился запрос с нужной моделью изображений.

## Отредактируйте исходное изображение

Добавьте изображение в проект или укажите локальный путь:

```text theme={null}
Используй $gpt-image-2-skill с --provider bettertoken-image для редактирования изображения.
Исходный файл: output/images/mug.png.
Замени только фон на светло-серый, сохрани цвет, форму кружки и композицию.
Используй gpt-image-2 и сохрани в output/images/mug-edited.png.
Не перезаписывай оригинал, не используй встроенный официальный инструмент и другие сервисы.
```

Skill вызывает API редактирования изображений. Загрузка и маски описаны в [инструкции по редактированию](/api-reference/images-edits). Для смены модели укажите полный Model ID из model plaza.

## Устранение ошибок

| Симптом | Что сделать |
| - | - |
| Skill не найден | Попросите Codex проверить установленный `SKILL.md` и начните новый чат. Если Skill не появился, перезапустите Codex. |
| Используется официальный инструмент | Укажите `$gpt-image-2-skill` и `--provider bettertoken-image`; проверьте адрес и модель в настройках изображений. |
| `401` или ошибка авторизации | Проверьте, что в конфигурации указан полный действующий ключ вместо заполнителя. |
| `404` или модель не найдена | Используйте `https://bettertoken.ai/v1`, без `/responses` и повторного `/v1`; проверьте Model ID. |
| Сеть заблокирована | Разрешите сетевой запрос этого скрипта и проверьте подключение или прокси. |
| Тайм-аут, лимит запросов или недостаточный баланс | Сначала проверьте журнал и баланс BetterToken. После тайм-аута уточните статус запроса перед повтором. |

## Связанные инструкции

* [API генерации изображений](/api-reference/images-generations)
* [Официальный вход Codex и сторонние текстовые API](/faq/codex/official-login-third-party-api)
* [OpenAI: установка и обнаружение Skill](https://learn.chatgpt.com/docs/build-skills)
* [Настройка и использование Skill сообщества](https://github.com/Wangnov/gpt-image-2-skill)


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