Anthropic 协议

原生支持 Anthropic Messages 协议。可直接使用 Claude Code、Anthropic SDK 或任何 Anthropic 兼容客户端。

端点

POST https://api.dsesnet.com/v1/messages

请求示例

{
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

必需的 HTTP 头

Header	值	说明
Authorization	Bearer gw-your-key	网关 API Key
anthropic-version	2023-06-01	Anthropic API 版本（必需）
Content-Type	application/json	请求体格式

参数说明

参数	类型	必填	说明
model	string	是	模型 ID（如 claude-sonnet-4-20250514）
messages	array	是	对话消息数组
max_tokens	integer	是	最大生成 Token 数
system	string	否	系统提示词（顶层字段，不在 messages 中）
stream	boolean	否	启用 SSE 流式响应
temperature	number	否	采样温度（0-1）
tools	array	否	工具定义（函数调用）
thinking	object	否	扩展思考配置

响应示例

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [
    {"type": "text", "text": "The capital of France is Paris."}
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 9
  }
}

使用 curl

curl -X POST https://api.dsesnet.com/v1/messages \
  -H "Authorization: Bearer gw-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

使用 Python (Anthropic SDK)

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.dsesnet.com",
    api_key="gw-your-key-here",
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(message.content[0].text)

流式响应

设置 "stream": true 接收 Anthropic SSE 事件（message_start、content_block_delta、message_delta、message_stop）：

curl -X POST https://api.dsesnet.com/v1/messages \
  -H "Authorization: Bearer gw-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Claude Code 配置

在终端设置以下环境变量即可让 Claude Code 使用本网关：

# ~/.bashrc or ~/.zshrc
export ANTHROPIC_BASE_URL=https://api.dsesnet.com
export ANTHROPIC_AUTH_TOKEN=gw-your-key-here
export ANTHROPIC_API_KEY=""  # explicitly empty to prevent fallback

Claude Code 会自动将请求发送到 https://api.dsesnet.com/v1/messages。

支持的功能

所有 Anthropic 功能都会透明代理到上游：

• 扩展思考（thinking 参数）
• Prompt 缓存（消息中的 cache_control）
• 工具使用 / 函数调用（tools 参数）
• 视觉（消息中的图片）
• PDF 处理
• anthropic-beta header 用于 beta 功能

与 OpenAI Chat Completions 的区别

维度	OpenAI	Anthropic
端点	/v1/chat/completions	/v1/messages
系统提示词	在 messages 数组中	顶层 system 字段
Token 字段	prompt_tokens / completion_tokens	input_tokens / output_tokens
SSE 格式	data: ... + [DONE]	事件类型：message_start、content_block_delta 等
必需 Header	无	anthropic-version: 2023-06-01

两种协议共享同一套 API Key、余额和计费系统。选择与你的 SDK 匹配的协议即可。