모든 발행 기사에 실제 사진을 대규모로 삽입하는 방법

발행하는 기사마다 사진이 필요합니다. 있으면 좋은 정도가 아닙니다 — 대표 이미지는 소셜 미리보기에 노출되는 화면이자, 독자가 첫 문장을 읽기도 전에 보는 것이며, 이 페이지를 신경 써서 만든 사람이 있는지를 0.5초 만에 알려줍니다. 게시물마다 이미지 네 장, 분기마다 게시물 40편을 곱하면 “사진 찾기”는 단순 작업이 아니라 파이프라인 문제가 됩니다.

다음은 우리가 이 문제를 해결하는 방식입니다: 생성된 이미지 대신 무엇을 써야 하는지와 그 이유, 그리고 Pexafy를 워크플로에 연결하는 세 가지 방법 — 수작업, API, AI 에이전트 — 을 다루며, 완성된 초안을 실제로 결과를 찾아내는 검색 문장으로 바꿔주는 프롬프트도 포함합니다.

실제 사진이 여전히 생성 이미지보다 나은 이유

삽화를 생성하는 일은 쉽고, 바로 그것이 문제입니다. “AI 이미지는 편법이다”라는 시절과 지금 사이에 네 가지가 달라졌습니다:

1 · 대량으로 다룰 때는 생성보다 검색이 빠릅니다

생성은 프롬프트 하나, 대기, 검토, 그리고 — 솔직히 말해 — 쓸 만한 결과가 나올 때까지 두세 번 더 시도하는 과정입니다. 시맨틱 검색은 단 한 번의 요청으로 약 150 밀리초 만에 후보 16개를 돌려주며, 각각 이미 라이선스가 있고, 출처 표기가 되어 있고, 크기가 정해져 있으며, 응답에 치수까지 포함되어 있습니다. 이미지 하나만 놓고 보면 차이는 커피 한 잔 정도입니다. 분기당 이미지 400장을 놓고 보면 워크플로와 업무 자체의 차이가 됩니다.

2 · 사진은 정확하고, 생성 이미지는 그럴듯할 뿐입니다

기사가 실제 대상 — 직업, 장비, 도시, 몸짓, 소재 — 을 다루는 순간, 생성 이미지는 분위기는 맞지만 디테일은 틀리기 시작합니다. 손가락이 여섯 개인 손은 우스갯소리에 불과하고, 정말 문제가 되는 것은 실재하지 않는 수술 도구, 조작 장치가 지어낸 조종석, 리스본 사람이 보면 알아보지 못할 “리스본 거리” 같은 것입니다. 주제를 잘 아는 독자는 이를 알아차리고, 그것도 사진에서 가장 먼저 알아챕니다.

3 · 모두가 같은 스타일을 갖게 됩니다

디퓨전 모델은 하나의 하우스 스타일로 수렴하고, 부드러운 그라데이션에 과하게 밝고 묘하게 대칭적인 삽화들이 줄지어 늘어서면 이제는 땜빵용으로 읽힙니다. 이러한 인식이야말로 실제 비용입니다 — 벌점이 아니라 신호입니다. 실제 사진 — 그레인, 어색한 의자, 말하는 도중의 사람 — 은 보도 사진처럼 읽힙니다.

4 · 그리고 이제는 라벨이 붙어서 옵니다

이 항목은 논거라기보다 맥락이지만, 흐름의 방향을 보여줍니다. 2026년 8월 2일부터 EU AI법 제50조는 생성형 시스템 제공자에게 합성 결과물을 기계 판독 가능한 형식으로 표시하도록 요구하며, 배포자에게는 딥페이크를 고지하도록 요구합니다.1 감지 쪽에서는 Google이 C2PA Content Credentials와 자체 SynthID 워터마크를 읽어 Search, Images, Lens 안에서 “이것이 AI로 생성된 이미지인가?”라는 질문에 답합니다.2 이 중 어느 것도 블로그가 어떤 이미지를 게시할 수 있는지에 대한 규칙이 아니며, 순위에 비용을 초래하지도 않습니다. 달라진 것은 그 이후 단계입니다: 여러분 기사 상단 사진의 출처가 이제는 독자가 여러분에게 묻지 않고도 클릭 두 번으로 확인할 수 있는 것이 되었다는 점입니다. 라이선스가 있는 사진은 따로 밝힐 것이 없습니다.

