跳到主要内容

Claude 原生格式

本接口遵循 Anthropic Messages API。请求路径、消息字段和响应结构与 OpenAI Chat Completions 不同，使用前请确认客户端确实支持 Claude 原生协议。

请求​

POST /v1/messages
Content-Type: application/json
Authorization: Bearer sk-your-api-key
anthropic-version: 2023-06-01

也可以使用 Anthropic 原生的 x-api-key 请求头；在华明统一入口中，推荐使用平台 API Key 的 Bearer Token。

调用示例​

curl -X POST "https://www.walmind.cn/v1/messages" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "your-claude-model-id",
    "max_tokens": 512,
    "system": "你是一个严谨的技术助手。",
    "messages": [
      {"role": "user", "content": "解释一下向量数据库。"}
    ]
  }'

Python SDK 示例：

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["API_KEY"],
    base_url="https://www.walmind.cn",
)

message = client.messages.create(
    model="your-claude-model-id",
    max_tokens=512,
    system="你是一个严谨的技术助手。",
    messages=[{"role": "user", "content": "解释一下向量数据库。"}],
)
print(message.content)

常用参数​

参数类型说明
modelstring模型列表中的 Claude 模型 ID，必填
messagesarray对话消息，必填；通常从 user 角色开始
max_tokensinteger本次请求允许生成的最大 Token 数，必填
systemstring 或 array系统指令
temperaturenumber输出随机性，是否支持取决于模型
streamboolean是否使用 SSE 流式响应
toolsarray工具定义，需模型支持工具调用

响应示例​

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "your-claude-model-id",
  "content": [
    {"type": "text", "text": "向量数据库用于存储和检索向量表示。"}
  ],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 18, "output_tokens": 16}
}

anthropic-version 是协议版本标识，不是模型版本。不同 Claude 模型对工具、视觉输入和流式事件的支持范围可能不同。