Зрение

Это руководство описывает, как работать с изображениями в Claude, включая лучшие практики, примеры кода и ограничения, которые следует учитывать.

Как использовать зрение

Используйте возможности зрения Claude через:

claude.ai. Загрузите изображение как файл или перетащите изображение прямо в окно чата.
Консоль Workbench. Если вы выберете модель, которая принимает изображения (только модели Claude 3 и 4), кнопка для добавления изображений появится в правом верхнем углу каждого блока сообщений пользователя.
API запрос. См. примеры в этом руководстве.

Перед загрузкой

Основы и ограничения

Вы можете включить несколько изображений в один запрос (до 20 для claude.ai и 100 для API-запросов). Claude проанализирует все предоставленные изображения при формулировании своего ответа. Это может быть полезно для сравнения или противопоставления изображений.

Если вы отправляете изображение размером более 8000x8000 пикселей, оно будет отклонено. Если вы отправляете более 20 изображений в одном API-запросе, это ограничение составляет 2000x2000 пикселей.

Оценка размера изображения

Для оптимальной производительности мы рекомендуем изменять размер изображений перед загрузкой, если они слишком большие. Если длинная сторона вашего изображения превышает 1568 пикселей, или ваше изображение превышает ~1,600 токенов, оно сначала будет уменьшено с сохранением соотношения сторон, пока не будет соответствовать ограничениям размера.

Если ваше входное изображение слишком большое и требует изменения размера, это увеличит задержку времени до первого токена, не давая вам никакой дополнительной производительности модели. Очень маленькие изображения размером менее 200 пикселей по любой из сторон могут ухудшить производительность.

Чтобы улучшить время до первого токена, мы рекомендуем изменять размер изображений до не более 1,15 мегапикселей (и в пределах 1568 пикселей по обоим измерениям).

Вот таблица максимальных размеров изображений, принимаемых нашим API, которые не будут изменены для распространенных соотношений сторон. С моделью Claude Sonnet 3.7 эти изображения используют примерно 1,600 токенов и около $4,80/1K изображений.

Соотношение сторон	Размер изображения
1:1	1092x1092 px
3:4	951x1268 px
2:3	896x1344 px
9:16	819x1456 px
1:2	784x1568 px

Расчет стоимости изображений

Каждое изображение, которое вы включаете в запрос к Claude, учитывается в использовании токенов. Чтобы рассчитать приблизительную стоимость, умножьте приблизительное количество токенов изображения на цену за токен модели, которую вы используете.

Если ваше изображение не требует изменения размера, вы можете оценить количество используемых токенов с помощью этого алгоритма: токены = (ширина px * высота px)/750

Вот примеры приблизительной токенизации и стоимости для различных размеров изображений в рамках ограничений размера нашего API на основе цены за токен Claude Sonnet 3.7, составляющей $3 за миллион входных токенов:

Размер изображения	Кол-во токенов	Стоимость / изображение	Стоимость / 1K изображений
200x200 px(0,04 мегапикселя)	~54	~$0,00016	~$0,16
1000x1000 px(1 мегапиксель)	~1334	~$0,004	~$4,00
1092x1092 px(1,19 мегапикселя)	~1590	~$0,0048	~$4,80

Обеспечение качества изображения

При предоставлении изображений Claude учитывайте следующее для достижения наилучших результатов:

Формат изображения: Используйте поддерживаемый формат изображения: JPEG, PNG, GIF или WebP.
Четкость изображения: Убедитесь, что изображения четкие, не слишком размытые или пикселизированные.
Текст: Если изображение содержит важный текст, убедитесь, что он разборчив и не слишком мал. Избегайте обрезки ключевого визуального контекста только для увеличения текста.

Примеры промптов

Многие техники составления промптов, которые хорошо работают для текстовых взаимодействий с Claude, также могут быть применены к промптам на основе изображений.

Эти примеры демонстрируют структуры промптов, соответствующие лучшим практикам, с использованием изображений.

Так же, как и с размещением документов и запросов, Claude работает лучше, когда изображения идут перед текстом. Изображения, размещенные после текста или интерполированные с текстом, все равно будут работать хорошо, но если ваш случай использования позволяет, мы рекомендуем структуру изображение-затем-текст.

О примерах промптов

Следующие примеры демонстрируют, как использовать возможности зрения Claude с использованием различных языков программирования и подходов. Вы можете предоставить изображения Claude тремя способами:

Как изображение в кодировке base64 в блоках содержимого image
Как URL-ссылку на изображение, размещенное в интернете
Используя Files API (загрузка один раз, использование несколько раз)

Примеры промптов с base64 используют следующие переменные:

    # Для изображений на основе URL вы можете использовать URL напрямую в вашем JSON-запросе
    
    # Для изображений в кодировке base64 вам нужно сначала закодировать изображение
    # Пример того, как закодировать изображение в base64 в bash:
    BASE64_IMAGE_DATA=$(curl -s "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg" | base64)
    
    # Закодированные данные теперь можно использовать в ваших API-вызовах