발행량에 따른 세 가지 삽화 방식

같은 엔진, 같은 카탈로그 — 9개 라이브러리에서 가져온 무료 이용 가능 사진 9M+장 — 그리고 세 가지 진입점. 기술 숙련도가 아니라 발행하는 기사 수를 기준으로 고르십시오.

표를 옆으로 넘겨 모든 열을 확인하십시오 →

이 세 가지는 하나의 카탈로그와 하나의 랭킹을 공유하므로, 편집자가 UI에서 찾은 사진은 빌드 스크립트에서 API가 반환하는 사진과 동일한 식별자를 가진 동일한 사진입니다.

기사 한 편, 30초: 검색 UI

사진작가에게 설명하듯 완전한 문장으로, 여러분의 언어로 장면을 묘사하십시오. team meeting이 아니라 “밝고 개방적인 사무실에서 짧은 아침 스탠드업 미팅을 위해 반원으로 서 있는 소규모 팀”과 같은 식입니다. 구체적인 세부사항을 하나씩 추가할 때마다 결과 집합이 비어버리는 것이 아니라 좁혀지는데, 엔진이 여러분의 단어를 누군가의 태그와 매칭하는 것이 아니라 의미를 기준으로 순위를 매기기 때문입니다.

pexafy.com — 문장 하나, 한 그리드 안에 여러 라이브러리의 결과

그런 다음 기사 레이아웃에 중요한 필터로만 좁히십시오 — 그것들만으로 충분합니다:

필터 — 색상, 방향, 출처, 라이선스

1. 키워드가 아니라 문장을 쓰십시오. 주어 + 행동 + 장소 + 빛. 최대 500자, 100개 이상 언어 중 어느 것이든 가능합니다.
2. 대표 이미지에는 가로 방향으로 필터링한 다음, 세로 사진이 더 잘 어울리는 경우가 많은 기사 내 이미지를 위해 필터 없이 다시 실행하십시오.
3. 사진을 열어 완성된 출처 표기 문구, 원본 출처 페이지, 전체 해상도 파일을 확보하십시오.
4. 선택한 사진에서 “유사한 사진”을 사용해, 다음 절을 같은 시각적 톤 — 같은 빛, 같은 처리 방식, 다른 장면 — 으로 꾸미십시오.

프롬프트: 초안을 검색 문장으로 바꾸기

이것이 자동화를 시도할 때 다들 틀리는 단계입니다. 기사 제목을 그대로 검색창에 넣는데, 제목이야말로 정확히 잘못된 입력값입니다: 제목은 추상적이고(“컨텍스트 전환의 숨겨진 비용”) 이 세상 어떤 사진도 그것을 묘사하지 않습니다. 모델에게서 필요한 것은 요약이 아니라 촬영 지시서(카메라 브리프)입니다.

# system prompt
You are a photo editor. Read the article and write ONE search sentence
for a stock-photo engine that ranks by meaning, not by keywords.

Rules:
1. Describe a scene a camera could have taken: someone doing
   something, somewhere. Never name the topic itself ("fintech",
   "productivity", "SEO") — name what would be in the frame.
2. 12 to 25 words. Longer beats shorter: every concrete detail
   (light, place, gesture, time of day) sharpens the match.
3. No text, logos, brands, charts, screenshots or famous people.
   Free photo libraries have almost none of those.
4. No invisible metaphors ("growth", "synergy", "transformation").
5. Match the mood of the article: calm, tense, tired, celebratory.
6. Write the sentence in English even if the article is not.

Return JSON only:
{ "query": "…", "orientation": "landscape", "alt": "…" }

