原生 Claude 格式
Anthropic Claude Messages API 格式的請求。需要在請求頭中包含 anthropic-version。
注意: 請求頭必須包含 anthropic-version(如 2023-06-01)。認證可使用 Authorization: Bearer,也可使用 x-api-key。
示例模型
下文均以 claude-3-opus-20240229(Claude 3 Opus)為例;更換其他模型時,請替換 model 參數,並參考控制台模型說明調整 size、quality 等欄位。
建立訊息
POST
https://token.easyapi.com/v1/messages使用 Anthropic Claude Messages API 格式建立對話回應。完整路徑為 POST /v1/messages。
請求參數
| 名稱 | 位置 | 類型 | 必選 | 說明 |
|---|---|---|---|---|
Authorization | header | string | 是 | EasyAPI API Key。格式:Bearer `API_KEY` |
Content-Type | header | string | 是 | 请求体格式,固定 application/json |
anthropic-version | header | string | 是 | Anthropic API 版本,必填,例如 2023-06-01 |
x-api-key | header | string | 否 | Anthropic API Key(可選,也可使用 Bearer Token) |
請求體
| 名稱 | 類型 | 必選 | 說明 |
|---|---|---|---|
model | string | 是 | 模型 ID,示例 claude-3-opus-20240229 |
messages | array<object> | 是 | 對話訊息列表,每項含 role 與 content |
max_tokens | integer | 是 | 最大生成 Token 數,範圍 ≥ 1 |
system | string | array<object> | 否 | 系統提示,可為字串或內容塊陣列 |
temperature | number | 否 | 取樣溫度,範圍 0–1 |
top_p | number | 否 | 核取樣參數 |
top_k | integer | 否 | 僅從機率最高的 K 個 token 中取樣 |
stream | boolean | 否 | 是否啟用串流回應 |
stop_sequences | array<string> | 否 | 自訂停止序列 |
tools | array<object> | 否 | 可呼叫的工具定義列表 |
tool_choice | object | 否 | 工具選擇策略 |
thinking | object | 否 | 延伸思考設定(支援思考的模型) |
metadata | object | 否 | 請求中繼資料 |
示例
{
"model": "claude-3-opus-20240229",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"max_tokens": 1024
}響應示例
{
"id": "msg_01XFDUDYJgAACzvnptvVoYEL",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello! How can I help you today?"
}
],
"model": "claude-3-opus-20240229",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 10,
"output_tokens": 20,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}