Trang chủ / Tài liệu / Thị giác và đầu vào hình ảnh

Thị giác và đầu vào hình ảnh

Gửi hình ảnh đến các mô hình đa phương thức — cách mã hóa, giới hạn kích thước và chi phí.

Các mô hình Claude và Gemini chấp nhận hình ảnh cùng với văn bản. Hình ảnh là các khối nội dung trong một tin nhắn thông thường.

Hình ảnh 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)

Giới hạn thực tế

Ràng buộcHướng dẫn
Định dạngPNG, JPEG, GIF và WebP
Độ phân giảiHình ảnh rất lớn được giảm kích thước ở phía thượng nguồn. Đổi kích thước cạnh dài xuống khoảng 1500px trước khi gửi giúp tiết kiệm token mà không làm giảm chất lượng.
Chi phíHình ảnh được tính phí dưới dạng token đầu vào, gần như tỷ lệ thuận với diện tích. Một ảnh chụp toàn trang có thể tốn nhiều hơn một trang văn bản.
Nhiều hình ảnhMỗi tin nhắn được phép có nhiều khối hình ảnh; mỗi khối đều được tính phí.
Trong vòng lặp tác nhân, hình ảnh được gửi lại cùng lịch sử ở mỗi lượt như mọi nội dung khác. Hãy loại chúng khỏi bản ghi hội thoại sau khi đã được mô tả, nếu không bạn sẽ phải trả phí nhiều lần cho cùng một ảnh chụp màn hình.