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

# Codex 로그인 상태에서 타사 GPT Image API 사용하기

> Codex 공식 로그인과 채팅 설정을 유지하면서 독립 이미지 Skill로 BetterToken GPT Image API를 사용하는 방법. 설정, 이미지 생성과 편집, 오류 해결을 안내합니다.

독립 이미지 Skill을 사용하면 Codex 대화는 기존 공식 계정으로 계속 진행됩니다. Skill은 BetterToken API Key로 이미지 API를 호출하고 결과를 로컬에 저장합니다. 이미지 요청에는 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>하거나 기존 Key를 사용합니다.
3. <a href={"https://bettertoken.ai/pricing"}>모델 광장</a>에서 이미지 모델과 현재 요금을 확인합니다. 처음에는 `gpt-image-2`를 사용합니다.

Codex가 로컬 스크립트를 실행하고 `bettertoken.ai`에 접속할 수 있어야 합니다. 이 절차는 로컬 App과 CLI용입니다. 클라우드 작업에는 별도의 실행 환경과 인증 정보가 필요합니다.

## 1단계: Codex에 설정 프롬프트 보내기

아래 프롬프트 전체를 복사합니다. 실제 Key 대신 자리표시자가 있으므로 채팅에 Key를 제공할 필요가 없습니다.

```text theme={null}
로컬 Codex용 독립 이미지 Skill을 설치하고 설정해 주세요.

저장소: 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 개발 환경은 요구하지 마세요.

현재 CODEX_HOME 아래 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"}
이미지 Skill의 default_provider를 bettertoken-image로 설정하세요.

생성과 편집에는 --provider bettertoken-image를 명시하세요.
--provider codex, 내장 공식 이미지 도구 또는 다른 이미지 서비스를 사용하지 마세요.
Key는 제가 로컬에서 입력할 수 있도록 자리표시자로 두세요. 실제 Key를 채팅에 붙여 넣으라고 요청하지 마세요.
지금은 설치와 설정 확인만 하고 유료 이미지 요청은 보내지 마세요.
Skill과 설정 파일의 절대 경로, Base URL, Model ID를 알려 주세요. Key는 표시하지 마세요.
```

Node.js가 없다면 Codex 안내에 따라 Node.js LTS를 설치합니다. 래퍼는 일반적으로 시스템용 출시 런타임을 다운로드합니다.

## 2단계: 로컬에서 Key 입력하기

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. 1024x1024 PNG 1장을 생성하세요.
주제: 흰색 스튜디오에 놓인 녹색 세라믹 머그잔, 부드러운 자연광, 글자 없음.
현재 프로젝트의 output/images/mug.png에 저장하고 이미지를 보여 주세요.
내장 공식 이미지 도구를 사용하거나 이미지 서비스를 바꾸지 마세요.
요청 실패 시 원인을 알려 주고 모델 변경이나 추가 요청은 하지 마세요.
```

Codex가 확인을 요청하면 해당 이미지 스크립트의 API 네트워크 요청을 허용합니다. 생성에 몇 분이 걸릴 수 있으므로 현재 요청이 끝날 때까지 기다립니다.

기존 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은 이미지 편집 엔드포인트를 사용합니다. 업로드와 마스크는 [이미지 편집](/ko/api-reference/images-edits)을 참고하세요. 이미지 모델을 바꾸려면 모델 광장의 전체 Model ID를 지정합니다.

## 문제 해결

| 증상 | 해결 방법 |
| - | - |
| Skill을 찾지 못함 | 설치된 `SKILL.md`를 Codex에 확인시키고 새 채팅을 시작합니다. 계속 없다면 Codex를 재시작합니다. |
| 공식 이미지 도구를 사용함 | `$gpt-image-2-skill`과 `--provider bettertoken-image`를 명시하고 이미지 설정의 URL과 모델을 확인합니다. |
| `401` 또는 인증 실패 | 이미지 설정에 자리표시자 대신 완전하고 활성 상태인 Key가 있는지 확인합니다. |
| `404` 또는 모델을 찾지 못함 | `https://bettertoken.ai/v1`을 사용하고 `/responses`나 중복 `/v1`을 붙이지 않습니다. 정확한 Model ID를 확인합니다. |
| 네트워크 차단 | 해당 이미지 스크립트의 요청을 허용하고 로컬 네트워크나 프록시를 확인합니다. |
| 시간 초과, 요청 제한, 잔액 부족 | BetterToken 사용 로그와 잔액을 먼저 확인합니다. 시간 초과 후에는 요청 상태를 확인한 다음 재시도합니다. |

## 관련 문서

* [이미지 생성 API](/ko/api-reference/images-generations)
* [공식 Codex 로그인과 타사 텍스트 API](/ko/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.