Главная / Документация / Распознавание изображений и передача изображений на вход

Распознавание изображений и передача изображений на вход

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

Модели Claude и Gemini принимают изображения вместе с текстом. Изображения представляют собой блоки содержимого внутри обычного сообщения.

Изображение в Base64

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image", "source": {
        "type": "base64",
        "media_type": "image/png",
        "data": "iVBORw0KGgoAAAANSUhEUg..."
      }},
      {"type": "text", "text": "What does this chart show?"}
    ]
  }]
}

Python

import base64, anthropic

img = base64.standard_b64encode(open(class="s">"chart.png", class="s">"rb").read()).decode()

client = anthropic.Anthropic(api_key=class="s">"sk-your-key", base_url=class="s">"https://aiprimetech.io")
msg = client.messages.create(
    model=class="s">"claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{class="s">"role": class="s">"user", class="s">"content": [
        {class="s">"type": class="s">"image", class="s">"source": {class="s">"type": class="s">"base64",
         class="s">"media_type": class="s">"image/png", class="s">"data": img}},
        {class="s">"type": class="s">"text", class="s">"text": class="s">"What does this chart show?"},
    ]}],
)
print(msg.content[0].text)

Практические ограничения

ОграничениеРекомендации
ФорматыPNG, JPEG, GIF и WebP
РазрешениеОчень большие изображения уменьшаются на стороне сервиса. Уменьшение длинной стороны примерно до 1500 пикселей перед отправкой экономит токены без потери качества.
СтоимостьИзображения оплачиваются как входные токены, примерно пропорционально площади. Скриншот всей страницы может стоить дороже страницы текста.
Несколько изображенийВ одном сообщении допускается несколько блоков изображений; каждый из них оплачивается.
В цикле работы агента изображения повторно отправляются вместе с историей на каждом шаге, как и любое другое содержимое. Удаляйте их из истории после того, как они были описаны, иначе за один скриншот придётся платить многократно.