Codex로 이미지 폴더의 캡션과 대체 텍스트를 CSV로 만드는 방법

Codex가 이미지 폴더를 분석해 캡션과 대체 텍스트 CSV를 만드는 과정

2026년 10월 7일 실제 재검증 · AI 실험실

이미지 폴더 3장을 Codex로 직접 읽혀 캡션과 대체 텍스트 CSV를 만들었습니다. 이번에는 “여기에 캡처가 들어갑니다”가 아니라, 입력 파일·실행 계획·생성 결과를 모두 실제 자료로 남겼습니다.

사진 한 장은 눈으로 보고 바로 설명할 수 있습니다. 문제는 홈페이지 이미지가 수십 장일 때입니다. 파일마다 캡션과 ALT를 만들고, 빠진 항목과 애매한 표현을 다시 찾는 순간 일이 급격히 지루해집니다. 그래서 이번 실험의 목표는 AI가 게시까지 해버리는 자동화가 아니라, 사람이 빠르게 검수할 수 있는 CSV를 만드는 반자동화입니다.

결론부터: JPG·PNG·GIF 3장을 넣어 CSV 3행을 만들었고, 애매한 이미지 1장은 needs_review=yes로 분리했습니다. 입력 파일의 SHA-256 해시는 실행 전후 동일했습니다.
QUICK INDEX

1. 테스트용 이미지 폴더를 실제로 만들었습니다

개인 사진이나 고객 자료 대신, 직접 만든 공개 가능한 이미지 3장을 복사해 테스트했습니다. 형식도 일부러 JPG·PNG·GIF로 나눴습니다.

JPG, PNG, GIF 형식의 샘플 이미지 3장과 파일 크기, SHA-256 값을 정리한 실험 입력 화면
입력 폴더 기록. 원본은 읽기만 하고 결과는 별도 output 폴더에 저장했습니다.
sample-01.jpg정리 전후를 표현한 업무 장면. 1672×941, 313,681바이트.
sample-02.png달 찜질방 레트로 SF 장면. 1536×1024, 3,558,280바이트.
sample-03.gif일주일 일정 실험 전후 도표. 1672×941, 204,758바이트.

세 이미지는 모두 이 실험을 위해 만든 샘플입니다. 실제 인물의 개인정보, 주소, 문서 번호는 들어 있지 않습니다. GIF도 애니메이션이 아닌 정지 이미지로 변환해 사용했습니다.

2. Codex가 쓰기 전에 확인한 것

처음부터 “ALT 만들어줘”라고만 하면 결과 형식도, 저장 위치도, 추측을 처리하는 방식도 제각각이 됩니다. 그래서 대상 파일과 쓰기 범위를 먼저 고정했습니다.

입력 파일 스캔, 해시 기록, 이미지 분석, 검수 표시, CSV 쓰기, 결과 검증의 여섯 단계 Codex 실행 계획
실행 전 계획. input-images는 수정하지 않고 output 폴더에 CSV와 검수표만 만들도록 제한했습니다.
단계이번 실험에서 확인한 내용
SCAN허용 확장자 JPG·PNG·GIF 3개 확인
HASH작업 전후 SHA-256 값을 기록해 원본 변경 여부 확인
ANALYZE이미지에 실제로 보이는 정보만 캡션과 ALT에 반영
FLAG확신이 낮으면 needs_review=yes와 이유 기록
WRITEoutput/image-index.csv와 review.md만 생성
VERIFY입력 3개와 CSV 3행 일치, 빈 파일명·중복 파일명 없음

3. 실제로 사용한 프롬프트

핵심은 “잘 써줘”가 아니라 보이는 것만 쓰기, 애매하면 표시하기, 지정 폴더 밖에는 쓰지 않기입니다.

현재 폴더의 input-images만 읽으세요.
허용 형식은 .png, .jpg, .jpeg, .webp, .gif입니다.
원본 수정·이동·삭제는 금지합니다.

각 이미지에 대해 output/image-index.csv에 아래 열을 만드세요.
source_file, caption_ko, alt_ko, decorative, confidence, needs_review, review_reason

규칙:
1. caption_ko는 45자 이내의 자연스러운 설명입니다.
2. alt_ko는 글에서 이미지가 수행하는 기능과 핵심 정보를 100자 이내로 설명합니다.
3. 이미지에 보이지 않는 의도·감정·신원은 추측하지 않습니다.
4. 인물 이름, 숫자, 작은 글자, 브랜드가 확실하지 않으면 needs_review=yes로 표시합니다.
5. 순수 장식 이미지라면 decorative=yes, alt_ko는 빈 값으로 둡니다.
6. 개인정보 의심 요소가 있으면 상세 내용을 출력하지 말고 검토 사유만 적습니다.
7. 작업 전에 대상 파일 목록과 계획을 먼저 보여 주세요.
8. 승인 후에도 output 폴더 이외에는 쓰지 마세요.

