APIYI GPT-Image 2 이미지 생성 스킬

개요

apiyi-gpt-image-2-gen 및 apiyi-gpt-image-2-all-gen는 커뮤니티 사용자 wuchubuzai2018이 기여한 두 가지 오픈소스 AI Agent Skill입니다. 단 한 번의 자연어 prompt를 통해 Codex CLI, OpenCode, Gemini CLI, GitHub Copilot, Cursor, Amp 및 모든 Skill 호환 도구에서 APIYI의 두 가지 OpenAI GPT 이미지 모델인 공식 gpt-image-2(정밀 제어, token 기반 과금, 4K) 및 역방향 gpt-image-2-all(대화형, 호출당 과금, ChatGPT와 동일한 사용성)을 직접 호출할 수 있습니다.

프로젝트 정보

🔗 소스: github.com/wuchubuzai2018/expert-skills-hub
📦 Skill ID: apiyi-gpt-image-2-gen(공식), apiyi-gpt-image-2-all-gen(역방향)
👤 작성자: wuchubuzai2018
⭐ 커뮤니티 기여 항목으로, 작성자의 Nano Banana Pro 이미지 생성 Skill과 동일한 저장소를 공유합니다.

어떤 Skill을 선택해야 하나요?

apiyi-gpt-image-2-gen(공식, 권장): size / quality / output-format / compression 제어 가능, 4K(3840×2160), 사용자 정의 크기 및 의미론적 편집 지원, token 기반 과금 — 구체적인 품질이나 크기 요구사항이 있는 경우에 가장 적합합니다.
apiyi-gpt-image-2-all-gen(역방향): prompt와 선택 사항인 response-format만 필요, prompt에서 크기/비율 지정, 호출당 과금($0.025/호출), ChatGPT 웹 경험과 동일 — 자연어 직접 출력, 뛰어난 텍스트 렌더링, 반복적인 수정 작업에 가장 적합합니다.
전체 상세 비교: 공식 vs 역방향 비교

핵심 기능

한 문장 이미지 생성

AI 코딩 어시스턴트 안에서 중국어나 영어로 바로 설명하면 이미지를 받아볼 수 있습니다

듀얼 모델 지원

공식 gpt-image-2와 역방향 gpt-image-2-all를 모두 사용할 수 있습니다 — 상황에 따라 선택하십시오

4K + 사용자 지정 크기 (공식)

공식 Skill은 1024², 1536×1024, 2048², 3840×2160 프리셋과 사용자 지정 크기를 지원합니다

품질 / 형식 제어 (공식)

quality (낮음 / 중간 / 높음 / 자동) + 출력 형식 (png / jpeg / webp) + 압축 0-100

최대 5장의 참조 이미지

두 기능 모두 다중 이미지 융합과 스타일 전이를 위해 최대 5장의 중첩된 참조 이미지를 지원합니다

다중 도구 호환

Codex CLI, OpenCode, Gemini CLI, GitHub Copilot, Cursor, Amp에서 작동합니다

Node.js + Python 런타임

generate_image.js와 generate_image.py를 모두 제공합니다

간편한 설정

APIYI_API_KEY를 한 번만 설정하고, 임시 재정의에는 -k를 사용합니다

APIYI 지원 모델

모델	모델 ID	기능	과금	API 문서
GPT-Image 2 (공식, 권장)	`gpt-image-2`	`apiyi-gpt-image-2-gen`	token당 종량 과금	보기
GPT-Image 2 All (리버스)	`gpt-image-2-all`	`apiyi-gpt-image-2-all-gen`	호출당 $0.025	보기

빠른 시작: 3단계

단계 1: APIYI 키를 가져오기

APIYI 콘솔에 방문하여 로그인합니다
Tokens에서 새 키를 생성합니다(sk-로 시작함)
권장: 사용 한도가 있는 전용 키를 생성합니다

신규 사용자는 무료 체험 크레딧을 받습니다 — 두 GPT 이미지 모델을 모두 시험해 볼 수 있을 만큼 충분합니다.

단계 2: 스킬을 설치합니다 — 하나를 선택하거나 둘 다 설치합니다

공식 gpt-image-2 (권장):

npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill apiyi-gpt-image-2-gen

리버스 gpt-image-2-all:

npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill apiyi-gpt-image-2-all-gen

Node.js가 필요합니다. Python 스크립트는 대체 런타임으로 사용할 수 있습니다. Node.js가 설치되어 있지 않다면 nodejs.org에서 설치하시면 됩니다.

단계 3: API 키를 구성합니다

환경 변수를 설정합니다(~/.zshrc / ~/.bashrc에 영구 설정하는 것을 권장합니다):

export APIYI_API_KEY="sk-your-apiyi-key"

Windows PowerShell:

$env:APIYI_API_KEY="sk-your-apiyi-key"

완료되었습니다! 이제 Skills 호환 AI 코딩 도구라면 자연어로 두 스킬을 호출할 수 있습니다.

명령줄 매개변수

`apiyi-gpt-image-2-gen` (공식)