규칙 1이 대부분의 역할을 합니다. 실제 초안 세 편에 같은 규칙을 적용해보면 이렇습니다 — 가운데 열은 사람이 급하게 입력할 법한 검색어이고, 오른쪽 열은 프롬프트가 반환한 결과입니다:

표를 옆으로 넘겨 모든 열을 확인하십시오 →

team meeting은 같은 주제를 다루는 다른 모든 사람이 이미 쓰고 있는 흔한 회의실 스톡 사진을 돌려줍니다. 세 번째 열의 문장은 155 밀리초 만에 다음 결과를 돌려줍니다:

GET /search/photos — “a small team standing in a semi circle for a short morning stand-up meeting…” · 결과 16건 · 155 ms

최상위 결과Pexels Pixabay Unsplash Unsplash Pexels Unsplash

파이프라인: 초안을 넣으면 출처 표기가 된 대표 이미지가 나온다

40줄, 호출 2회: 하나는 모델에 브리프를 요청하는 호출, 하나는 Pexafy에 사진을 요청하는 호출입니다. CMS의 저장 훅, 정적 사이트 빌드, 혹은 Markdown 파일 폴더를 순회하는 스크립트에 넣으면 됩니다.

import json, os, requests
from anthropic import Anthropic

SEARCH = "https://api.pexafy.com/api/v1/search/photos"
llm = Anthropic()  # 환경 변수의 ANTHROPIC_API_KEY 사용

def camera_brief(article: str) -> dict:
    # PHOTO_EDITOR = 위에 나온 시스템 프롬프트
    msg = llm.messages.create(
        model="claude-sonnet-5",
        max_tokens=300,
        system=PHOTO_EDITOR,
        messages=[{ "role": "user", "content": article[:12000] }],
    )
    return json.loads(msg.content[0].text)

def illustrate(article: str) -> dict | None:
    brief = camera_brief(article)
    r = requests.get(
        SEARCH,
        headers={"X-Api-Key": os.environ["PEXAFY_API_KEY"]},
        params={
            "q": brief["query"],           # 문장 전체
            "orientation": brief["orientation"],
            "per_page": 8,
            "score_threshold": 0.55,      # 약한 매칭은 제외
        },
        timeout=10,
    )
    hits = r.json()["data"]
    if not hits:                        # 브리프가 너무 좁음 → 넓혀서 재시도
        return None

    top = hits[0]
    return {
        "src":    top["urls"]["regular"],        # 1080px — 대표 이미지 크기
        "alt":    brief["alt"] or top["alt_description"],
        "credit": top["attribution"]["html"],   # 바로 렌더링 가능
        "width":  top["width"],
        "height": top["height"],
        "id":     top["photo_id"],           # 저장해 둘 것: 중복 방지
    }

데모를 계속 돌릴 수 있는 것으로 바꿔주는 세 가지 세부사항:

• score_threshold — 아무것도 반환하지 않는 편이 나쁜 사진을 반환하는 것보다 낫습니다. 브리프가 너무 구체적이었다면 (마지막 절을 빼고) 넓힌 뒤 한 번 다시 시도하십시오.
• photo_id를 저장하십시오 — 데이터베이스에 한 줄만 추가하면, 사이트의 어떤 두 기사도 대표 이미지를 공유하지 않게 됩니다. 이것이 게시물 30번째쯤에 누구나 겪는 실패 사례입니다.
• 이미지 슬롯당 요청 하나 — 대표 이미지 하나에 절 이미지 세 개면 기사당 요청 4회이거나, 같은 검색에서 서로 다른 결과 4개를 가져오면 요청 1회로 끝납니다.

Python이 없다면? 검색 절반 전체가 한 줄이며, 결과는 출처 라이브러리와 무관하게 항상 같은 필드를 담고 있습니다:

curl -sG "https://api.pexafy.com/api/v1/search/photos" \
  -H "X-Api-Key: $PEXAFY_API_KEY" \
  --data-urlencode "q=a tired developer rubbing their eyes at two monitors" \
  --data-urlencode "orientation=landscape" \
  --data-urlencode "per_page=6"

