Messages - 视觉（图片理解 URL）

POST

/v1/messages

Claude 视觉理解 - 直接传入图片 URL（需公开可访问）

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://newapi.mexxxxai.win/v1/messages' \
--header 'x-api-key: {{ANTHROPIC_API_KEY}}' \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "image", "source": {"type": "url", "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png"}},
        {"type": "text", "text": "这张图片里有什么？"}
      ]
    }
  ]
}'

Response Example

{
  "id": "msg_06URLVISIONabc",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "这是一张 PNG 格式透明度演示图。图片中展示了一个骰子（显示数字6的那面朝上），骰子悬浮在棋盘格背景之上。棋盘格图案（灰色和白色交替的方块）是图像编辑软件（如 Photoshop、GIMP）用来表示图像透明区域的标准视觉标记，说明骰子周围的背景是透明的（具有 Alpha 通道），而非白色或其他颜色。"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": { "input_tokens": 1158, "output_tokens": 94 }
}

Modified at 2026-04-02 11:32:32

Messages - 视觉（图片理解 Base64）

Messages - Tool Use（工具调用）