매개변수	단축	필수	설명	예시
`--prompt`	`-p`	예	생성 prompt 또는 편집 지시사항	`"An orange cat on grass"`
`--filename`	`-f`	아니오	출력 경로(생략 시 자동으로 타임스탬프가 추가됩니다)	`"cat.png"`
`--size`	`-s`	아니오	프리셋(`1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` / `2048x1152` / `3840x2160` / `2160x3840`) 또는 사용자 지정	`"2048x1152"`
`--quality`	`-q`	아니오	`low` / `medium` / `high` / `auto`	`"high"`
`--output-format`	`-o`	아니오	`png` (기본값) / `jpeg` / `webp`	`"webp"`
`--output-compression`	`-c`	아니오	0-100 (jpeg / webp only)	`80`
`--input-image`	`-i`	아니오	참조 이미지, 최대 5개	`"portrait.png"`
`--api-key`	`-k`	아니오	한 번의 호출에 대해 환경 변수를 재정의	`"sk-xxx"`

지원되는 가로세로 비율: 1:1, 3:2, 2:3, 16:9, 9:16, 그리고 3:1 이내의 모든 사용자 지정 비율입니다. 사용자 지정 크기 제약: 각 변은 3840px 이하여야 하며, 두 차원 모두 16으로 나누어떨어져야 하고, 총 픽셀 수는 655,360에서 8,294,400 사이여야 합니다. 일반적인 지연 시간: 요청당 120–150초입니다(복잡한 4K 장면은 더 오래 걸립니다).

`apiyi-gpt-image-2-all-gen` (역방향)

매개변수	단축	필수	설명	예시
`--prompt`	`-p`	예	대화형 prompt(크기/비율은 prompt 안에 설명됨)	`"widescreen 16:9 cyberpunk city"`
`--filename`	`-f`	아니오	출력 경로(생략 시 자동으로 타임스탬프가 추가된 PNG)	`"city.png"`
`--response-format`	`-r`	아니오	`url`(기본값, R2 CDN에서 약 24시간 유효) 또는 `b64_json`	`"b64_json"`
`--input-image`	`-i`	아니오	참조 이미지, 최대 5개	`"ref.png"`
`--api-key`	`-k`	아니오	한 번의 호출에 대해 환경 변수를 재정의	`"sk-xxx"`

reverse 기능은 size / quality / aspect_ratio CLI 플래그를 허용하지 않습니다 — 그 모든 내용을 prompt에 설명하십시오(예: "vertical 9:16 mobile poster", "1024x1024 square"). 지연 시간: 60–300초.

사용 예시

예시 1: 정밀 제어가 가능한 공식 텍스트-투-이미지

node scripts/generate_image.js \
  -p "Cinematic product shot of a minimalist ceramic teacup, soft morning light, 35mm lens" \
  -f "teacup.png" \
  -s "3840x2160" \
  -q "high" \
  -o "png"

예시 2: 공식 이미지 편집(참조 이미지)

node scripts/generate_image.js \
  -p "replace the background with a sunset beach, keep the subject intact" \
  -i "portrait.png" \
  -f "portrait-beach.jpg" \
  -s "2048x1152" \
  -q "high" \
  -o "jpeg" \
  -c 85

예시 3: 공식 다중 이미지 융합

node scripts/generate_image.js \
  -p "put the person from img 1 into the scene from img 2, lighting style from img 3" \
  -i person.png scene.png light.png \
  -f merged.png \
  -q high

예시 4: 역방향 대화식(prompt로 크기 지정)

node scripts/generate_image.js \
  -p "widescreen 16:9 cinematic frame: a girl in hanfu under cherry blossoms, watercolor style, soft light" \
  -f "sakura.png" \
  -r url

예시 5: AI 코딩 도구에서 호출하기

설치한 후에는 Cursor / Codex CLI 등에서 어시스턴트에게 다음과 같이 요청하기만 하면 됩니다:

“apiyi-gpt-image-2-gen을 사용해 3840x2160 고화질 사이버펑크 도시 배경화를 생성해 주세요”
“apiyi-gpt-image-2-all-gen을 호출해 photo.jpg를 Studio Ghibli 스타일로 변환해 주세요”
“공식 스킬을 사용해 1:1 로고를 고화질, webp 형식으로 생성해 주세요”

어시스턴트가 적절한 스킬을 선택하고 CLI 플래그를 알아서 구성해 줍니다.

자주 묻는 질문

어떤 스킬을 선택해야 합니까?

정확한 크기(예: 3840×2160), 품질 등급(low/medium/high) 또는 특정 출력 형식(webp / 압축)이 필요한 경우 → 공식 apiyi-gpt-image-2-gen 선택
ChatGPT 수준의 대화 흐름, 호출당 고정 요금($0.025), 강력한 텍스트 렌더링을 선호하며 크기를 자연어로 표현해도 괜찮은 경우 → 리버스 apiyi-gpt-image-2-all-gen 선택
전체 비교: 공식 vs 리버스 비교

npx skills 설치 실패

Node.js가 설치되어 있는지 확인합니다 (node -v)
GitHub 네트워크 접근을 확인합니다
npx skills을(를) 사용할 수 없는 경우, 수동으로 clone합니다:

