비전

이 가이드는 Claude에서 이미지를 사용하는 방법, 모범 사례, 주의해야 할 제한 사항을 설명합니다.

비전 사용 방법

다음을 통해 Claude의 비전 기능을 사용할 수 있습니다:

• claude.ai. 파일처럼 이미지를 업로드하거나 이미지를 채팅 창에 직접 드래그 앤 드롭합니다.
• Console Workbench. 모든 사용자 메시지 블록의 오른쪽 상단에 이미지를 추가하는 버튼이 나타납니다.
• API 요청. 이 가이드의 예제를 참조하세요.

업로드 전에

기본 사항 및 제한

단일 요청에 여러 이미지를 포함할 수 있습니다: claude.ai의 경우 최대 20개, API 요청의 경우 최대 600개(200k 토큰 컨텍스트 윈도우가 있는 모델의 경우 100개). Claude는 응답을 작성할 때 제공된 모든 이미지를 분석합니다. 이는 이미지를 비교하거나 대조하는 데 도움이 될 수 있습니다.

8000x8000 px보다 큰 이미지를 제출하면 거부됩니다. 한 번의 API 요청에서 20개 이상의 이미지를 제출하면 이 제한은 2000x2000 px입니다.

이미지 크기 평가

지연 시간을 최소화하면서 출력 품질을 유지하려면 이미지가 너무 크면 업로드하기 전에 크기를 조정하세요. Claude Opus 4.6, Claude Sonnet 4.6 및 이전 모델에서 이미지의 긴 쪽이 1568픽셀보다 크거나 이미지가 약 1,600토큰보다 크면 먼저 종횡비를 유지하면서 크기 제한 내에 들어올 때까지 축소됩니다.

입력 이미지가 너무 크고 크기를 조정해야 하면 첫 토큰까지의 시간의 지연 시간이 증가하며 출력 품질에는 이점이 없습니다. 어느 쪽 가장자리도 200픽셀 미만인 매우 작은 이미지는 출력 품질을 저하시킬 수 있습니다.

Claude Opus 4.7의 고해상도 이미지 지원

Claude Opus 4.7은 고해상도 이미지 지원을 갖춘 첫 번째 Claude 모델입니다. 최대 이미지 해상도는 긴 쪽에 2576픽셀(이전 모델의 1568 px에서 증가)입니다. 이는 비전 집약적 워크로드에서 성능 향상을 제공하며 컴퓨터 사용, 스크린샷 이해 및 문서 분석에 특히 유용합니다.

고해상도 지원은 Claude Opus 4.7에서 자동이며 베타 헤더나 클라이언트 측 옵트인이 필요하지 않습니다.

토큰 비용: Claude Opus 4.7의 전체 해상도 이미지는 이전 모델보다 최대 약 3배 더 많은 이미지 토큰을 사용할 수 있습니다(이미지당 최대 4784토큰, 이전 상한인 약 1,600토큰과 비교). 추가 충실도가 필요하지 않으면 전송하기 전에 이미지를 다운샘플링하여 토큰 비용을 제어하세요.

좌표 수학: Claude Opus 4.7에서 모델이 반환하는 포인팅 및 경계 상자 좌표는 실제 이미지 픽셀과 1

다음은 일반적인 종횡비에 대해 크기 조정되지 않을 API가 수용하는 최대 이미지 크기 표입니다. Claude Sonnet 4.6을 사용하면 이러한 이미지는 약 1,600토큰을 사용하고 약 $4.80/1k 이미지입니다.

이미지 비용 계산

Claude에 대한 요청에 포함하는 각 이미지는 토큰 사용량에 포함됩니다. 대략적인 비용을 계산하려면 대략적인 이미지 토큰 수에 사용 중인 모델의 토큰당 가격을 곱하세요.

이미지를 크기 조정할 필요가 없으면 이 알고리즘을 통해 사용된 토큰 수를 추정할 수 있습니다: tokens = (width px * height px)/750

다음은 Claude Sonnet 4.6 토큰당 가격 $3/백만 입력 토큰을 기반으로 API의 크기 제약 내의 다양한 이미지 크기에 대한 대략적인 토큰화 및 비용의 예입니다:

이미지 품질 보장

Claude에 이미지를 제공할 때 최상의 결과를 위해 다음을 염두에 두세요:

• 이미지 형식: 지원되는 이미지 형식을 사용하세요: JPEG, PNG, GIF 또는 WebP.
• 이미지 선명도: 이미지가 명확하고 너무 흐릿하거나 픽셀화되지 않았는지 확인하세요.
• 텍스트: 이미지에 중요한 텍스트가 포함되어 있으면 읽을 수 있고 너무 작지 않은지 확인하세요. 텍스트를 확대하기 위해 주요 시각적 컨텍스트를 자르지 마세요.

프롬프트 예제

텍스트 기반 Claude 상호작용에 잘 작동하는 많은 프롬프팅 기법을 이미지 기반 프롬프트에도 적용할 수 있습니다.

이러한 예제는 이미지와 관련된 모범 사례 프롬프트 구조를 보여줍니다.

프롬프트 예제 정보

다음 예제는 다양한 프로그래밍 언어와 접근 방식을 사용하여 Claude의 비전 기능을 사용하는 방법을 보여줍니다. Claude에 이미지를 제공하는 방법은 세 가지입니다:

