Claude 相容協議

瞭解如何通過 Anthropic 官方原生協議（/v1/messages）將只支援 Claude 原生介面的客戶端、CLI 程式設計工具及 Anthropic SDK 接入 OpenRely。

協議概述

對於某些專門針對 Anthropic 生態構建的客戶端、命令列智慧體（如 Claude Code 原生模式、部分沉浸式翻譯外掛、Claude Desktop 外掛）以及使用官方 @anthropic-ai/sdk 的開發專案，通常只支援 Anthropic 原生 Messages 協議規範。

OpenRely API 原生支援 Anthropic /v1/messages 介面格式。您只需將請求 Base URL 重定向至 OpenRely，並填入您的 OpenRely API Key，即可免翻牆高速呼叫 Claude 等全球頂尖模型。

📌 核心連線規範

引數項	標準填寫值	說明
API 服務地址 (Base URL)	`https://api.openrely.ai`	若客戶端底層自動補齊 `/v1/messages`，填根域名即可；部分工具可能要求填 `https://api.openrely.ai/v1`
鑑權請求頭 (Headers)	`x-api-key: sk-••••`	填入您的 OpenRely API Key（系統同時自動相容 `Authorization: Bearer sk-••••`）
版本控制頭 (Version)	`anthropic-version: 2023-06-01`	Anthropic 官方推薦的標準 API 版本號
資料格式	`Content-Type: application/json`	標準 JSON 請求與響應體

⚡ 核心端點與請求示例

訊息建立 (Messages API)

Anthropic 官方核心的訊息對話端點，原生支援 Thinking 深度思考過程、Prompt Caching 提示詞快取與工具呼叫。

端點：POST /v1/messages
完整 URL：https://api.openrely.ai/v1/messages

請求示例 (Request)

curl -X POST "https://api.openrely.ai/v1/messages" \
  -H "x-api-key: sk-••••" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello Claude!" }
    ]
  }'

響應示例 (Response)

{
  "id": "msg_01XyZ987...",
  "type": "message",
  "role": "assistant",
  "model": "claude",
  "content": [
    {
      "type": "text",
      "text": "Claude message routed."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 11,
    "output_tokens": 18
  }
}

🛠️ 客戶端與 SDK 快速整合

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.openrely.ai",
    api_key="sk-your-openrely-key",
)

message = client.messages.create(
    model="claude",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "用一句话介绍你自己"}
    ],
)

print(message.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  baseURL: 'https://api.openrely.ai',
  apiKey: 'sk-your-openrely-key',
});

const response = await anthropic.messages.create({
  model: 'claude',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello Claude!' }],
});

console.log(response.content[0].text);

若您使用的第三方 CLI 工具遵循 Anthropic 官方環境變數命名規範，可在終端中直接執行：

export ANTHROPIC_BASE_URL="https://api.openrely.ai"
export ANTHROPIC_API_KEY="sk-your-openrely-key"