跳到主要内容

代理 Anthropic 请求

Anthropic 提供了一个与 OpenAI 兼容的 API，使你能够使用熟悉的 OpenAI API 格式访问 Claude 模型。

本指南将介绍如何使用 ai-proxy 插件将 APISIX 与 Anthropic 集成。当 provider 设置为 anthropic 时，无需配置自定义端点。

前提条件​

  • 安装 Docker。
  • 安装 cURL 以便向服务发送请求进行验证。
  • 按照 入门教程 在 Docker 或 Kubernetes 上启动一个新的 APISIX 实例。

获取 Anthropic API Key​

按照 Anthropic API 文档 创建账户并生成 API Key。你也可以选择将 API Key 保存为环境变量：

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  # replace with your API key

创建指向 Anthropic 的路由​

以下示例通过自定义路径接收 OpenAI Chat Completions 请求。APISIX 会根据 messages 字段识别请求格式，并将请求发送到 Anthropic 的 OpenAI 兼容端点。如果要接收 Anthropic 原生 Messages 格式，请配置一个以 /v1/messages 结尾的路由 URI；详见 原生 Anthropic Messages API 透传。

按照如下方式创建一个启用 ai-proxy 插件的路由：

curl "http://127.0.0.1:9180/apisix/admin/routes" -X PUT --data-binary @- <<EOF
{
  "id": "anthropic-chat",
  "uri": "/anything",
  "plugins": {
    "ai-proxy": {
      "provider": "anthropic",
      "auth": {
        "header": {
          "Authorization": "Bearer $ANTHROPIC_API_KEY"
        }
      },
      "options": {
        "model": "claude-sonnet-4-5"
      }
    }
  }
}
EOF

❶ 将 provider 设置为 anthropic。

❷ 使用 Authorization 请求头附加 Anthropic API Key。

❸ 设置 Anthropic 支持的模型，例如 claude-sonnet-4-5。

验证​

向该路由发送如下请求：

curl "http://127.0.0.1:9080/anything" -X POST \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Hello"}]}'

你应当会收到类似如下的响应：

{
  "request": {
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ]
  },
  "response": {
    "id": "msg_01HUQ8fAR1XvJ9PodefrZixW",
    "object": "chat.completion",
    "created": 1770029318,
    "model": "claude-sonnet-4-5-20250929",
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Hello! How can I help you today?"
        }
      }
    ],
    "usage": {
      "prompt_tokens": 8,
      "completion_tokens": 12,
      "total_tokens": 20
    }
  }
}

下一步​

现在你已经学会如何将 APISIX 与 Anthropic 集成。更多详细信息，请参阅 Anthropic API 文档 和 模型 页面。