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

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

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

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

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

Вы можете включить несколько изображений в один запрос (до 20 для claude.ai и 100 для запросов API). Claude будет анализировать все предоставленные изображения при формулировании своего ответа. Это может быть полезно для сравнения или противопоставления изображений. Если вы отправите изображение размером более 8000x8000 пикселей, оно будет отклонено. Если вы отправите более 20 изображений в одном запросе API, это ограничение составляет 2000x2000 пикселей.
Хотя API поддерживает 100 изображений на запрос, существует ограничение размера запроса 32 МБ для стандартных конечных точек.

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

Для оптимальной производительности мы рекомендуем изменять размер изображений перед загрузкой, если они слишком большие. Если длинный край вашего изображения превышает 1568 пикселей или ваше изображение содержит более ~1600 токенов, оно сначала будет масштабировано вниз, сохраняя соотношение сторон, пока не будет находиться в пределах ограничений размера. Если ваше входное изображение слишком большое и требует изменения размера, это увеличит задержку time-to-first-token, не давая вам никакого дополнительного улучшения производительности модели. Очень маленькие изображения размером менее 200 пикселей с любой стороны могут снизить производительность.
Чтобы улучшить time-to-first-token, мы рекомендуем изменять размер изображений не более чем до 1,15 мегапикселей (и в пределах 1568 пикселей в обоих измерениях).
Вот таблица максимальных размеров изображений, принимаемых нашим API, которые не будут изменены для распространенных соотношений сторон. С моделью Claude Sonnet 3.7 эти изображения используют примерно 1600 токенов и около $4,80/1K изображений.
Соотношение сторонРазмер изображения
1:11092x1092 px
3:4951x1268 px
2:3896x1344 px
9:16819x1456 px
1:2784x1568 px

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

Каждое изображение, которое вы включаете в запрос к Claude, учитывается в использовании ваших токенов. Чтобы рассчитать приблизительную стоимость, умножьте приблизительное количество токенов изображения на цену за токен модели, которую вы используете. Если ваше изображение не требует изменения размера, вы можете оценить количество используемых токенов с помощью этого алгоритма: tokens = (width px * height 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 тремя способами:
  1. Как изображение, закодированное в base64, в блоках содержимого image
  2. Как ссылка URL на изображение, размещенное в Интернете
  3. Используя 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-5",
    "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-5",
    "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 "[email protected]"

# Затем используйте возвращенный 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-5",
    "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-5",
    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."
                }
            ],
        }
    ],
)
В ситуациях, когда есть несколько изображений, представьте каждое изображение с Image 1: и Image 2: и так далее. Вам не нужны разрывы строк между изображениями или между изображениями и подсказкой.Попросите Claude описать различия между несколькими изображениями.
РольСодержание
ПользовательИзображение 1: [Изображение 1] Изображение 2: [Изображение 2] Чем эти изображения отличаются?
Вот соответствующий вызов API с использованием модели Claude Sonnet 3.7.
Python
message = client.messages.create(
    model="claude-sonnet-4-5",
    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?"
                }
            ],
        }
    ],
)
Попросите Claude описать различия между несколькими изображениями, дав ему системную подсказку о том, как ответить.
Содержание
СистемаОтвечайте только на испанском языке.
ПользовательИзображение 1: [Изображение 1] Изображение 2: [Изображение 2] Чем эти изображения отличаются?
Вот соответствующий вызов API с использованием модели Claude Sonnet 3.7.
Python
message = client.messages.create(
    model="claude-sonnet-4-5",
    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?"
                }
            ],
        }
    ],
)
Возможности зрения 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 для задач, требующих идеальной точности или чувствительного анализа изображений без надзора человека.

​
Часто задаваемые вопросы

Claude в настоящее время поддерживает форматы изображений JPEG, PNG, GIF и WebP, в частности:
  • image/jpeg
  • image/png
  • image/gif
  • image/webp
Да, 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"
  }
}
Да, есть ограничения:
  • API: максимум 5 МБ на изображение
  • claude.ai: максимум 10 МБ на изображение
Изображения, превышающие эти ограничения, будут отклонены и вернут ошибку при использовании нашего API.
Ограничения на изображения:
  • Messages API: до 100 изображений на запрос
  • claude.ai: до 20 изображений за ход
Запросы, превышающие эти ограничения, будут отклонены и вернут ошибку.
Нет, Claude не анализирует и не получает никакие метаданные из изображений, переданных ему.
Нет. Загрузки изображений являются эфемерными и не сохраняются за пределами продолжительности запроса API. Загруженные изображения автоматически удаляются после их обработки.
Пожалуйста, обратитесь к нашей странице политики конфиденциальности для получения информации о том, как мы обрабатываем загруженные изображения и другие данные. Мы не используем загруженные изображения для обучения наших моделей.
Если интерпретация изображения Claude кажется неправильной:
  1. Убедитесь, что изображение четкое, высокого качества и правильно ориентировано.
  2. Попробуйте методы инженерии подсказок для улучшения результатов.
  3. Если проблема сохраняется, отметьте результат в claude.ai (большой палец вверх/вниз) или свяжитесь с нашей командой поддержки.
Ваша обратная связь помогает нам улучшаться!
Нет, Claude — это модель только для понимания изображений. Она может интерпретировать и анализировать изображения, но не может генерировать, производить, редактировать, манипулировать или создавать изображения.

​
Углубитесь в зрение

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