Ниже приведены примеры того, как включать изображения в запрос Messages API с использованием изображений в кодировке base64 и URL-ссылок:

Пример изображения в кодировке base64

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "base64",
              "media_type": "image/jpeg",
              "data": "'"$BASE64_IMAGE_DATA"'"
            }
          },
          {
            "type": "text",
            "text": "Describe this image."
          }
        ]
      }
    ]
  }'

Пример изображения на основе URL

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "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."
          }
        ]
      }
    ]
  }'

Пример изображения с использованием Files API

Для изображений, которые вы будете использовать многократно, или когда вы хотите избежать накладных расходов на кодирование, используйте Files API:

# Сначала загрузите ваше изображение в Files API
curl -X POST https://api.anthropic.com/v1/files \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -F "file=@image.jpg"

# Затем используйте возвращенный file_id в вашем сообщении
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "file",
              "file_id": "file_abc123"
            }
          },
          {
            "type": "text",
            "text": "Describe this image."
          }
        ]
      }
    ]
  }'

См. примеры Messages API для получения дополнительного примера кода и деталей параметров.

Пример: Одно изображение

Лучше размещать изображения в промпте раньше, чем вопросы о них или инструкции для задач, которые их используют.

Попросите Claude описать одно изображение.

Роль	Содержание
Пользователь	[Изображение] Опишите это изображение.

Вот соответствующий API-вызов с использованием модели Claude Sonnet 3.7.

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    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."
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    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."
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    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."
                }
            ],
        }
    ],
)

Пример: Несколько изображений

В ситуациях, когда есть несколько изображений, представьте каждое изображение с помощью Изображение 1: и Изображение 2: и так далее. Вам не нужны новые строки между изображениями или между изображениями и промптом.

Попросите Claude описать различия между несколькими изображениями.

Роль	Содержание
Пользователь	Изображение 1: [Изображение 1] Изображение 2: [Изображение 2] Чем эти изображения отличаются?

Вот соответствующий API-вызов с использованием модели Claude Sonnet 3.7.

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Image 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Image 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "How are these images different?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Image 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Image 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "How are these images different?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Image 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "Image 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/b/b5/Iridescent.green.sweat.bee1.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "How are these images different?"
                }
            ],
        }
    ],
)

Пример: Несколько изображений с системным промптом

Попросите Claude описать различия между несколькими изображениями, давая ему системный промпт о том, как отвечать.

Содержание
Система	Отвечайте только на испанском языке.
Пользователь	Изображение 1: [Изображение 1] Изображение 2: [Изображение 2] Чем эти изображения отличаются?

Вот соответствующий API-вызов с использованием модели Claude Sonnet 3.7.

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    system="Respond only in Spanish.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Image 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Image 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "How are these images different?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    system="Respond only in Spanish.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Image 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image1_media_type,
                        "data": image1_data,
                    },
                },
                {
                    "type": "text",
                    "text": "Image 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image2_media_type,
                        "data": image2_data,
                    },
                },
                {
                    "type": "text",
                    "text": "How are these images different?"
                }
            ],
        }
    ],
)

Python
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    system="Respond only in Spanish.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Image 1:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "Image 2:"
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://upload.wikimedia.org/wikipedia/commons/b/b5/Iridescent.green.sweat.bee1.jpg",
                    },
                },
                {
                    "type": "text",
                    "text": "How are these images different?"
                }
            ],
        }
    ],
)

Пример: Четыре изображения в двух репликах разговора

Возможности зрения Claude проявляются в мультимодальных разговорах, сочетающих изображения и текст. Вы можете вести расширенный диалог с Claude, добавляя новые изображения или дополнительные вопросы в любой момент. Это обеспечивает мощные рабочие процессы для итеративного анализа изображений, сравнения или комбинирования визуальных данных с другими знаниями.

Попросите Claude сравнить два изображения, затем задайте дополнительный вопрос, сравнивая первые изображения с двумя новыми изображениями.

Роль	Содержание
Пользователь	Изображение 1: [Изображение 1] Изображение 2: [Изображение 2] Чем эти изображения отличаются?
Ассистент	[Ответ Claude]
Пользователь	Изображение 1: [Изображение 3] Изображение 2: [Изображение 4] Похожи ли эти изображения на первые два?
Ассистент	[Ответ Claude]

При использовании API просто вставьте новые изображения в массив сообщений в роли user как часть стандартной структуры многоходового разговора.

Ограничения

Хотя возможности понимания изображений Claude являются передовыми, есть некоторые ограничения, о которых следует знать:

