이미지 생성 스킬
현재 프로젝트(예: 웹사이트 에셋, 게임 에셋, UI 목업, 제품 목업, 와이어프레임, 로고 디자인, 포토리얼리스틱 이미지 또는 인포그래픽)를 위한 이미지를 생성하거나 편집합니다.
최상위 모드 및 규칙
이 스킬에는 정확히 두 가지 최상위 모드가 있습니다:
- 기본 내장 도구 모드 (권장): 이미지 생성, 편집 및 투명 이미지 요청을 위한 내장
image_gen도구.OPENAI_API_KEY가 필요하지 않습니다. - 폴백 CLI 모드:
scripts/image_gen.pyCLI. 사용자가 명시적으로 CLI/API/모델 경로를 요청하거나 확인할 때 사용합니다.OPENAI_API_KEY가 필요합니다.
CLI 폴백 내에서 CLI는 세 가지 하위 명령을 제공합니다:
generateeditgenerate-batch
규칙:
- 일반적인 이미지 생성 및 편집 요청에는 기본적으로 내장
image_gen도구를 사용합니다. - 일반적인 품질, 크기 또는 파일 경로 제어를 위해 CLI 폴백으로 전환하지 마십시오.
- 투명 이미지의 경우 내장
image_gen에 투명 배경을 요청하고 생성된 알파를 보존합니다. - 사용자가 명시적으로
gpt-image-1.5를 요청하지 않는 한, 내장image_gen또는 CLIgpt-image-2에서 CLIgpt-image-1.5로 자동 전환하지 마십시오. 먼저 사용자에게 물어보십시오. batch라는 단어 자체가 CLI 폴백을 의미하지는 않습니다. 사용자가 많은 에셋을 요청하거나 CLI/API/모델 제어를 명시적으로 요청하지 않고 배치 생성하라고 말하는 경우, 기본 경로를 유지하고 요청된 에셋 또는 변형당 하나의 내장 호출을 실행합니다.- 내장 도구가 실패하거나 사용할 수 없는 경우, 사용자에게 CLI 폴백이 존재하며
OPENAI_API_KEY가 필요하다고 알립니다. 사용자가 명시적으로 해당 폴백을 요청하는 경우에만 진행합니다. - 사용자가 명시적으로 CLI 모드를 요청하는 경우, 번들된
scripts/image_gen.py워크플로우를 사용합니다. 일회성 SDK 실행기를 만들지 마십시오. scripts/image_gen.py를 절대 수정하지 마십시오. 누락된 것이 있으면 다른 작업을 수행하기 전에 사용자에게 물어보십시오.
내장 저장 경로 정책:
- 내장 도구 모드에서 Codex는 생성된 이미지를 기본적으로
$CODEX_HOME/*에 저장합니다. - OS 임시 폴더를 기본 내장 대상으로 설명하거나 의존하지 마십시오.
- 내장
image_gen도구의 대상 경로 인수(있는 경우)를 설명하거나 의존하지 마십시오. 특정 위치가 필요한 경우 먼저 생성한 다음$CODEX_HOME/generated_images/...에서 선택한 출력을 이동하거나 복사합니다. - 내장 모드의 저장 경로 우선 순위:
- 사용자가 대상을 지정한 경우 선택한 출력을 해당 위치로 이동하거나 복사합니다.
- 이미지가 현재 프로젝트용인 경우, 최종 선택한 이미지를 작업 공간으로 이동하거나 복사합니다.
- 이미지가 미리 보기 또는 브레인스토밍용인 경우 인라인으로 렌더링합니다. 기본 파일은 기본
$CODEX_HOME/*경로에 남을 수 있습니다.
- 프로젝트에서 참조하는 에셋을 기본
$CODEX_HOME/*경로에만 두지 마십시오. - 사용자가 명시적으로 교체를 요청하지 않는 한 기존 에셋을 덮어쓰지 마십시오. 대신
hero-v2.png또는item-icon-edited.png와 같은 버전이 지정된 형제 파일 이름을 만듭니다.
두 모드 모두에 대한 공유 프롬프트 지침은 references/prompting.md 및 references/sample-prompts.md에 있습니다.
CLI 모드 전용 폴백 문서/리소스:
references/cli.mdreferences/image-api.mdreferences/codex-network.mdscripts/image_gen.py
사용 시기
- 새 이미지 생성 (컨셉 아트, 제품 사진, 표지, 웹사이트 히어로)
- 스타일, 구성 또는 분위기를 위한 하나 이상의 참조 이미지를 사용하여 새 이미지 생성
- 기존 이미지 편집 (인페인팅, 조명 또는 날씨 변환, 배경 교체, 개체 제거, 합성, 투명 배경)
- 하나의 작업에 대해 많은 에셋 또는 변형 생성
사용하지 말아야 할 시기
- 저장소 내 기존 SVG/벡터 아이콘 세트, 로고 시스템 또는 일러스트레이션 라이브러리 확장 또는 일치
- SVG, HTML/CSS 또는 캔버스에서 직접 생성하는 것이 더 나은 단순한 도형, 다이어그램, 와이어프레임 또는 아이콘 만들기
- 소스 파일이 이미 편집 가능한 네이티브 형식으로 존재할 때 소규모 프로젝트 로컬 에셋 편집
- 사용자가 생성된 비트맵 대신 결정론적 코드 네이티브 출력을 명확히 원하는 모든 작업
의사 결정 트리
두 가지 별개의 질문을 생각하십시오:
- 의도: 새 이미지입니까 아니면 기존 이미지의 편집입니까?
- 실행 전략: 하나의 에셋입니까 아니면 여러 에셋/변형입니까?
의도:
- 사용자가 기존 이미지의 일부를 보존하면서 수정하려는 경우 요청을 편집으로 취급합니다.
- 사용자가 스타일, 구성, 분위기 또는 주제 안내를 위한 참조로만 이미지를 제공하는 경우 요청을 생성으로 취급합니다.
- 사용자가 이미지를 제공하지 않는 경우 요청을 생성으로 취급합니다.
내장 편집 의미:
- 내장 편집 모드는 대화 컨텍스트에 이미 표시된 이미지(예: 첨부된 이미지 또는 스레드에서 이전에 생성된 이미지)를 위한 것입니다.
- 사용자가 내장 도구로 로컬 이미지 파일을 편집하려는 경우 먼저 내장
view_image도구로 로드하여 이미지가 대화 컨텍스트에 표시되도록 한 다음 내장 편집 흐름을 진행합니다. - 내장 도구를 통한 임의 파일 시스템 경로 편집을 약속하지 마십시오.
- 로컬 파일에 여전히 직접 파일 경로 제어, 마스크 또는 기타 명시적 CLI 전용 매개변수가 필요한 경우 사용자가 요청할 때만 명시적 CLI 폴백을 사용합니다.
- 편집의 경우 불변성을 적극적으로 보존하고 기본적으로 비파괴적으로 저장합니다.
실행 전략:
- 내장 기본 경로에서 요청된 에셋 또는 변형당 하나의
image_gen호출을 실행하여 많은 에셋 또는 변형을 생성합니다. - CLI 폴백 경로에서 사용자가 명시적으로 CLI 모드를 선택하고 많은 프롬프트/에셋이 필요할 때만 CLI
generate-batch하위 명령을 사용합니다. - 여러 개의 개별 에셋의 경우
n을 별도의 프롬프트 대용으로 사용하지 마십시오.n은 하나의 프롬프트에 대한 변형을 위한 것입니다. 개별 에셋에는 별도의 내장 호출 또는 별도의 CLIgenerate-batch작업이 필요합니다.
사용자가 명확하게 기존 이미지를 변경하도록 요청하지 않는 한 새 이미지를 원한다고 가정합니다.
워크플로우
- 최상위 모드 결정: 투명 출력 요청을 포함하여 기본적으로 내장; 명시적으로 요청되거나 확인된 경우에만 폴백 CLI.
- 의도 결정:
생성또는편집. - 출력이 미리 보기 전용인지 현재 프로젝트에서 사용할 것인지 결정.
- 실행 전략 결정: 단일 에셋 대 반복 내장 호출 대 CLI
generate-batch. - 입력 사전 수집: 프롬프트, 정확한 텍스트(그대로), 제약 조건/회피 목록 및 모든 입력 이미지.
- 모든 입력 이미지에 대해 역할을 명시적으로 레이블 지정:
- 참조 이미지
- 편집 대상
- 보조 삽입/스타일/합성 입력
- 편집 대상이 로컬 파일 시스템에만 있고 기본 경로를 유지하는 경우 먼저
view_image로 검사하여 이미지를 대화 컨텍스트에서 사용할 수 있도록 합니다. - 사용자가 사진, 일러스트레이션, 스프라이트, 제품 이미지, 배너 또는 기타 명시적 래스터 스타일 에셋을 요청한 경우 SVG/HTML/CSS 자리 표시자를 대체하지 말고
image_gen을 사용합니다. 요청이 기존 저장소 네이티브 SVG/벡터/코드 에셋과 일치해야 하는 아이콘, 로고 또는 UI 그래픽인 경우 대신 직접 편집하는 것이 좋습니다. - 특정성에 따라 프롬프트 증강:
- 사용자의 프롬프트가 이미 구체적이고 상세한 경우 창의적인 요구 사항을 추가하지 않고 명확한 사양으로 정규화합니다.
- 사용자의 프롬프트가 일반적인 경우 출력 품질을 실질적으로 향상시킬 때만 세련된 증강을 추가합니다.
- 기본적으로 내장
image_gen도구를 사용합니다. - 투명 출력 요청의 경우 내장
image_gen에 투명 배경을 요청하고 생성된 알파 채널을 보존합니다. - 출력을 검사하고 검증: 주제, 스타일, 구성, 텍스트 정확도 및 불변성/회피 항목.
- 단일 대상 변경으로 반복한 다음 다시 확인합니다.
- 미리 보기 전용 작업의 경우 이미지를 인라인으로 렌더링합니다. 기본 파일은 기본
$CODEX_HOME/generated_images/...경로에 남을 수 있습니다. - 프로젝트에 바인딩된 작업의 경우 선택한 아티팩트를 작업 공간으로 이동하거나 복사하고 사용 중인 모든 코드 또는 참조를 업데이트합니다. 프로젝트에서 참조하는 에셋을 기본
$CODEX_HOME/generated_images/...경로에만 두지 마십시오. - 배치 또는 다중 에셋 요청의 경우 사용자가 명시적으로 출력을 미리 보기 전용으로 유지하도록 요청하지 않는 한 요청된 모든 전달 가능한 최종본을 작업 공간에 유지합니다. 요청되지 않은 폐기된 변형은 보관할 필요가 없습니다.
- 사용자가 명시적으로 CLI 폴백을 선택하거나 확인하는 경우 모델, 품질, 크기,
input_fidelity, 마스크, 출력 형식, 출력 경로 및 네트워크 설정에 대한 폴백 전용 문서를 사용합니다. - 작업 공간에 바인딩된 모든 에셋에 대한 최종 저장 경로와 최종 프롬프트 또는 프롬프트 세트, 그리고 내장 도구 또는 폴백 CLI 모드가 사용되었는지 여부를 항상 보고합니다.
투명 이미지 요청
내장 image_gen에 진정한 투명 배경을 요청하고 알파를 보존합니다.
프롬프트 증강
사용자 프롬프트를 구조화된 프로덕션 지향 사양으로 재구성합니다. 사용자의 목표를 더 명확하고 실행 가능하게 만들지만 맹목적으로 세부 사항을 추가하지는 마십시오.
이를 폐쇄된 스키마가 아닌 프롬프트 형성 지침으로 취급하십시오. 도움이 되는 줄만 사용하고 명확성을 실질적으로 향상시킬 때 짧은 추가 레이블 줄을 추가하십시오.
특정성 정책
사용자 프롬프트의 특정성을 사용하여 얼마나 많은 증강이 적절한지 결정합니다:
- 프롬프트가 이미 구체적이고 상세한 경우 해당 특정성을 보존하고 정규화/구조화만 합니다.
- 프롬프트가 일반적인 경우 출력을 실질적으로 향상시킬 때 세련된 증강을 추가할 수 있습니다.
허용되는 증강:
- 구성 또는 프레이밍 힌트
- 연마 수준 또는 의도된 사용 힌트
- 실용적인 레이아웃 지침
- 명시된 요청을 지원하는 합리적인 장면 구체성
허용되지 않는 증강:
- 요청에 암시되지 않은 추가 캐릭터 또는 개체
- 암시되지 않은 브랜드 이름, 슬로건, 팔레트 또는 내러티브 비트
- 주변 레이아웃이 지원하지 않는 임의의 측면별 배치
사용 사례 분류 (정확한 슬러그)
각 요청을 다음 버킷 중 하나로 분류하고 프롬프트와 참조 전체에서 슬러그를 일관되게 유지합니다.
생성:
- photorealistic-natural — 실제 텍스처와 자연광이 있는 캔디드/에디토리얼 라이프스타일 장면.
- product-mockup — 제품/패키징 샷, 카탈로그 이미지, 상품 컨셉.
- ui-mockup — 앱/웹 인터페이스 목업 및 와이어프레임; 원하는 충실도를 지정합니다.
- infographic-diagram — 구조화된 레이아웃과 텍스트가 있는 다이어그램/인포그래픽.
- scientific-educational — 교실 설명자, 과학 다이어그램 및 필수 레이블과 정확성 제약 조건이 있는 학습 시각 자료.
- ads-marketing — 대상, 브랜드 포지션, 장면 및 정확한 태그라인/카피가 포함된 캠페인 컨셉 및 광고 크리에이티브.
- productivity-visual — 슬라이드, 차트, 워크플로우 및 데이터 중심 비즈니스 시각 자료.
- logo-brand — 로고/마크 탐색, 벡터 친화적.
- illustration-story — 만화, 어린이 책 아트, 내러티브 장면.
- stylized-concept — 스타일 중심 컨셉 아트, 3D/스타일화된 렌더링.
- historical-scene — 시대에 맞는/세계 지식 장면.
편집:
- text-localization — 이미지 내 텍스트 번역/교체, 레이아웃 유지.
- identity-preserve — 착용해보기, 장면 속 인물; 얼굴/신체/포즈 고정.
- precise-object-edit — 특정 요소 제거/교체 (내부 교체 포함).
- lighting-weather — 시간대/계절/대기 변화만.
- background-extraction — 투명 배경 / 깨끗한 컷아웃. 내장
image_gen에 실제 투명도를 요청합니다. - style-transfer — 주제/장면을 변경하면서 참조 스타일 적용.
- compositing — 일치하는 조명/원근법으로 다중 이미지 삽입/병합.
- sketch-to-render — 드로잉/라인 아트에서 포토리얼리스틱 렌더링으로.
공유 프롬프트 스키마
두 최상위 모드 모두에 대한 공유 프롬프트 구조로 다음 레이블이 지정된 사양을 사용합니다:
Use case: <분류 슬러그>
Asset type: <에셋이 사용될 위치>
Primary request: <사용자의 메인 프롬프트>
Input images: <이미지 1: 역할; 이미지 2: 역할> (선택 사항)
Scene/backdrop: <환경>
Subject: <주요 주제>
Style/medium: <사진/일러스트레이션/3D 등>
Composition/framing: <와이드/클로즈/탑다운; 배치>
Lighting/mood: <조명 + 분위기>
Color palette: <팔레트 노트>
Materials/textures: <표면 세부 사항>
Text (verbatim): "<정확한 텍스트>"
Constraints: <유지해야 할 것/피해야 할 것>
Avoid: <부정적 제약 조건>
참고:
Asset type및Input images는 프롬프트 구조이며 전용 CLI 플래그가 아닙니다.Scene/backdrop은 시각적 설정을 나타냅니다. 출력 투명도 동작을 제어하는 폴백 CLIbackground매개변수와 동일하지 않습니다.Quality:,Input fidelity:, 마스크, 출력 형식 및 출력 경로와 같은 폴백 전용 실행 노트는 CLI 경로에만 속합니다. 내장image_gen도구 인수로 취급하지 마십시오.
증강 규칙:
- 간결하게 유지합니다.
- 프롬프트를 실질적으로 개선하는 데 필요한 세부 사항만 추가합니다.
- 편집의 경우 불변성을 명시적으로 나열합니다(
X만 변경, Y는 변경하지 않고 유지). - 중요한 세부 사항이 누락되어 성공을 방해하는 경우 질문을 합니다. 그렇지 않으면 진행합니다.
예제
생성 예제 (히어로 이미지)
Use case: product-mockup
Asset type: landing page hero
Primary request: a minimal hero image of a ceramic coffee mug
Style/medium: clean product photography
Composition/framing: wide composition with usable negative space for page copy if needed
Lighting/mood: soft studio lighting
Constraints: no logos, no text, no watermark
편집 예제 (불변성)
Use case: precise-object-edit
Asset type: product photo background replacement
Primary request: replace only the background with a warm sunset gradient
Constraints: change only the background; keep the product and its edges unchanged; no text; no watermark
프롬프팅 모범 사례
- 프롬프트를 장면/배경 -> 주제 -> 세부 사항 -> 제약 조건 순서로 구성합니다.
- 모드와 연마 수준을 설정하기 위해 의도된 사용(광고, UI 목업, 인포그래픽)을 포함합니다.
- 포토리얼리즘에는 카메라/구성 언어를 사용합니다.
- 사용자가 명시적으로 벡터 출력 또는 비이미지 자리 표시자를 요청한 경우에만 SVG/벡터 대체물을 사용합니다.
- 정확한 텍스트를 인용하고 타이포그래피와 배치를 지정합니다.
[이하 생략됨]