Codex Gateway Imagegen은(는) 무엇을 하나요?

이 스킬을 사용하면 ~/.codex/config.toml에 정의된 게이트웨이를 통해 프롬프트를 이미지 파일로 변환할 수 있습니다.

다음 두 가지 모드를 지원합니다:

텍스트-이미지 생성
하나 이상의 참조 이미지를 사용한 이미지 편집

빠른 시작

사용자에게 생성인지 편집인지 확인하고, 출력 경로를 확인합니다.
대상에 맞는 크기를 선택합니다.
- 정사각형 이미지: 1024x1024
- 세로형 / 전화 스크린샷: 1024x1536
- 가로형: 1536x1024
scripts/generate_gateway_image.py를 실행합니다.
이미지 생성에 속도 제한이 걸린 경우, 원래 프롬프트, 이미지, 크기, 동작을 유지합니다. 프롬프트를 줄이거나, 다시 쓰거나, 단순화하거나 변경하지 마십시오. 헬퍼 스크립트가 백오프(backoff)를 사용하여 동일한 요청을 재시도합니다.
샌드박스 내에서 TLS, schannel 또는 읽기 시간 초과 오류로 요청이 실패하면, 동일한 명령을 상위 호스트 네트워크 액세스 권한으로 다시 실행합니다.
저장된 파일 경로를 보고합니다.

워크플로우

1. 프롬프트 구성

프롬프트는 단편이 아닌 프로덕션 사양으로 작성합니다. 다음을 포함하세요:

주제
장면
시각적 스타일
구도
조명
라이브 스트리밍 스크린샷, 포스터, 포토리얼리스틱, 9:16 세로 등의 출력 힌트
필요한 경우 UI 오버레이나 정확한 화면 요소

사용자가 라이브 앱 스크린샷 느낌을 원한다면, 명시적으로 말하고 오버레이를 설명하세요.

사용자가 편집을 원하는 경우, 다음도 설명하세요:

참조 이미지에 가깝게 유지해야 할 부분
변경되어야 할 부분
편집이 느슨한 리스타일링인지, 고충실도 보존인지

2. 적법한 크기 선택

구도에 명확히 다른 종횡비가 필요하지 않다면 기본값은 1024x1024입니다.

이 워크플로우에서 검증된 크기:

1024x1024
1024x1536

게이트웨이가 Invalid size ... below the current minimum pixel budget과 같은 오류를 반환하면, 동일한 크기로 재시도하지 말고 요청 크기를 늘리세요.

3. 헬퍼 스크립트로 생성하기

텍스트-이미지 생성:

python "${CLAUDE_SKILL_DIR}/scripts/generate_gateway_image.py" --prompt "<프롬프트>" --out "<출력-경로>" --size 1024x1024

로컬 참조 이미지를 사용한 이미지 편집:

python "${CLAUDE_SKILL_DIR}/scripts/generate_gateway_image.py" --prompt "<프롬프트>" --image "<참조-이미지>" --action edit --out "<출력-경로>" --size 1024x1536

여러 참조 이미지를 사용한 이미지 편집:

python "${CLAUDE_SKILL_DIR}/scripts/generate_gateway_image.py" --prompt "<프롬프트>" --image "<참조-1>" --image "<참조-2>" --action edit --out "<출력-경로>" --size 1024x1536

선택적 입력:

--image <경로>: 로컬 참조 이미지, 반복 가능
--image-url <url>: 원격 참조 이미지, 반복 가능
--mask <경로>: 대상 편집 영역을 위한 로컬 마스크 이미지
--action auto|generate|edit: 기본값은 auto
--max-retries <숫자>: 이미지 속도 제한 오류에 대한 최대 재시도 횟수, 기본값은 5

스크립트:

~/.codex/config.toml에서 base_url을 읽습니다.
~/.codex/auth.json에서 OPENAI_API_KEY를 읽습니다.
/responses를 호출합니다.
기본적으로 model="gpt-5.5"를 사용합니다.
action=auto|generate|edit으로 image_generation 도구를 요청합니다.
프롬프트 텍스트를 input_text로 전송합니다.
참조 이미지를 input_image로 전송합니다.
선택적 마스크를 input_image_mask로 전송합니다.
반환된 base64 이미지를 디코딩하고 출력 파일을 작성합니다.

중요:

Responses model은 gpt-5.5와 같은 주 모델로 유지됩니다.
이미지 생성 및 편집은 image_generation 도구를 통해 수행됩니다.
편집의 경우 --action edit을 선호하고 최소한 하나의 --image를 포함하세요.

4. 일반적인 실패 모드 처리

샌드박스 내에서 네트워킹 또는 TLS 증상(예:)으로 호출이 실패하는 경우:

Authentication failed, see inner exception
schannel: AcquireCredentialsHandle failed
The read operation timed out

이는 반드시 게이트웨이 문제가 아니라 먼저 환경 경로 문제로 간주하세요. 샌드박스 외부에서 상위 호스트 네트워크 액세스 권한으로 동일한 스크립트를 다시 실행하세요.

호출이 게이트웨이에 도달하여 HTTP 오류 본문을 반환하면, 프롬프트를 변경하기 전에 본문을 검사하세요.

게이트웨이 또는 스트림이 이미지 생성에 대해 rate_limit_exceeded를 반환하면, 프롬프트를 변경하지 마세요. 보고된 지연 또는 백오프 간격 후에 원래 요청을 재시도하세요. 프롬프트 단순화는 분당 이미지 제한에 대한 해결책이 아닙니다.

결과가 참조 이미지를 너무 느슨하게 무시하는 경우:

명시적인 보존 지침으로 프롬프트를 강화하세요.
auto에서 edit으로 전환하세요.
이미지의 일부만 변경해야 하는 경우 마스크를 사용하세요.

5. 출력물을 의도적으로 저장하기

사용자가 현재 작업에 대한 이미지를 요청한 경우, 다음과 같은 설명적인 이름으로 현재 작업 공간에 직접 저장하세요:

hero_poster.png
livestream_vertical_v2.png
product_mockup_square.png

최종 자산을 임시 위치에만 두지 마십시오.

참조

요청이 실패하고 빠른 의사 결정 트리가 필요하면 references/troubleshooting.md를 읽으세요.

Codex Gateway Imagegen