이 문서는 ktkarchive/codex-imagegen-2-skill-for-kimi GitHub 저장소의 README 내용을 설명하며, OpenAI Codex OAuth 프록시를 통해 이미지를 생성하는 Kimi CLI 스킬에 대한 상세 정보를 제공합니다. 이 스킬은 ChatGPT Plus 또는 Pro 구독을 요구하며, 텍스트 프롬프트를 사용하여 새로운 이미지를 생성하거나 기존 이미지를 스타일 변환(편집)하는 기능을 제공합니다.

핵심 방법론 및 기술적 세부 사항:

이 스킬은 OpenAI Codex API를 활용하여 이미지 생성 및 편집 기능을 구현합니다. 핵심적인 기술적 메커니즘은 다음과 같습니다:

1. OAuth 인증 및 프록시 관리:
   • 사용자는 먼저 npx @openai/codex login 명령을 실행하여 ~/.codex/auth.json 경로에 OAuth 세션 파일을 생성해야 합니다. 이 파일은 OpenAI Codex API에 대한 인증 토큰을 포함합니다.
   • 스킬은 실행 시 필요에 따라 자동으로 포트 10531에 OAuth 프록시 서버를 시작합니다. 이 프록시는 Kimi CLI 또는 스탠드얼론 스크립트가 OpenAI API와 안전하게 통신할 수 있도록 인증 정보를 중계하는 역할을 합니다.
   • 프록시 시작 실패 시 최대 3회까지 자동 재시도 로직이 내장되어 안정성을 높입니다. 스킬 종료 시 프록시는 자동으로 정리됩니다.

2. 이미지 생성 워크플로우:
   • 텍스트-이미지 생성 (generate.js): 사용자가 제공하는 텍스트 프롬프트(--prompt)를 OpenAI Codex API의 이미지 생성 엔드포인트로 전송하여 이미지를 생성합니다.
   • 이미지 편집/스타일 변환 (edit.js): 입력 이미지 파일(--input)과 편집 지시 프롬프트(--prompt)를 함께 OpenAI Codex API의 이미지 편집 엔드포인트로 전송하여, 기존 이미지를 변경하거나 특정 스타일로 변환합니다.

3. API 파라미터 제어: 스킬은 이미지 생성 및 편집 과정에서 다양한 API 파라미터를 제어할 수 있도록 합니다. 이는 config.json 파일을 통해 기본값을 설정하거나, CLI 인자(--quality, --size, --format, --n)를 통해 런타임에 오버라이드할 수 있습니다.
   • quality: low, medium, high 중 선택 가능한 이미지 품질 수준을 정의합니다. 이는 생성 이미지의 디테일 수준과 비용에 영향을 미칠 수 있습니다.
   • size: 1024x1024, 1024x1536, 1536x1024와 같은 다양한 해상도 및 종횡비를 지원합니다.
   • format: png, jpeg, webp 등 출력 이미지 파일 포맷을 지정합니다.
   • n: 병렬로 생성할 이미지의 개수를 1개부터 8개까지 지정할 수 있으며, 이를 통해 여러 개의 이미지를 동시에 요청하고 수신할 수 있습니다.

4. 파일 관리 및 무결성 검증:
   • 생성된 이미지는 사용자가 config.json에서 output_dir로 설정한 경로(기본값은 ~/Pictures/codex-images/)에 저장됩니다.
   • verify.js 스크립트 또는 자동화된 사후 검증 과정을 통해 생성된 PNG 파일의 유효성(손상 여부, 크기 등)을 검사하여 파일 무결성을 보장합니다.
   • 모든 이미지 생성 이력은 history.jsonl 파일에 기록되어 추적 및 관리가 용이합니다.

사용 방법:

이 스킬은 두 가지 방식으로 사용 가능합니다.

5. Kimi CLI 스킬로 설치: ~/.kimi/skills/ 디렉토리에 저장소를 git clone하여 설치하며, 이후 Kimi CLI를 통해 자연어 명령으로 이미지 생성을 요청할 수 있습니다 (예: "우주에 있는 고양이 이미지를 생성해줘").
6. 독립 실행형 스크립트: scripts/ 디렉토리 내의 generate.js, edit.js, verify.js Node.js 스크립트를 직접 실행하여 텍스트-이미지 생성, 이미지 편집, PNG 유효성 검증 등의 작업을 수행할 수 있습니다.

문제 해결:

일반적인 오류로는 "No OAuth session"(로그인 필요), "Proxy failed to start"(포트 10531 정리 필요), "401/403" 오류(OAuth 만료, 재로그인), "Rate limit"(잠시 후 재시도) 등이 문서에 명시되어 있으며, 각 문제에 대한 해결책이 제시되어 있습니다.

이 프로젝트는 MIT 라이선스를 따릅니다.