1. image 콘텐츠 블록의 base64 인코딩 이미지
2. 온라인에서 호스팅되는 이미지에 대한 URL 참조
3. Files API 사용(한 번 업로드, 여러 번 사용)

base64 예제 프롬프트는 다음 변수를 사용합니다:

import base64
import httpx

# base64 인코딩 이미지의 경우
image1_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
image1_media_type = "image/jpeg"
image1_data = base64.standard_b64encode(httpx.get(image1_url).content).decode("utf-8")

image2_url = "https://upload.wikimedia.org/wikipedia/commons/b/b5/Iridescent.green.sweat.bee1.jpg"
image2_media_type = "image/jpeg"
image2_data = base64.standard_b64encode(httpx.get(image2_url).content).decode("utf-8")

# URL 기반 이미지의 경우 요청에서 URL을 직접 사용할 수 있습니다

다음은 base64 인코딩 이미지 및 URL 참조를 사용하여 Messages API 요청에 이미지를 포함하는 방법의 예입니다:

Base64 인코딩 이미지 예제

image1_data = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGP4z8AAAAMBAQDJ/pLvAAAAAElFTkSuQmCC"
image1_media_type = "image/png"

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {"type": "text", "text": "Describe this image."},
            ],
        }
    ],
)
print(message)

URL 기반 이미지 예제

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg",
                    },
                },
                {"type": "text", "text": "Describe this image."},
            ],
        }
    ],
)
print(message)

Files API 이미지 예제

반복적으로 사용할 이미지나 인코딩 오버헤드를 피하고 싶을 때는 Files API를 사용하세요. 이미지를 한 번 업로드한 후, 반환된 file_id를 후속 메시지에서 참조하면 base64 데이터를 다시 전송할 필요가 없습니다.

client = anthropic.Anthropic()

# 이미지 파일을 업로드합니다
with open("image.jpg", "rb") as f:
    file_upload = client.beta.files.upload(file=("image.jpg", f, "image/jpeg"))

# 업로드된 파일을 메시지에서 사용합니다
message = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    betas=["files-api-2025-04-14"],
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {"type": "file", "file_id": file_upload.id},
                },
                {"type": "text", "text": "Describe this image."},
            ],
        }
    ],
)

print(message.content)

더 많은 예제 코드와 매개변수 세부 정보는 Messages API 예제를 참조하세요.

제한 사항

Claude의 이미지 이해 기능은 최첨단이지만 주의해야 할 몇 가지 제한 사항이 있습니다:

• 사람 식별: Claude는 이미지의 사람을 식별하는 데 사용할 수 없으며 이를 거부합니다.
• 정확도: Claude는 저품질, 회전되거나 200픽셀 미만의 매우 작은 이미지를 해석할 때 환각을 일으키거나 실수할 수 있습니다.
• 공간 추론: Claude의 공간 추론 능력은 제한적입니다. 아날로그 시계 면 읽기나 체스 말의 정확한 위치 설명과 같이 정확한 위치 지정이나 레이아웃이 필요한 작업에서 어려움을 겪을 수 있습니다.
• 개수 세기: Claude는 이미지의 객체 개수를 대략적으로 셀 수 있지만 특히 많은 수의 작은 객체의 경우 항상 정확하지는 않을 수 있습니다.
• AI 생성 이미지: Claude는 이미지가 AI로 생성되었는지 알 수 없으며 물어볼 경우 잘못될 수 있습니다. 가짜 또는 합성 이미지를 감지하는 데 의존하지 마세요.
• 부적절한 콘텐츠: Claude는 허용 가능한 사용 정책을 위반하는 부적절하거나 명시적인 이미지를 처리하지 않습니다.
• 의료 응용: Claude는 일반적인 의료 이미지를 분석할 수 있지만 CT 또는 MRI와 같은 복잡한 진단 스캔을 해석하도록 설계되지 않았습니다. Claude의 출력은 전문적인 의료 조언이나 진단의 대체물로 간주되어서는 안 됩니다.

특히 높은 위험도의 사용 사례에서는 항상 Claude의 이미지 해석을 신중하게 검토하고 확인하세요. 완벽한 정확도가 필요하거나 민감한 이미지 분석이 필요한 작업에는 인간의 감독 없이 Claude를 사용하지 마세요.

FAQ

비전에 대해 더 깊이 있게 알아보기

Claude를 사용하여 이미지로 구축을 시작할 준비가 되셨습니까? 다음은 몇 가지 유용한 리소스입니다:

• 멀티모달 쿡북: 이 쿡북에는 이미지 시작하기 및 이미지 최고 실천 기법에 대한 팁이 있어 이미지로 최고 품질의 성능을 보장합니다. 차트 해석 및 분석 또는 양식에서 콘텐츠 추출과 같은 작업을 수행하기 위해 Claude에 이미지를 효과적으로 프롬프트하는 방법을 확인하세요.
• API 참조: 이미지와 관련된 예제 API 호출을 포함한 Messages API 설명서입니다.

다른 질문이 있으시면 지원 팀에 문의하세요. 개발자 커뮤니티에 참여하여 다른 제작자와 연결하고 Anthropic 전문가로부터 도움을 받을 수도 있습니다.