# → { "success": true, "data": [ … ], "meta": { "took_ms": 147 } }

응답 형태 — urls, width, photographer_full_name, source, license_type, relevance_score, attribution — 는 Pexels 사진, Pixabay 사진, Unsplash 사진 모두에 대해 동일합니다. 이 정규화 작업이야말로 여러분이 직접 작성하고 유지보수해야 했을 부분인데, 이를 필드 단위로 하나씩 뜯어본 내용은 무료 스톡 사진 API 비교에서 다뤘습니다.

두 번째 절, 두 번째 브리프, 두 번째 검색 — 요점은 기사 한 편에서 사진 한 장을 네 번 늘려 쓰는 대신 여러 개의 서로 다른 장면이 나온다는 것입니다:

2번째 절 — “아침 일찍 커피 한 잔과 함께 부엌 식탁에서 혼자 노트북으로 일하는 여성” · 129 ms

최상위 결과Pexels Pexels Pexels

에이전트가 사진을 고르게 하기: MCP

모델이 이미 초안을 작성하거나 편집하고 있다면, 가장 깔끔한 파이프라인은 파이프라인이 없는 것입니다: 에이전트에게 검색 도구를 주고, 방금 작성한 내용을 여전히 맥락을 유지한 채 같은 대화 안에서 직접 삽화로 꾸미게 하십시오.

Pexafy는 mcp.pexafy.com/mcp에서 호스팅되는 Model Context Protocol 서버를 운영합니다. 도구 세 가지: search_photos(문장 하나), search_photos_by_image(참조 이미지, 선택적으로 문장 추가 — “이것과 비슷하지만 노을 질 때”), get_similar_photos(이미 선택한 사진과 더 비슷한 것, 시리즈의 일관성을 유지하는 방법입니다).

Settings → Connectors → Add custom connector
Name: Pexafy
URL:  https://mcp.pexafy.com/mcp
# 이후 창이 열리면 Pexafy 계정으로 로그인

claude mcp add --transport http pexafy https://mcp.pexafy.com/mcp \
  --header "Authorization: Bearer $PEXAFY_API_KEY"

