Codex 이미지은(는) 무엇을 하나요?
Codex에 내장된 이미지 도구로 만든 이미지입니다. 터미널에서 실행됩니다: 이미지당 하나의 codex exec, 여러 개를 동시에 실행합니다. ChatGPT 플랜(Plus 또는 Pro)을 사용하며 API 키는 필요 없습니다.
사용자 언어로 대화합니다. <out> = 출력 폴더: 비디오의 경우 video-agent/edits/<slug>/images/, 그 외에는 video-agent/images/<name>/입니다.
1. Codex (한 번만)
codex --version
codex login status
- 설치되지 않은 경우:
npm i -g @openai/codex(Node 20+ 필요) 또는 macOS에서brew install codex. - 로그인되지 않은 경우: 사용자가 직접
codex login을 실행합니다(브라우저가 열리며 "ChatGPT로 로그인"이 표시됨). 채팅에서 OpenAI 키나 비밀번호를 절대 요청하지 마세요.
2. 브리핑
한 이미지 = 하나의 프롬프트. 여러 아이디어를 하나의 작업에 절대 넣지 마세요.
한 메시지에 누락된 것만 물어보세요:
- 용도: 썸네일(1280x720, 16:9), 쇼트 커버(1080x1920, 9:16), 정사각형 게시물(1:1), 이미지 보드 또는 B-roll용 스틸(비디오 형식에 따름).
- 개수: 기본 1개; 썸네일의 경우 3가지 변형(각각 다른 아이디어, 같은 아이디어를 세 번 반복하지 않음).
- 얼굴: 제작자가 포함된 썸네일에는 1~3장의 선명한 사진이 필요합니다(테이크의 한 프레임 사용 가능:
ffmpeg -v error -y -ss <t> -i <take> -frames:v 1 -q:v 2 <out>/ref-face.jpg). 절대 경로를 전달하세요.
각 프롬프트는 영어로 구체적으로 작성하세요: 피사체, 프레이밍, 배경, 조명, 색상, 이미지 위의 텍스트(최대 3단어, 정확히 따옴표로 묶고 비디오 언어로 작성), 형식. 썸네일의 경우: 하나의 피사체, 크고 읽기 쉬운 텍스트, 강한 대비, 명확한 감정을 가진 얼굴, 오른쪽 하단 모서리에는 아무것도 없어야 함(YouTube가 재생 시간을 표시함). 이미지의 모든 주장은 비디오에서 가져옵니다.
프롬프트를 번호가 매겨진 목록으로 보여주고 승인을 기다리세요(각 이미지는 Codex 사용 제한의 일부를 사용합니다).
3. 생성
프롬프트당 하나의 작업, 최대 3개를 동시에, 각각 백그라운드에서 실행합니다. 항상 < /dev/null로 끝내야 합니다(이것 없이는 codex exec가 입력을 영원히 기다립니다), 마지막 메시지는 파일에 저장합니다:
mkdir -p <out>/logs
codex exec --skip-git-repo-check -s workspace-write -C "$PWD" \
--output-last-message <out>/logs/<n>-<name>.txt \
"내장 image_gen 도구를 사용하여 아래 프롬프트에 대해 정확히 하나의 래스터 이미지를 생성합니다. 어떤 파일도 편집하지 마세요. 질문하지 마세요. SVG, HTML, 플레이스홀더는 안 됩니다.
참조 이미지(image_gen에 referenced_image_paths로 전달): <절대 경로, 또는 없음>
완료되면 정확히 다음 두 줄로 답변하세요:
ASSET_NAME: <kebab-case-name>
IMAGE_PATH: <생성된 이미지의 절대 경로>
이미지 프롬프트:
<프롬프트>" \
< /dev/null > <out>/logs/<n>-<name>.log 2>&1
작업은 약 1~3분이 소요됩니다. 종료되면 .txt 파일을 읽고 IMAGE_PATH를 가져와 이미지를 복사합니다:
cp "<IMAGE_PATH>" <out>/<n>-<name>.png
답변에 IMAGE_PATH가 없는 경우: 작업 시작 후 생성된 ~/.codex/generated_images/에서 가장 최근 파일(ls -t ~/.codex/generated_images/*/* | head -3)을 찾습니다. 새로운 파일이 없으면 작업이 실패한 것입니다. 해당 .log의 끝부분(보통 사용 제한에 도달했거나 codex login이 필요한 경우)을 보여주고 해당 작업을 다시 한 번 실행합니다.
4. 확인 및 전달
- 프롬프트당 하나의 이미지이며, 동일한 이미지가 두 개 없어야 합니다 (
shasum <out>/*.png). - 크기:
sips -g pixelWidth -g pixelHeight <file>(macOS) 또는ffprobe -v error -show_entries stream=width,height -of csv=p=0 <file>. 썸네일은 16:9여야 합니다: ffmpeg로 잘라내거나 1280x720으로 크기 조정(-vf "scale=1280:720:force_original_aspect_ratio=increase,crop=1280:720"), 2MB 미만의 JPG로 저장합니다. - 각 이미지를 확인합니다: 텍스트 철자가 올바른지, 얼굴이 닮았는지, 이상한 점(손, 추가 문자 등)이 없는지 확인합니다. 잘못된 이미지: 프롬프트를 수정하고 해당 이미지를 다시 생성합니다.
<out>/manifest.json을 작성합니다: 이미지당 하나의 항목으로 file, prompt, refs, date를 포함합니다. 이미지를 보여준 후:
- 썸네일 또는 커버:
/publish는<edit>/images/를 사용합니다(사용자가 하나를 선택하면<edit>/cover.jpg로 복사되며, 커버와 YouTube 썸네일이 됩니다). - 비디오용 스틸:
/short-editing에서 보드에img항목으로 배치할 수 있습니다(쇼트의assets/images/에 복사).
모든 것이 완료되면 <out>/logs/를 삭제합니다.
정직한 한계
- 이미지 도구는 OpenAI의 것으로, Codex 내부에 있습니다: 결과는 이 도구에 따라 달라지며 변경될 수 있습니다. 이미지 위의 텍스트는 철자가 틀릴 수 있습니다: 항상 확인하세요.
- 참조 사진의 얼굴은 비슷하지만 완벽하지는 않습니다. 썸네일의 경우 실제 사진이 가장 안전합니다.
- 각 이미지는 ChatGPT 플랜의 Codex 사용 제한에 영향을 미칩니다; 제한에 도달하면 기다리거나 더 높은 플랜으로 업그레이드해야 합니다.
- 동의를 얻은 사람의 사진만 사용하고, 소유권이 없는 로고나 캐릭터는 사용하지 마세요.