建立訊息

Anthropic Messages API：Claude 模型專用，Base URL 不帶 /v1，Anthropic SDK 與 Claude Code 直接可用。

POST/v1/messages

Claude 模型走 Anthropic 協定。SDK 的 Base URL 填 https://api.hop-base.com（不帶 /v1），請求路徑仍是 /v1/messages；另支援 POST /v1/messages/count_tokens。

下表只列網關會補值或特別處理的部分；其餘 Messages API 欄位原樣轉發，取值範圍按 Anthropic 官方規格。Claude 金鑰調 OpenAI 協定路徑會回傳 404「當前平臺不支持該 API 路徑」。

建立訊息

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: $HOPBASE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

200application/json

{
  "id": "msg_EXAMPLE",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5",
  "content": [
    {
      "type": "text",
      "text": "你好！有什麼可以幫你？"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 9,
    "output_tokens": 14,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

請求標頭

Authorization:選填string

Bearer sk-…；也可改用 x-api-key: sk-…，二者擇一

anthropic-version:選填string

SDK 會自動帶上，原樣轉發，例如 2023-06-01

anthropic-beta:選填string

Beta 功能開關，原樣轉發

請求主體參數JSON

model:必填string

目前金鑰分組內的 Claude 模型 ID；分組不包含該模型時回傳 404 model_not_found

max_tokens:選填integer

網關不設上限，最大值按模型官方規格。官方 API 要求必填，HopBase 在未傳時補為 4096：長輸出會在 4096 處截斷（stop_reason: "max_tokens"），請明確設定

預設4096

messages:必填array of object

按 Anthropic 官方格式，原樣轉發

數量≥ 1 項

system:選填string 或 array

系統提示詞，原樣轉發

stream:選填boolean

true 回傳 Anthropic SSE 事件流

預設false

tools:選填array of object

Anthropic 工具定義（name、description、input_schema），原樣轉發

thinking:選填object

延伸思考配置，原樣轉發，取值按 Anthropic 官方規格

temperature:選填number

原樣轉發，範圍按 Anthropic 官方規格

回傳

200成功。非串流為 message JSON；stream: true 時為 Anthropic SSE

id:選填string

訊息 ID

type:選填"message"

role:選填"assistant"

model:選填string

模型 ID

content:選填array of object

內容塊

stop_reason:選填string

end_turn / max_tokens / tool_use / stop_sequence

usage:選填object

Token 用量

錯誤

400Anthropic 結構：{"type":"error","error":{"type":"invalid_request_error","message":"…"}}，沒有 code。金鑰校驗階段的錯誤（401、402、403）仍為 OpenAI 結構

401沒帶金鑰、金鑰無效或已過期（missing_api_key / invalid_api_key / api_key_expired）

402餘額或金鑰 / 成員 / 部門額度用完（insufficient_quota）

404模型不在這把金鑰的分組裡（model_not_found），或路徑不屬於該分組（route_not_found）

413請求體超過 60 MB（request_too_large）

429帳戶或金鑰並行已達上限（user_concurrency_limit / apikey_concurrency_limit），帶 Retry-After

請求標頭

請求主體參數JSON

回傳

錯誤

相關頁面