Anthropic Messages

Anthropic Messages API 是 Claude 系列模型的核心接口，支持双认证方式（x-api-key 和 Bearer Token），提供强大的对话和工具调用能力。

接口信息

属性	值
基础 URL	https://api.quickapi.store
端点	POST /v1/messages
Content-Type	application/json
认证方式	x-api-key 或 Bearer Token

请求参数

参数	类型	必填	说明
model	string	是	模型名称，如 claude-sonnet-4-20250514、claude-3-5-sonnet-20241022、claude-3-haiku-20240307
messages	array	是	消息数组，Anthropic 格式（含 content 数组）
system	string	否	系统提示词
max_tokens	integer	是	最大输出 token 数
temperature	number	否	采样温度，0-1，默认 1
top_p	number	否	nucleus 采样，0-1，默认 1
top_k	integer	否	top-k 采样
stream	boolean	否	是否启用流式输出，默认 false
stop_sequences	array	否	停止词数组
tools	array	否	工具定义数组
tool_choice	object	否	工具调用策略

消息格式

Anthropic 使用 content 数组格式：

{
  "role": "user",
  "content": [
    {"type": "text", "text": "这张图片是什么？"},
    {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": "/9j/4AAQ..."}}
  ]
}

示例

使用 x-api-key 认证

curl https://api.quickapi.store/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
  }'

使用 Bearer Token 认证

curl https://api.quickapi.store/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "解释一下什么是机器学习"}
    ]
  }'

流式输出

curl https://api.quickapi.store/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      {"role": "user", "content": "写一篇关于人工智能的短文"}
    ]
  }'

多模态（图片）

curl https://api.quickapi.store/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "这张图片描述了什么内容？"},
          {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "iVBORw0KGgoAAAANSUhEUgAA..."}}
        ]
      }
    ]
  }'

响应示例

{
  "id": "msg_01Xyz123Abc",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [
    {
      "type": "text",
      "text": "你好！我是 Claude，由 Anthropic 开发的人工智能助手。我可以帮助你完成各种任务，包括回答问题、写作、编程、分析数据等。请问有什么我可以帮你的吗？"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 65
  }
}

Python 示例

import anthropic

client = anthropic.Anthropic(
    api_key="your-api-key",
    base_url="https://api.quickapi.store"
)

# 基础调用
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)
print(message.content[0].text)

# 带系统提示词
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    system="你是一个专业的技术写作助手",
    messages=[
        {"role": "user", "content": "帮我写一段产品介绍"}
    ]
)
print(message.content[0].text)

提示

Anthropic API 支持两种认证方式：x-api-key 头或标准 Authorization: Bearer 头，可根据项目需要灵活选择。

注意

max_tokens 是必填参数，若不填写将返回 400 错误。建议根据模型限制合理设置。