Sub2API Anthropic Messages API 接口说明

Sub2API 支持 Anthropic 原生 Messages API 格式，允许你直接使用 anthropic SDK 或原生 HTTP 请求调用 Claude 系列模型。相比使用 OpenAI 兼容格式，原生 Messages API 提供了更符合 Anthropic 设计哲学的接口结构。

接口端点

POST https://sub2api.ruilinlu.com/v1/messages

TODO: 请在后台确认实际配置后填写正确的端点路径。

认证方式

Anthropic Messages API 支持以下两种认证方式:

x-api-key Header
Authorization Bearer

x-api-key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

请求参数

string

required

Claude 模型名称，例如 claude-3-5-sonnet、claude-3-opus 等。具体可用模型请参考 Claude 模型列表。

array

required

对话消息数组。每条消息包含:

role: 消息角色，可选 user 或 assistant
content: 消息内容(字符串)

[
  {"role": "user", "content": "你好，请介绍一下自己。"}
]

integer

required

生成内容的最大 Token 数量。Anthropic 格式中此参数为必填项，不能省略。

string

系统提示词，用于设定 AI 的行为和角色。与 OpenAI 格式不同，Anthropic 格式中 system prompt 是顶层字段，而非 messages 数组中的第一条消息。

完整请求示例

以下请求展示了带系统提示和多条对话消息的结构:

curl -X POST https://sub2api.ruilinlu.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "claude-3-5-sonnet",
    "system": "你是一个专业的技术文档撰写助手。",
    "messages": [
      {"role": "user", "content": "请帮我写一段 API 文档的简介。"},
      {"role": "assistant", "content": "好的，请问是关于什么主题的 API？"},
      {"role": "user", "content": "是关于 AI 模型网关的 REST API。"}
    ],
    "max_tokens": 1024
  }'

from anthropic import Anthropic

client = Anthropic(
    base_url="https://sub2api.ruilinlu.com",
    api_key="YOUR_API_KEY"
)

message = client.messages.create(
    model="claude-3-5-sonnet",
    system="你是一个专业的技术文档撰写助手。",
    messages=[
        {"role": "user", "content": "请帮我写一段 API 文档的简介。"},
        {"role": "assistant", "content": "好的，请问是关于什么主题的 API？"},
        {"role": "user", "content": "是关于 AI 模型网关的 REST API。"}
    ],
    max_tokens=1024
)

print(message.content[0].text)

使用 anthropic SDK 时，必须将 base_url 设置为 https://sub2api.ruilinlu.com，SDK 默认指向 Anthropic 官方服务器。

响应结构

{
  "id": "msg_01AbCdEfGhIjKlMnOpQrStUv",
  "type": "message",
  "role": "assistant",
  "model": "claude-3-5-sonnet",
  "content": [
    {
      "type": "text",
      "text": "好的，以下是 API 文档简介:\n\n本 API 提供统一的网关服务..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 45,
    "output_tokens": 123
  }
}

重要注意事项

max_tokens 是必填字段: Anthropic Messages API 要求 max_tokens 参数必须提供，这与 OpenAI 的 Chat Completions API 不同，后者的 max_tokens 是可选的。

系统提示的位置: 在 Anthropic 格式中，system 是请求对象顶层的独立字段。而在 OpenAI 兼容格式中，system prompt 是 messages 数组中 role 为 system 的第一条消息。

概述

接口文档

Sub2API Anthropic Messages API 接口说明

接口端点

认证方式

请求参数

完整请求示例

响应结构

重要注意事项

相关资源

​接口端点

​认证方式

​请求参数

​完整请求示例

​响应结构

​重要注意事项

​相关资源

接口端点

认证方式

请求参数

完整请求示例

响应结构

重要注意事项

相关资源