이미지 지원 · Claude API로 구축하기

Claude의 비전 기능을 사용하면 메시지에 이미지를 포함하고 Claude에게 다양한 방식으로 이미지를 분석하도록 요청할 수 있습니다. Claude에게 이미지에 무엇이 있는지 설명하거나, 여러 이미지를 비교하거나, 객체를 세거나, 복잡한 시각 분석 작업을 수행하도록 요청할 수 있습니다.

이미지 처리 기본 사항

이미지를 다룰 때 염두에 두어야 할 몇 가지 중요한 제한 사항이 있습니다:

단일 요청의 모든 메시지에서 최대 100개의 이미지
이미지당 최대 크기 5MB
이미지 하나를 전송할 때: 최대 높이/너비 8000px
여러 이미지를 전송할 때: 최대 높이/너비 2000px
이미지는 base64 인코딩 또는 이미지 URL로 포함할 수 있습니다
각 이미지는 크기에 따라 토큰으로 계산됩니다: tokens = (width px × height px) / 750

Claude에게 이미지를 전송하려면 사용자 메시지에 텍스트 블록과 함께 이미지 블록을 포함합니다. 구조는 다음과 같습니다:

python

with open("image.png", "rb") as f:
    image_bytes = base64.standard_b64encode(f.read()).decode("utf-8")

add_user_message(messages, [
    # 이미지 블록
    {
        "type": "image",
        "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": image_bytes,
        }
    },
    # 텍스트 블록
    {
        "type": "text",
        "text": "What do you see in this image?"
    }
])

메시지 흐름

대화는 텍스트 전용 상호작용과 동일하게 작동합니다. 서버는 이미지와 텍스트 블록을 모두 포함하는 사용자 메시지를 Claude에게 전송하고, Claude는 분석 내용을 담은 텍스트 블록으로 응답합니다.

프롬프트 작성 기법

이미지로 좋은 결과를 얻는 핵심은 텍스트에 사용하는 것과 동일한 프롬프트 엔지니어링 기법을 적용하는 것입니다. 단순한 프롬프트는 종종 좋지 않은 결과로 이어집니다. 예를 들어, "이 이미지에 구슬이 몇 개 있나요?"라고 묻는 것은 잘못된 개수를 반환할 수 있습니다.

다음과 같은 방법으로 Claude의 정확도를 크게 향상시킬 수 있습니다:

상세한 가이드라인과 분석 단계 제공
원샷 또는 멀티샷 예시 사용
복잡한 작업을 더 작은 단계로 나누기

단계별 분석

단순한 질문 대신 Claude에게 방법론을 제공하세요:

Analyze this image of marbles and determine the exact count using this methodology:
1. Begin by identifying each unique marble one at a time. Assign each a number as you identify it.
2. Verify your result by counting with a different method. Start from the bottom-left corner and work row by row, from left to right.

What is the exact, verified number of marbles in this image?

원샷 예시

메시지 내에 예시를 제공하여 정확도를 향상시킬 수도 있습니다. 알려진 개수가 있는 이미지를 포함하고, 정답을 명시한 다음, 대상 이미지에 대해 질문하세요. 이는 Claude에게 원하는 분석 유형에 대한 참조점을 제공합니다.

실제 사례: 화재 위험 평가

다음은 실용적인 적용 사례입니다: 주택 보험을 위한 화재 위험 평가 자동화입니다. 모든 부동산에 조사관을 보내는 대신, 보험 회사는 위성 이미지와 Claude의 분석을 사용할 수 있습니다.

이 시스템은 위성 이미지를 분석하여 다음을 식별합니다:

주택 근처의 밀집된 나무들
응급 서비스의 접근이 어려운 경로
주택 위로 뻗은 나뭇가지

"화재 위험 점수를 제공하세요"와 같은 단순한 프롬프트 대신, 잘 구성된 프롬프트는 분석을 구체적인 단계로 나눕니다:

Analyze the attached satellite image of a property with these specific steps:

1. Residence identification: Locate the primary residence on the property by looking for:
   - The largest roofed structure
   - Typical residential features (driveway connection, regular geometry)
   - Distinction from other structures (garages, sheds, pools)

2. Tree overhang analysis: Examine all trees near the primary residence:
   - Identify any trees whose canopy extends directly over any portion of the roof
   - Estimate the percentage of roof covered by overhanging branches (0-25%, 25-50%, 50-75%, 75%+)
   - Note particularly dense areas of overhang

3. Fire risk assessment: For any overhanging trees, evaluate:
   - Potential wildfire vulnerability (ember catch points, continuous fuel paths to structure)
   - Proximity to chimneys, vents, or other roof openings if visible
   - Areas where branches create a "bridge" between wildland vegetation and the structure

4. Defensible space identification: Assess the property's overall vegetative structure:
   - Identify if trees connect to form a continuous canopy over or near the home
   - Note any obvious fuel ladders (vegetation that can carry fire from ground to tree to roof)

5. Fire risk rating: Based on your analysis, assign a Fire Risk Rating from 1-4:
   - Rating 1 (Low Risk): No tree branches overhanging the roof, good defensible space around the home
   - Rating 2 (Moderate Risk): Minimal overhang (<25% of roof), some separation between tree canopies
   - Rating 3 (High Risk): Significant overhang (25-50% of roof), connected tree canopies, multiple vulnerability points
   - Rating 4 (Severe Risk): Extensive overhang (>50% of roof), dense vegetation against structure

For each item above (1-5), write one sentence summarizing your findings, with your final response being the numerical rating.

이 상세한 프롬프트는 Claude가 체계적인 분석을 수행하도록 안내하여, 단순한 요청보다 훨씬 더 정확하고 유용한 평가 결과를 제공합니다.

기억하세요: 텍스트에 효과적인 동일한 프롬프트 작성 기법이 이미지에도 적용됩니다. 신뢰할 수 있는 결과를 원한다면 단순한 질문에 의존하기보다 상세하고 구조화된 프롬프트를 작성하는 데 시간을 투자하세요.