协议与接口
Anthropic Messages
用 Anthropic Messages 协议调用 ModelTown 的模型，Claude Code、Anthropic SDK 使用这一协议。
首版设计
网关正在开发中，以下为首版接口设计。
ModelTown 提供兼容 Anthropic 格式的 Messages 接口，所有对话模型都可以用它调用。适合已经用 Anthropic SDK 写好的程序，以及 Claude Code。
注意地址写法
Anthropic 协议的 Base URL 是 https://api.example.cn，不带 /v1。SDK 和 Claude Code 会自动拼上 /v1/messages。写成 .../v1 会变成 /v1/v1/messages，返回 404。
最小请求
curl https://api.example.cn/v1/messages \
-H "x-api-key: $RELAY_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.7-plus",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "用三句话介绍你自己"}]
}'认证
请求头 x-api-key: <Key> 或 Authorization: Bearer <Key>，二选一，使用同一个 ModelTown Key。
与 Anthropic 官方的差异
| 项目 | 说明 |
|---|---|
| 模型名 | 填 ModelTown 的模型 ID，例如 deepseek-v4.1-flash，不支持 claude-* 模型名 |
max_tokens | 必填，平台据此预留余额 |
| 思考 | thinking 参数按模型能力转换；只支持思考模式的模型（如 Kimi K3）会始终思考 |
| 图片 | 支持 image 内容块（base64），仅限多模态模型 |
| 工具 | 支持 tools 与 tool_use / tool_result 内容块 |
temperature | 不同模型的取值范围可能不同，超出范围会返回 400 |
| 模型列表 | 请使用 OpenAI 格式的 GET /v1/models 查询 |
流式与计费
stream: true 时按 Anthropic 的 SSE 事件返回（message_start、content_block_delta、message_delta、message_stop），message_delta 中的 usage 为扣费依据。价格与 Chat Completions 相同。