您是想使用 Anthropic 的 Claude 3 Opus(例如模型 ID:claude-3-opus-20240229)嗎?「Claude Opus 4.7」並非標準型號名稱。若有特定版本請告知,下列以 Anthropic Messages API 舉例說明通用用法(把 model 替換成您實際要用的模型 ID,如最新的 Opus/Sonnet/Haiku)。
- 準備
- 申請並保存 API Key(Anthropic 帳號)
- 選擇模型 ID(例如:claude-3-opus-20240229)
- 決定使用純 HTTP 還是官方 SDK(Node/Python)
- HTTP 請求要點
- Endpoint: https://api.anthropic.com/v1/messages
- 方法: POST
- Headers:
- Authorization: Bearer YOUR_API_KEY
- Content-Type: application/json
- anthropic-version: 2023-06-01
- Request JSON(最小示例):
{
"model": "claude-3-opus-20240229",
"max_tokens": 1024,
"temperature": 0.7,
"messages": [
{"role": "user", "content": "請用三點說明如何開始使用 Claude API"}
]
}
- cURL 範例
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-3-opus-20240229",
"max_tokens": 512,
"messages": [{"role": "user", "content": "Hello, Claude!"}]
}'
- Node.js(官方 SDK)
安裝:npm install @anthropic-ai/sdk
使用:
const Anthropic = require("@anthropic-ai/sdk");
const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
const msg = await client.messages.create({
model: "claude-3-opus-20240229",
max_tokens: 1024,
temperature: 0.7,
messages: [{ role: "user", content: "給我一個行銷標語" }]
});
console.log(msg.content[0].text);
- Python(官方 SDK)
安裝:pip install anthropic
使用:
from anthropic import Anthropic
client = Anthropic(api_key="YOUR_API_KEY")
msg = client.messages.create(
model="claude-3-opus-20240229",
max_tokens=1024,
temperature=0.7,
messages=[{"role": "user", "content": "請列出三個產品優勢"}]
)
print(msg.content[0].text)
- 流式輸出(SSE)
- 在請求中加入 "stream": true(cURL 加 -N),伺服器會以事件流回傳分段內容,適合即時顯示。
- cURL:
curl -N https://api.anthropic.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-3-opus-20240229",
"max_tokens": 512,
"stream": true,
"messages": [{"role": "user", "content": "請即時輸出"}]
}'
- 常用參數
- max_tokens:限制回應長度(必填)
- temperature:取值 0–1,越高越有創意
- system:系統提示(例如角色/風格設定),用法同 messages 的 content
- stop_sequences:指定停止序列
- metadata:自定義標註
- messages 結構:[{ role: "user"|"assistant"|"system", content: "文字或內容塊" }]
- 多模態與工具(進階)
- 多模態(文字+圖片):在 content 中加入圖片內容塊(base64 或 URL)
- 工具調用(function calling):定義 tools 與 tool_choice,讓模型產出結構化參數(需對應當前版本文檔)
- 錯誤與限制
- 401/403:API Key 或權限問題
- 429:速率限制,實作退避重試
- 529/5xx:服務端暫時性錯誤,建議重試
- 請勿把 API Key 置於前端或公開倉庫;設置請求超時與重試策略
如您確定實際欲用的模型名稱(例如您所稱的「Claude Opus 4.7」對應哪個正式模型 ID),請告訴我,我可以據此給出精確的請求範例與最佳化參數建議。
Claude Opus 4.7(模型 ID:`claude-opus-4-7`)是 Anthropic 最強大的公開可用模型,於 2026 年 4 月 16 日發布。它在代理式編碼、高解析度多模態視覺(最高至 3.75MP)、自適應思考與長時間運行的工作流程方面帶來躍進式提升,同時將每百萬輸入/輸出 tokens 的費率維持在 $5/$25。透過 CometAPI 使用,可享有 20-40% 更低的定價、單一金鑰與即時模型切換—無供應商鎖定。