완료 후 입력 파일 수, CSV 행 수, 검수 필요 건수, 원본 변경 여부를 요약하세요.

4. 실제 CSV는 이렇게 나왔습니다

샘플 이미지 3개의 캡션, 신뢰도, 사람 검수 여부, 장식 이미지 여부를 담은 CSV 결과 표
실제 CSV 결과. 3개 중 작은 소품 판독이 애매한 1개만 사람 검수 대상으로 분리했습니다.
CSV 완료 3건
사람 검수 1건
개인정보 0건
원본 변경 0건
⬇ 실제 image-index.csv 내려받기
파일캡션대체 텍스트검수
sample-01.jpg메모가 색인 카드 보드로 정리되는 업무 장면김치찌개와 흩어진 메모가 색인 카드 보드로 정리되는 과정을 표현한 이미지불필요
sample-02.png달 찜질방에서 쉬는 우주비행사들지구가 보이는 달 찜질방에서 수건을 쓴 세 우주비행사가 쉬는 레트로 SF 장면필요
작은 소품 종류 확인
sample-03.gif거꾸로 일주일 실험 전후 비교월·수 강의 뒤에도 깊은 일을 잡아둔 일정과 화요일 제안서·수요일 뉴스레터·목요일 빈 슬라이드·금요일 마감으로 바꾼 결과를 비교한 도표불필요

5. “그럴듯함”보다 검수 표시가 중요했습니다

잘된 점

  • 파일 수와 CSV 행 수가 정확히 일치했습니다.
  • 캡션과 ALT를 분리해 같은 말을 중복하지 않았습니다.
  • 작은 소품처럼 단정하기 어려운 요소를 숨기지 않고 검수 대상으로 보냈습니다.
  • 원본 파일의 SHA-256 해시가 실행 전후 동일했습니다.

사람이 꼭 봐야 할 점

  • 본문 맥락: 같은 이미지라도 글의 주제에 따라 좋은 ALT가 달라집니다.
  • 작은 글자와 숫자: 확대하지 않으면 읽기 어려운 정보는 추측하지 않습니다.
  • 그래프와 도표: 색·선·정확한 수치는 원본과 대조합니다.
  • 장식 이미지: 정보가 없는 꾸밈이라면 ALT를 비워 화면 낭독기의 부담을 줄입니다.

한 줄 판정: Codex는 ALT를 대신 “확정”하는 도구보다, 사람이 검토할 초안을 빠짐없이 모아주는 도구로 쓸 때 가장 안전하고 효율적입니다.

6. 개인정보와 실패 복구

고객 사진, 신분증, 계약서, 차량 번호, 주소가 보이는 원본으로 첫 실험을 시작하지 마세요. 공개 가능한 복사본 3~5장으로 흐름을 검증한 뒤 조직의 데이터 정책과 사용하는 계정의 데이터 처리 조건을 확인해야 합니다.

문제처리
작은 글자가 흐림needs_review=yes로 보내고 사람이 확대 확인
인물·장소를 특정하기 어려움신원을 추정하지 않고 보이는 장면만 설명
CSV 행 수가 맞지 않음확장자 필터와 중복 파일명을 확인하고 새 output 폴더에서 재실행
원본 해시가 달라짐즉시 중단하고 백업본과 대조. 원본 폴더 쓰기 권한 제거

실패했을 때는 입력 폴더를 건드리지 말고 잘못 생성된 output/image-index.csv와 review.md만 다시 만드세요. 이번 실험처럼 입력과 출력을 분리하면 복구 범위가 명확해집니다.

7. 내 폴더에 바로 쓰는 복붙 템플릿

[입력 폴더]의 [허용 이미지 형식]만 읽으세요.
원본 수정·이동·삭제를 금지합니다.

[출력 CSV]에 source_file, caption, alt, decorative,
confidence, needs_review, review_reason을 기록하세요.

[길이·표현 규칙]을 적용하고 보이지 않는 사실은 추측하지 마세요.
개인정보 또는 불확실한 고유명사가 있으면 상세 내용을 쓰지 말고
needs_review=yes와 검토 사유만 표시하세요.

작업 전 파일 목록과 실행 계획을 먼저 제시하세요.
승인 후 [출력 폴더]에만 쓰고,
완료 후 입력 수·출력 행 수·검수 건수·원본 변경 여부를 요약하세요.

이미지 수가 적으면 ChatGPT에 직접 올려 수동으로 처리해도 됩니다. 반복 폴더가 생기고 누락 검사가 필요해지는 순간부터 CSV 워크플로가 빛납니다.

8. 공식 출처


송진주(갓진주) | 생성형 AI 실무 교육가에서 더 알아보기

구독을 신청하면 최신 게시물을 이메일로 받아볼 수 있습니다.

답글 남기기