Идентификация людей: Claude не может использоваться для идентификации (т.е. называния имен) людей на изображениях и будет отказываться это делать.
Точность: Claude может галлюцинировать или делать ошибки при интерпретации изображений низкого качества, повернутых или очень маленьких изображений размером менее 200 пикселей.
Пространственное мышление: Способности Claude к пространственному мышлению ограничены. Он может испытывать трудности с задачами, требующими точной локализации или компоновки, например, чтение циферблата аналоговых часов или описание точных позиций шахматных фигур.
Подсчет: Claude может давать приблизительное количество объектов на изображении, но не всегда может быть точным, особенно с большим количеством мелких объектов.
Изображения, сгенерированные ИИ: Claude не знает, сгенерировано ли изображение ИИ, и может ошибаться, если его спросить об этом. Не полагайтесь на него для обнаружения поддельных или синтетических изображений.
Неприемлемый контент: Claude не будет обрабатывать неприемлемые или явные изображения, нарушающие нашу Политику приемлемого использования.
Медицинские приложения: Хотя Claude может анализировать общие медицинские изображения, он не предназначен для интерпретации сложных диагностических сканирований, таких как КТ или МРТ. Результаты Claude не следует рассматривать как замену профессиональной медицинской консультации или диагностики.

Всегда тщательно проверяйте и подтверждайте интерпретации изображений Claude, особенно для важных случаев использования. Не используйте Claude для задач, требующих идеальной точности или чувствительного анализа изображений без человеческого надзора.

FAQ

Какие типы файлов изображений поддерживает Claude?

Может ли Claude читать URL изображений?

Да, Claude теперь может обрабатывать изображения из URL с помощью наших блоков источников изображений URL в API. Просто используйте тип источника “url” вместо “base64” в ваших API-запросах. Пример:

{
  "type": "image",
  "source": {
    "type": "url",
    "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
  }
}

Существует ли ограничение на размер файла изображения, который я могу загрузить?

Сколько изображений я могу включить в один запрос?

Читает ли Claude метаданные изображений?

Могу ли я удалить загруженные изображения?

Где я могу найти подробности о конфиденциальности данных для загрузок изображений?

Что делать, если интерпретация изображения Claude кажется неверной?

Может ли Claude генерировать или редактировать изображения?

Глубже погрузитесь в зрение

Готовы начать создавать с использованием изображений с помощью Claude? Вот несколько полезных ресурсов:

Мультимодальная поваренная книга: Эта поваренная книга содержит советы по началу работы с изображениями и техники лучших практик для обеспечения наивысшего качества работы с изображениями. Посмотрите, как вы можете эффективно давать промпты Claude с изображениями для выполнения таких задач, как интерпретация и анализ диаграмм или извлечение содержимого из форм.
Справочник API: Посетите нашу документацию по Messages API, включая примеры API-вызовов с использованием изображений.

Если у вас есть другие вопросы, не стесняйтесь обращаться к нашей команде поддержки. Вы также можете присоединиться к нашему сообществу разработчиков, чтобы связаться с другими создателями и получить помощь от экспертов Anthropic.

Эмбеддинги Поддержка PDF

On this page

Как использовать зрение
Перед загрузкой
Основы и ограничения
Оценка размера изображения
Расчет стоимости изображений
Обеспечение качества изображения
Примеры промптов
О примерах промптов
Пример изображения в кодировке base64
Пример изображения на основе URL
Пример изображения с использованием Files API
Ограничения
FAQ
Глубже погрузитесь в зрение

Первые шаги

Изучить возможности

Модели и цены

Узнать о Claude

Тестирование и оценка

Компоненты агента

Юридический центр

Как использовать зрение

Перед загрузкой

Основы и ограничения

Оценка размера изображения

Расчет стоимости изображений

Обеспечение качества изображения

Примеры промптов

О примерах промптов

Пример изображения в кодировке base64

Пример изображения на основе URL

Пример изображения с использованием Files API

Ограничения

FAQ

Глубже погрузитесь в зрение

Первые шаги

Изучить возможности

Модели и цены

Узнать о Claude

Тестирование и оценка

Компоненты агента

Юридический центр

​Как использовать зрение

​Перед загрузкой

​Основы и ограничения

​Оценка размера изображения

​Расчет стоимости изображений

​Обеспечение качества изображения

​Примеры промптов

​О примерах промптов

​Пример изображения в кодировке base64

​Пример изображения на основе URL

​Пример изображения с использованием Files API

​Ограничения

​FAQ

​Глубже погрузитесь в зрение

Как использовать зрение

Перед загрузкой

Основы и ограничения

Оценка размера изображения

Расчет стоимости изображений

Обеспечение качества изображения

Примеры промптов

О примерах промптов

Пример изображения в кодировке base64

Пример изображения на основе URL

Пример изображения с использованием Files API

Ограничения

FAQ

Глубже погрузитесь в зрение