블로그 대표 이미지를 AI로 자동 생성해 붙이기

글에 이미지가 하나도 없으면 SEO에서도 불리하고 독자 인상도 밋밋합니다. 그렇다고 글마다 이미지를 직접 찾는 건 자동화의 취지에 안 맞습니다. 이 글은 발행 파이프라인에 AI 이미지 생성을 붙여서 대표 이미지를 자동으로 만들고, 그 이미지를 안전하게 본문에 넣는 방법을 정리한 기록입니다.

생성 API는 큐 방식으로 다룬다

이미지 생성 API는 응답까지 몇 초가 걸립니다. 요청을 보내고 바로 결과를 기다리는 동기 방식은 연결이 끊기면 결과를 잃습니다. 그래서 큐 방식을 씁니다. 요청을 큐에 넣고 요청 아이디를 받은 뒤, 상태를 폴링해서 완료되면 결과를 가져옵니다. 이렇게 하면 중간에 문제가 생겨도 아이디로 다시 결과를 찾을 수 있습니다.

1. submit request -> receive request id
2. poll status: queued -> in progress -> completed
3. on complete -> receive result URL

생성된 URL은 임시라는 함정

여기에 놓치기 쉬운 함정이 있습니다. 생성 서비스가 돌려주는 이미지 URL은 임시입니다. 시간이 지나면 만료됩니다. 이 URL을 그대로 본문에 넣으면 나중에 이미지가 깨집니다. 그래서 생성된 이미지를 반드시 내 블로그의 미디어 저장소로 옮긴 뒤, 그 영구 주소를 본문에 써야 합니다.

temporary URL from generator (expires)
  -> download and upload to blog media
  -> insert the blog permanent URL into body

파일명 인코딩에서 막힌 지점

이미지를 업로드할 때 파일명 때문에 한참 막혔습니다. 업로드 요청의 파일명을 HTTP 헤더에 담는데, 이 헤더는 아스키만 담을 수 있습니다. 한글 슬러그를 그대로 파일명으로 쓰면 인코딩 오류가 납니다. 그래서 파일명은 영문과 숫자만 남기도록 변환해야 합니다. 그런데 한글만 지우면 하이픈만 남는 경우가 생겨서, 영숫자가 하나도 없으면 대체 이름을 쓰도록 한 겹 더 방어했습니다.

이런 인코딩 문제는 처음엔 원인이 안 보입니다. 에러 메시지가 문자 코드 값만 알려줄 뿐이라, 어느 글자가 문제인지 직접 찾아야 합니다. 자동화에서 한글을 다룰 때 반복해서 만나는 함정입니다.

이미지의 alt와 대표 지정

이미지를 넣을 때 두 가지를 빼먹지 말아야 합니다. 첫째, alt 텍스트에 포커스 키워드를 넣습니다. SEO 검사가 이 항목을 봅니다. 둘째, 업로드한 이미지를 글의 대표 이미지로 지정합니다. 여기서 순서 문제를 겪었습니다. 이미지를 먼저 업로드하고 글을 나중에 보내면, 업로드 시점에 글이 아직 없어서 대표 이미지 연결이 빠졌습니다. 그래서 글을 보낼 때마다 대표 이미지 지정을 함께 하도록 고쳤습니다.

이미지 프롬프트도 자동화의 일부입니다. 매번 같은 톤의 이미지를 얻으려면 공통 스타일 지시를 프롬프트에 붙이면 됩니다. 색감이나 분위기를 고정해두면 여러 글의 이미지가 한 블로그의 것처럼 통일됩니다. 글 제목이나 키워드를 프롬프트에 녹이면 내용과 어울리는 이미지가 나옵니다.

이미지 자동 생성까지 붙이면 발행 파이프라인이 얼추 완성됩니다. 주제를 잡고, 글을 쓰고, SEO를 점검하고, 이미지를 붙이고, 예약해서 발행하는 과정이 한 흐름으로 이어집니다. 열 편에 걸쳐 다룬 이 조각들은 결국 하나의 목표로 모입니다. 사람은 판단과 검수에 집중하고, 반복은 기계에 맡기는 것입니다.