Skip to Content
API 參考Anthropic 原生協議Messages

Messages API

透過 Anthropic 原生協議建立 Claude 對話。OfoxAI 完全相容 Anthropic Messages API,你可以直接使用官方 SDK。

端點

POST https://api.ofox.ai/anthropic/v1/messages

認證

Anthropic 協議使用 x-api-key Header:

x-api-key: <你的 OFOXAI_API_KEY> anthropic-version: 2023-06-01

請求參數

參數類型必填說明
modelstring模型識別碼,如 anthropic/claude-sonnet-4.5
max_tokensnumber最大生成 token 數
messagesarray訊息陣列
systemstring系統提示詞
temperaturenumber取樣溫度 0-1
top_pnumber核取樣參數
top_knumberTop-K 取樣
streamboolean是否啟用串流回應
toolsarray工具定義
tool_choiceobject工具選擇策略

Message 格式

interface Message { role: 'user' | 'assistant' content: string | ContentBlock[] } type ContentBlock = | { type: 'text'; text: string } | { type: 'image'; source: { type: 'base64'; media_type: string; data: string } } | { type: 'tool_use'; id: string; name: string; input: object } | { type: 'tool_result'; tool_use_id: string; content: string }

請求範例

Terminal
curl https://api.ofox.ai/anthropic/v1/messages \ -H "x-api-key: $OFOX_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "anthropic/claude-sonnet-4.5", "max_tokens": 1024, "system": "你是一個專業的程式設計助手。", "messages": [ {"role": "user", "content": "用 Python 寫一個快速排序"} ] }'

回應格式

{ "id": "msg_abc123", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "以下是 Python 快速排序的實作..." } ], "model": "anthropic/claude-sonnet-4.5", "stop_reason": "end_turn", "usage": { "input_tokens": 25, "output_tokens": 200 } }

串流回應

anthropic_stream.py
with client.messages.stream( model="anthropic/claude-sonnet-4.5", max_tokens=1024, messages=[{"role": "user", "content": "講一個故事"}] ) as stream: for text in stream.text_stream: print(text, end="", flush=True)

支援的模型

模型說明
anthropic/claude-opus-4.6Claude Opus 4 — 最強能力
anthropic/claude-sonnet-4.5Claude Sonnet 4 — 均衡效能
anthropic/claude-haiku-4.5Claude Haiku 4.5 — 快速回應

OfoxAI 的 Anthropic 協議支援全部原生功能,包括 Vision、Tool Use、Prompt Caching、Extended Thinking 等。

Last updated on