Community이미지github.com

openai-img-gen

OpenAI 이미지 모델을 사용하여 이미지를 생성하거나 편집합니다. 사용자가 생성, 제작, 그리기, 렌더링, 일러스트레이션, 목업, 컨셉 아트, 로고 아이디어 또는 사진을 요청하거나, 기존 사진이나 이미지를 편집, 색상 변경, 스타일 변경, 합성하라고 할 때 사용합니다(OpenAI를 언급하지 않아도 됩니다).

openai-img-gen란 무엇인가요?

이 스킬은 Node.js 18.3+ 환경에서 OpenAI Images API를 호출하여 이미지를 생성하거나 편집하는 도구입니다. 사용자가 텍스트 프롬프트를 제공하면 새로운 이미지를 만들거나, 기존 이미지를 업로드하여 편집, 색상 변경, 스타일 변경, 합성 등을 수행합니다. CLI 도구로 설계되어 `-i` 옵션 없이 실행하면 새로운 이미지를 생성하고, `-i` 옵션으로 이미지를 전달하면 편집 또는 합성을 진행합니다. 생성된 이미지는 지정된 출력 디렉토리에 저장되며, 프롬프트 파일도 함께 저장되어 추적이 용이합니다. 이 스킬은 비용이 발생하므로, 저품질(draft) 옵션을 활용하거나 생성 수를 제한하여 효율적으로 사용할 수 있습니다. 또한 중재 필터에 의해 차단된 요청에 대해서는 재시도하지 않고 대체 프롬프트를 제안하도록 안내합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kingfishx23/openai-img-gen/tree/HEAD/skills/openai-img-gen

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

openai-img-gen은(는) 무엇을 하나요?

이 스킬 디렉토리의 index.js는 OpenAI Images API를 호출합니다. 종속성이 없으며 Node 18.3+가 필요합니다.

node <이 스킬 디렉토리>/index.js [옵션] "프롬프트"
node <이 스킬 디렉토리>/index.js -i photo.jpg -i reference.png [옵션] -f prompt.txt

-i 없이 실행하면 새 이미지를 생성합니다. -i를 사용하면 제공된 이미지를 편집하거나 합성합니다. 각 저장된 파일의 절대 경로를 stdout으로 출력하고, 프롬프트를 이미지와 함께 <이름>-<시간>.prompt.txt로 저장합니다. 진행 상황, 토큰 사용량, 비용 및 오류는 stderr로 출력됩니다. 모든 옵션을 보려면 --help를 실행하세요. 주요 옵션은 -p NAME (프로젝트 하위 폴더), -o DIR (정확한 폴더), --name PREFIX, -s auto|1024x1024|1536x1024|1024x1536, -q auto|low|medium|high, -n COUNT, --format png|jpeg|webp 및 --background transparent입니다.

이미지 저장 위치: -p NAME과 함께 사용하면 $OPENAI_IMG_GEN_OUT/NAME/에 저장됩니다. 기본 폴더는 이 스킬의 .env 파일에 설정되며, 설정되지 않은 경우 현재 폴더입니다. -o DIR은 이를 무시하고 정확히 해당 디렉토리에 저장합니다.

단계

  1. 프롬프트 작성. 문장이 길다면 파일에 작성하고 -f로 전달하세요. 아래 "프롬프트 작성"을 참조하세요.
  2. 실행. 항상 -p를 전달하며, 현재 작업 중인 브랜드, 제품, 리포지토리 또는 폴더(예: -p es-sebelas 또는 -p kualing)의 짧은 이름을 프로젝트 컨텍스트로 지정하세요. 프로젝트가 없으면 짧은 주제를 사용하세요. -o는 사용자가 폴더를 직접 지정한 경우에만 사용하세요. 설명적인 --name을 사용하세요. 각 호출마다 비용이 발생합니다. -q auto에서 한 장의 이미지는 일반적으로 몇 센트이며, high와 -n은 비용을 배가시킵니다. 빠른 초안에는 -q low를 사용하고, 4장 이상 또는 많은 고품질 이미지를 생성하기 전에 요청하세요.
  3. 결과 보기. 저장된 파일을 Read 도구로 열어 확인하세요. 프롬프트(텍스트 철자, 변경되지 않아야 할 내용)와 일치하는지 확인한 후, 사용자에게 경로, 보이는 내용 및 비용 라인을 알려주세요.
  4. 반복. 잘못된 부분을 기반으로 프롬프트를 변경하고, 프롬프트 파일을 업데이트하여 최상의 결과와 일치하도록 유지하세요.

API 키가 없는 경우, 사용자에게 OPENAI_API_KEY를 설정하거나, 이 스킬 디렉토리의 .env.example을 .env로 복사하여 채워 넣도록 알리세요. 절대 키를 채팅에 붙여넣도록 요청하지 마세요. 요청이 중재에 의해 차단된 경우, 스크립트가 출력한 이유를 보고하고 대체 프롬프트를 제안하세요. 동일한 프롬프트를 재시도하지 마세요.

프롬프트 작성

  • 각 입력 이미지의 용도를 순서대로 설명하세요. "첫 번째 이미지는 색상 참조용입니다. 레이아웃, 모양 또는 텍스트를 복사하지 마세요. 두 번째 이미지는 편집할 사진입니다. 프레이밍과 형식을 유지하세요."
  • 하나의 명확한 작업을 제시하고, 구체적인 값(16진수 색상, 재질, 위치)으로 변경할 사항을 정확히 나열하세요.
  • 변경되지 않아야 할 사항을 나열하세요. 편집의 경우 "다른 모든 것은 그대로 유지"라고 말하고 변경되지 않아야 할 것들(카메라 각도, 조명, 배경, 인물, 기타 건물 등)을 지정하세요.
  • 나타나야 할 텍스트는 정확한 철자로 인용하세요("정확히 'ES SEBELAS'로 읽힘"). 텍스트는 적게 요청하세요: 이미지 모델은 긴 텍스트를 잘못 철자합니다.
  • 스타일 지정: 사실적, 평면 벡터, 수채화, 3D 렌더링 등.
  • 예상되는 실패에 대해 "피할 것:" 줄로 끝내세요. 예: 추가 텍스트, 참조 레이아웃 복사, 대상 외부의 모든 변경.
  • 로고와 아이콘은 단색 또는 투명 배경: --background transparent --format png.

관련 스킬