Messages API（Anthropic 原生）

POST /v1/messages 参考，这是兼容 Anthropic 的端点，支持 Claude 与 DeepSeek V4、流式响应、工具、视觉和用量计费。

使用 Anthropic 原生协议调用 Claude 或 DeepSeek V4 模型。兼容官方 Anthropic Python / TypeScript SDK，只需把 base_url 指向 LEAPERone。

端点

POST https://api.leaper.one/v1/messages

身份认证

使用与兼容 OpenAI 端点相同的 LEAPERone API Key。以下两种请求头都可以使用：

Authorization: Bearer sk-your-leaperone-key
x-api-key: sk-your-leaperone-key（Anthropic 风格）

还必须提供：

anthropic-version: 2023-06-01

参数

请求体遵循标准 Anthropic Messages 格式。完整结构参阅官方文档。

参数	类型	必填	说明
model	string	是	兼容 Anthropic 的模型 ID，见下表
max_tokens	integer	是	最多生成的 token 数
messages	array	是	`{ role, content }` 数组
system	string \| array	否	系统提示词或内容块
stream	boolean	否	Anthropic 事件格式的 SSE 流
temperature	number	否	0-1
tools	array	否	工具定义
tool_choice	object	否	`auto` / `any` / `tool`
thinking	object	否	使用 `{ "type": "enabled", "budget_tokens": N }` 开启扩展思考

支持的模型

模型 ID	说明
`claude-fable-5`	旗舰模型
`claude-opus-4-8`
`claude-opus-4-7`
`claude-opus-4-6`
`claude-sonnet-5`
`claude-sonnet-4-6`	默认均衡模型
`claude-haiku-4-5`	最快 / 最便宜
`deepseek-v4-flash`	DeepSeek 官方端点
`deepseek-v4-pro`	DeepSeek 官方端点

价格与 Chat Completions 网关一致，单位为每 100 万 token 的美元价格。参阅模型列表。

请求（curl）

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

请求（Anthropic Python SDK）

import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-leaperone-key",
    base_url="https://api.leaper.one",
)

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

响应

{
  "id": "msg_01Abc...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "Hi there!" }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

设置 "stream": true 后，接口会返回 Anthropic SSE 事件流，包括 message_start、content_block_start、content_block_delta、message_delta、message_stop。用量从 message_start 的 input_tokens 和 message_delta 的 output_tokens 中累计；LEAPERone 按最终合并的用量计费。

注意事项

GPT 和 Auto 路由仍使用 /v1/chat/completions。
Claude 的工具调用、视觉输入（图片内容块）和扩展思考会原样透传。DeepSeek 能力取决于其上游兼容 Anthropic 的 API。
扩展思考和大上下文等长请求目前共用 120 秒上游超时。接近限制时请拆分重任务。

目录