Codex 이미지 작업
모든 프로젝트 또는 배치 이미지 작업은 러너를 통해 실행하십시오. 이러한 작업에 대해 codex exec 또는 codex-imagegen을 수동으로 호출하지 마십시오.
python scripts/codex_image.py "<프롬프트 또는 @prompt.txt>" out.png [--ref room.jpg] [--size 1536x1024] [--force]
절대 출력 경로를 출력합니다. Bash 호출은 러너 자체의 --timeout(기본값 420초)보다 높은 타임아웃 값을 설정하십시오.
| 종료 코드 | 의미 | 조치 |
|---|---|---|
| 0 | 저장됨 | 이미지 확인 |
| 1 | 사용법 오류 (예: 출력 파일이 이미 존재함) | 호출 수정; --force는 출력을 덮어쓰지만, 자신의 참조는 덮어쓰지 않음 |
| 2 | Codex가 이미지 없이 종료됨 | 출력 내용 읽고 원인을 수정한 후 한 번 재시도 |
| 3 | 이미지 호출이 참조를 포함하지 않아 저장되지 않음 | 동일한 명령으로 한 번 재시도 |
| 124 | 시간 내 세션 또는 이미지가 없음 | codex login status 및 네트워크 확인 |
규칙
- 모든 출력을 요구 사항과 비교하여 확인하십시오. 종료 코드 0은 이 세션에서 하나의 이미지가 생성되었음을 의미할 뿐, 올바른 이미지임을 보장하지 않습니다.
- 체인 편집은 한 번에 하나의 변경씩 수행하십시오: 각 출력이 다음
--ref가 됩니다. 각 단계마다 새 파일에 저장하십시오. - 방을 유지하십시오: 변경하지 말아야 할 사항(카메라, 지오메트리, 개구부)을 명시하고, 참조가 두 개 이상일 때 각 참조의 역할을 이름으로 지정하십시오. 최대 4개의 참조까지 가능합니다.
- 할당량을 계산하십시오. 한 번 실행에 하나의 이미지 할당량이 소모되며, 여러 실행을 병렬로 수행할 수 있습니다. 대규모 배치 전에 할당량 개수를 확인하고 첫 번째 이미지가 제대로 작동하는지 확인한 후 나머지를 진행하십시오.
- 알파 채널이 있는 PNG 참조:
--keep-png-refs를 전달하십시오. JPG 변환은 알파 채널을 평평하게 만듭니다.
러너가 존재하는 이유
2026-11-04, codex-cli 0.164.0에서 측정된 내용입니다. 30회의 이미지 실행 세션 로그를 기반으로 합니다.
| 실패 유형 | 원인 | 러너의 대처 |
|---|---|---|
| 타임아웃까지 행잉 | codex exec가 열린 stdin 파이프를 기다림: 파이프가 열려 있으면 45초(타임아웃으로 중단), 닫혀 있으면 4초 | 프롬프트를 stdin으로 보낸 후 닫음 |
| 잘못된 파일명 아래에 다른 이미지 저장 | 저장하라는 지시에 Codex가 공유된 ~/.codex/generated_images를 검색, 가장 최근 것을 가져와 다른 실행의 사진을 복사 | Codex가 직접 저장하지 않도록 함; 러너는 generated_images/<해당 세션 id>/만 읽음 |
| 하나의 출력을 위해 최대 7번의 이미지 호출 | Codex가 저장 방법을 찾지 못해 다시 생성 | 첫 번째 완전한 이미지에서 Codex 중단 |
| 참조 무시, 방 새로 생성 | 이미지 도구는 num_last_images_to_include가 설정된 경우에만 첨부 파일을 봄 | 매개변수 이름을 지정하고, 세션 로그를 읽고, 누락된 경우 종료 코드 3 반환 |
| 체인 편집 시 방 정보 손실 | 가구 편집을 할 때마다 PNG를 전달하면 정보 손실; JPG와 명명된 매개변수를 사용하면 유지됨 (상관관계, 입증된 원인은 아님) | ffmpeg가 PATH에 있을 때 PNG 참조를 JPG로 변환 |
실제 CLI로 같은 날 확인: 세 번의 편집 중 두 번은 PNG 참조에 대해 병렬로 수행되었으며, 각각 약 25초와 한 번의 이미지 호출이 소요되었고, 각각의 색상 변경이 유지되었습니다.
플러그인의 codex-imagegen을 반드시 사용해야 하는 경우
codex-bridge 1.2.0에는 이러한 실패가 있습니다. </dev/null로 호출하고, 한 번에 하나의 작업만 수행하며, JPG 참조를 사용하고, 프롬프트에 "정확히 한 번 num_last_images_to_include:1로 이미지 도구를 호출"이라고 명시한 후 결과를 확인하십시오.