對應 Anthropic 官方 Messages API 規格。
POST /fyu/api/anthropic/v1/messagesClaude Messages API (Claude Opus / Sonnet / Haiku),支援 streaming、prompt caching 與 thinking。server 端工具僅支援網頁搜尋(Code Execution 與 Files API 不支援,詳見下方支援矩陣)。
curl https://www.myai168.com/fyu/api/anthropic/v1/messages \
-H "x-api-key: YOUR_DEV_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-opus-4-8","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'
import requests
r = requests.post(
"https://www.myai168.com/fyu/api/anthropic/v1/messages",
headers={
"x-api-key": "YOUR_DEV_KEY",
"anthropic-version": "2023-06-01",
},
json={"model": "claude-opus-4-8", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]},
)
print(r.json())
部分 Anthropic SDK 功能經本站中繼時行為不同,接入前請先對照本表,避免踩坑。
GET /v1/models —— 支援。回傳的清單就是本中繼實際受理的模型;不在清單內的模型一律回 "No pricing info! Please use other models!"。POST /v1/messages —— 支援,含串流、prompt caching(按官方快取費率計費)與 thinking。POST /v1/messages/count_tokens —— 支援,免費。web_search_* type)—— 支援並按次計費。mcp_servers)與 Files API —— 不支援,回 HTTP 400;請改用 client 端 tool use。原因:中繼端所有使用者共用同一個上游工作區,開放 Files API/code execution 容器會產生跨使用者檔案存取風險,基於資安不提供。X-Cost-Points(本次扣點)與 X-Credits-Remaining(扣後餘額)header;也可隨時以 GET /fyu/api/user/get_credits 查詢餘額。請求本體為 JSON,與 Anthropic 官方 Messages API 規格相同。認證帶 x-api-key: YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY 標頭(金鑰不可放在網址查詢參數)。
| 參數 | 型別 | 必填 | 說明 |
|---|---|---|---|
model | string | 必填 | 模型代號(例 claude-opus-4-8)。必須在 GET /v1/models 回傳清單內,否則回 400 與 "No pricing info! Please use other models!"。 |
max_tokens | integer | 必填 | 回覆 token 上限(官方規格必填)。 |
messages | array | 必填 | 對話訊息陣列,每筆 {"role": "user" | "assistant", "content": "..."};content 也可為多段內容區塊(含 base64 圖片)。 |
system | string | 選填 | 系統提示詞。 |
stream | boolean | 選填 | true 時以 SSE 串流回應。 |
thinking | object | 選填 | 延伸思考設定(官方規格透傳)。 |
tools | array | 選填 | client 端 tool use 定義照官方規格透傳;server 端工具僅接受網頁搜尋(web_search_*),其餘回 400。 |
temperature/top_p/stop_sequences 等 | — | 選填 | 其餘官方參數原樣透傳。 |
非串流:官方 message 物件——文字在 content[0].text,用量在 usage.input_tokens/usage.output_tokens;回應標頭另帶 X-Cost-Points(本次扣點)與 X-Credits-Remaining(扣後餘額)。
串流:SSE 事件流(message_start/content_block_delta/message_delta/message_stop),文字增量在 content_block_delta 的 delta.text。
curl -N https://www.myai168.com/fyu/api/anthropic/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":1024,"stream":true,"messages":[{"role":"user","content":"Hello"}]}'
| HTTP 狀態 | 意義 |
|---|---|
401 | 金鑰缺漏或無效(同 IP 連續失敗會被暫時封鎖)。 |
402 | 點數不足(請先儲值)。 |
400 | 請求本體格式錯誤、模型不在支援清單("No pricing info! Please use other models!"),或帶了不支援的 server 端工具。 |
502 | 上游供應商錯誤——一律不扣點。 |
任何錯誤(含供應商未回用量資訊)一律不扣點。