# 또는 저장소에 커밋하여 팀 전체가 사용하도록 — .mcp.json
{
  "mcpServers": {
    "pexafy": {
      "type": "http",
      "url": "https://mcp.pexafy.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

이렇게 설정하면 기사에 삽화를 넣는 일은 작업이 아니라 문장 하나입니다. 에이전트는 자기만의 촬영 지시서를 작성하는데 — 방금 초안을 읽었으니 그 장면을 묘사하기에 누구보다 유리한 위치에 있습니다:

You  이번 주 게시물 초안이야. 가로형 대표 이미지 하나와
     2번째 절에 쓸 사진 하나를 찾아주고, 출처 표기 문구도 줘.

Claude  → search_photos(
       q="a small team standing in a semi circle for a short morning
          stand-up meeting in a bright open plan office",
       orientation="landscape")
     ← 사진 16장 · 155 ms

     대표 이미지 → Photo by Thirdman on Pexels · 6453×4302 · 점수 0.80
     절 이미지  → Photo by Marcus Aurelius on Pexels · 6000×4000
     둘 다 라이선스 프리, 출처 표기 문구는 아래에, 바로 붙여넣을 수 있습니다.

Unsplash, Pexels, Pixabay, Openverse에는 공식 MCP 서버가 없습니다 — 존재하는 것은 여러분이 직접 호스팅하고 키를 관리해야 하는 커뮤니티 래퍼뿐입니다. 편집 워크플로가 이미 에이전트를 거쳐 돌아간다면, 그 차이야말로 통합 그 자체입니다.

Alt 텍스트, 라이선스, 페이지 속도

사진은 골랐습니다. 이 사진이 페이지에 도움이 될지, 조용히 해를 끼칠지는 다음 네 가지가 결정합니다:

1. Alt 텍스트는 크롤러가 아니라 사람을 위해 쓰십시오. 모든 결과에는 alt_description이 딸려 있습니다 — 이를 초안으로 삼고, 여러분 문단의 맥락에 맞게 다시 쓰십시오. “아침 회의 중인 동료 네 명”이 키워드 나열보다 낫고, 스크린 리더가 실제로 읽어줄 텍스트이기도 합니다. 약 125자 이내로 유지하고, 이미지가 순전히 장식용일 때만 비워 두십시오(alt="").
2. 강제하지 않아도 출처 표기를 넣으십시오. 출처 표기는 Pexafy API 약관에서 요구하지 않으며 모든 결과에는 바로 쓸 수 있는 attribution.html 문자열이 붙어 있습니다 — 하지만 원본 라이브러리에 부여된 라이선스는 여전히 그 사진의 사용을 규율하며, 눈에 보이는 출처 표기 문구는 이것이 실제 작가가 있는 진짜 사진이라는 것을 독자(그리고 답변 엔진)에게 알려줍니다.
3. 알맞은 크기를 제공하십시오. urls.regular(1080 px)는 대표 이미지용이고, urls.full은 어떤 기사에도 필요하지 않은 2400 px 파일입니다. 브라우저가 공간을 미리 확보하도록 응답에서 width/height를 항상 함께 내보내십시오 — 이 속성 한 쌍만으로 레이아웃 이동 점수가 좋은지 나쁜지가 갈립니다. 대표 이미지에는 fetchpriority="high"를, 접힘 영역 아래에는 모두 loading="lazy"를 쓰십시오.
4. 대표 이미지를 메타데이터에도 넣으십시오. 같은 URL이 og:image, twitter:image, Article 구조화 데이터의 image 속성이 되어야 합니다. 사진 한 장, 세 곳, 추가 작업 없이 — 그리고 더는 로고로 대체되지 않는 소셜 미리보기.

한 달에 기사 100편, 실제 비용은

대표 이미지 하나에 기사 내 이미지 세 개, 즉 게시물당 검색 요청 4회를 가정합니다 — 슬롯 하나마다 하나의 검색을 실행하는, 한 번 검색 결과를 재사용하는 대신 일부러 낭비적으로 쓰는 방식입니다:

표를 옆으로 넘겨 모든 열을 확인하십시오 →

맞습니다 — 콘텐츠 마케팅 규모에서 월간 한도는 문제가 되지 않으며, 결제할 이유를 억지로 만들어내기보다는 있는 그대로 말씀드리는 편을 택하겠습니다. 실제로 마주칠 한도는 분당 한도입니다. 무료 요금제는 분당 API 요청 20회를 허용하는데, 한 번의 빌드 스크립트가 기사 100편에 다시 삽화를 넣으면 반복문이 처리하는 속도대로 요청 400건이 발생하므로, 20분 동안 제한을 받거나 429를 받기 시작합니다. 빠져나가는 방법은 두 가지입니다: 호출 간격을 두거나(반복문에 sleep 한 줄이면 야간 작업에서는 아무런 문제가 되지 않습니다), 혹은 빌드 규모에 맞는 속도 제한을 가진 요금제로 옮기십시오 — Starter는 분당 30회 요청, Pro는 60회입니다. 총량이 아니라 순간 부하를 기준으로 고르십시오.

그 외 유일한 항목은 기사당 브리프를 만드는 짧은 모델 호출 한 번입니다 — 입력 토큰 수백 개, 출력 토큰 30개 정도로, 여러분이 운영하는 어떤 콘텐츠 파이프라인에서든 가장 저렴한 항목이 될 것입니다. 이를 게시물당 이미지 4장, 한 달에 이미지 400장, 거기에 통과하지 못한 시도까지 생성하는 것과 비교해 보십시오.

그리고 비용표에는 드러나지 않는 부분: 편집자가 더는 탭 다섯 개를 열지 않게 됩니다. 그것이 실제로 절약되는 것입니다.

참고 자료 및 각주