git clone https://github.com/wuchubuzai2018/expert-skills-hub.git

그런 다음 skills/apiyi-gpt-image-2-gen 또는 skills/apiyi-gpt-image-2-all-gen 중 하나를 로컬 Skills 디렉터리에 복사합니다.

API 키 유효하지 않음 오류

APIYI_API_KEY이(가) 올바르게 설정되었는지 확인합니다 (sk-(으)로 시작)
잔액 — 잔액은 충분해 보이지만 호출에 실패함 참조
빠른 테스트를 위해 인라인으로 -k "sk-xxx"을(를) 전달합니다

공식 스킬에서 사용자 지정 크기를 거부합니다

사용자 지정 size은(는) 다음 조건을 충족해야 합니다:

각 변 ≤ 3840px
가로/세로 모두 16으로 나누어떨어짐
총 픽셀 수 655,360 ~ 8,294,400 사이 예를 들어 2048x3072은(는) 유효하지만, 3000x2000은(는) 3000이 16으로 나누어떨어지지 않아 거부됩니다.

리버스 스킬의 URL은 얼마 동안 유효합니까?

리버스 스킬의 기본 R2 CDN URL은 약 24시간 동안 유효합니다. 프로덕션 환경에서는 -r b64_json을(를) 전달하여 Base64로 받아 로컬에 영구 저장하거나, 에셋을 즉시 다운로드하십시오.

어떤 AI 코딩 도구가 지원됩니까?

테스트 완료: Codex CLI, OpenCode, Gemini CLI, GitHub Copilot, Cursor, Amp. Skills와 호환되는 도구라면 모두 작동합니다.

gpt-image-2 (공식) 문서

네이티브 2K/4K 생성, token당 과금

gpt-image-2-all (리버스) 문서

ChatGPT와 동등한 기능, 호출당 $0.025

공식 vs 리버스 비교

17가지 기준 상세 비교

Nano Banana Pro Skill (동일 제작자)

동일한 저장소의 자매 Skill — Gemini 이미지 생성

Luck GPT-Image 2 ComfyUI 노드

동일한 모델, ComfyUI 노드 버전

APIYI 콘솔

키, 사용량 및 채널 관리

개요

대화형 AI

프로그래밍

커뮤니티 기여

AI 에이전트

엔지니어링

번역

APIYI GPT-Image 2 이미지 생성 스킬

개요

핵심 기능

한 문장 이미지 생성

듀얼 모델 지원

4K + 사용자 지정 크기 (공식)

품질 / 형식 제어 (공식)

최대 5장의 참조 이미지

다중 도구 호환

Node.js + Python 런타임

간편한 설정

APIYI 지원 모델

빠른 시작: 3단계

명령줄 매개변수

`apiyi-gpt-image-2-gen` (공식)

`apiyi-gpt-image-2-all-gen` (역방향)

사용 예시

예시 1: 정밀 제어가 가능한 공식 텍스트-투-이미지

예시 2: 공식 이미지 편집(참조 이미지)

예시 3: 공식 다중 이미지 융합

예시 4: 역방향 대화식(prompt로 크기 지정)

예시 5: AI 코딩 도구에서 호출하기

자주 묻는 질문

관련 리소스

gpt-image-2 (공식) 문서

gpt-image-2-all (리버스) 문서

공식 vs 리버스 비교

Nano Banana Pro Skill (동일 제작자)

Luck GPT-Image 2 ComfyUI 노드

APIYI 콘솔

​개요

​핵심 기능

한 문장 이미지 생성

듀얼 모델 지원

4K + 사용자 지정 크기 (공식)

품질 / 형식 제어 (공식)

최대 5장의 참조 이미지

다중 도구 호환

Node.js + Python 런타임

간편한 설정

​APIYI 지원 모델

​빠른 시작: 3단계

​명령줄 매개변수

​apiyi-gpt-image-2-gen (공식)

​apiyi-gpt-image-2-all-gen (역방향)

​사용 예시

​예시 1: 정밀 제어가 가능한 공식 텍스트-투-이미지

​예시 2: 공식 이미지 편집(참조 이미지)

​예시 3: 공식 다중 이미지 융합

​예시 4: 역방향 대화식(prompt로 크기 지정)

​예시 5: AI 코딩 도구에서 호출하기

​자주 묻는 질문

​관련 리소스

gpt-image-2 (공식) 문서

gpt-image-2-all (리버스) 문서

공식 vs 리버스 비교

Nano Banana Pro Skill (동일 제작자)

Luck GPT-Image 2 ComfyUI 노드

APIYI 콘솔

개요

핵심 기능

APIYI 지원 모델

빠른 시작: 3단계

명령줄 매개변수

`apiyi-gpt-image-2-gen` (공식)

`apiyi-gpt-image-2-all-gen` (역방향)

사용 예시

예시 1: 정밀 제어가 가능한 공식 텍스트-투-이미지

예시 2: 공식 이미지 편집(참조 이미지)

예시 3: 공식 다중 이미지 융합

예시 4: 역방향 대화식(prompt로 크기 지정)

예시 5: AI 코딩 도구에서 호출하기

자주 묻는 질문

관련 리소스