跳轉到主要內容
POST
/
v1
/
messages
curl -X POST https://qingbo.dev/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "system": "你是一个专业的AI助手。",
    "messages": [
      {
        "role": "user",
        "content": "解释一下冒泡排序算法。"
      }
    ]
  }'

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
"type": "message",
"role": "assistant",
"content": [
  {
    "type": "text",
      "text": "你好！我是Claude。很高兴见到你。"
  }
],
  "model": "claude-sonnet-4-5-20250929",
"stop_reason": "end_turn",
  "stop_sequence": null,
"usage": {
    "input_tokens": 12,
    "output_tokens": 18
}
}
  • 完全相容 Claude Messages API 格式
  • 支援多輪對話和單次查詢
  • 支援文字、圖像等多模態內容
curl -X POST https://qingbo.dev/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "system": "你是一个专业的AI助手。",
    "messages": [
      {
        "role": "user",
        "content": "解释一下冒泡排序算法。"
      }
    ]
  }'

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
"type": "message",
"role": "assistant",
"content": [
  {
    "type": "text",
      "text": "你好！我是Claude。很高兴见到你。"
  }
],
  "model": "claude-sonnet-4-5-20250929",
"stop_reason": "end_turn",
  "stop_sequence": null,
"usage": {
    "input_tokens": 12,
    "output_tokens": 18
}
}

​
Authorizations

​
x-api-key
string
必填
API 金鑰用於身份驗證存取 API Key 管理頁面 取得您的 API Key在請求標頭中新增：
x-api-key: YOUR_API_KEY
​
anthropic-version
string
必填
API 版本號指定要使用的 Claude API 版本範例：2023-06-01

​
Body

​
model
string
必填
模型名稱
  • claude-haiku-4-5-20251001 - Claude 4.5 快速回應版本
  • claude-sonnet-4-5-20250929 - Claude 4.5 平衡版本
  • claude-opus-4-1-20250805 - 最強大的 Claude 4.1 旗艦模型
  • claude-opus-4-1-20250805-thinking - Claude 4.1 Opus 深度思考版
  • claude-sonnet-4-5-20250929-thinking - Claude 4.5 Sonnet 深度思考版
​
messages
array
必填
訊息列表，支援交替的 user 和 assistant 角色
​
max_tokens
integer
必填
最大生成 token 數生成停止前的最大 token 數量。模型可能會在達到此限制前停止。不同模型有不同的最大值，請參考模型文件。最小值：1
​
system
string | array
系統提示詞系統提示詞用於設定 Claude 的角色、個性、目標和指令。字串格式：
{
  "system": "你是一位专业的Python编程导师"
}
結構化格式：
{
  "system": 
  [
    {
      "type": "text",
      "text": "你是一位专业的Python编程导师"
    }
  ]
}
​
temperature
number
溫度參數，範圍 0-1控制輸出的隨機性：
  • 低值（如 0.2）：更確定、更保守
  • 高值（如 0.8）：更隨機、更有創意
預設值：1.0
​
top_p
number
核取樣參數，範圍 0-1使用 nucleus sampling。建議使用 temperature 或 top_p 其中之一，不要同時使用。預設值：1.0
​
top_k
integer
Top-K 取樣只從機率最高的 K 個選項中取樣，用於移除「長尾」低機率回應。建議僅在進階用例中使用。
​
stream
boolean
是否啟用串流輸出
  • true: 透過伺服器傳送事件 (SSE) 逐步回傳回應
  • false: 一次性回傳完整回應
預設值：false
​
stop_sequences
array
停止序列自訂文字序列，遇到時停止生成。最多 4 個序列，每個最長 32 個 token。
​
metadata
object
中繼資料用於追蹤或標識請求的物件。

​
Response

​
id
string
訊息的唯一識別碼
​
type
string
物件類型，固定為 message
​
role
string
角色類型，固定為 assistant
​
content
array
訊息內容陣列
​
model
string
實際使用的模型名稱
​
stop_reason
string
停止原因可能的值：
  • end_turn - 自然結束
  • max_tokens - 達到最大 token 限制
  • stop_sequence - 遇到停止序列
  • tool_use - 工具使用
​
stop_sequence
string
觸發停止的序列（如果有）
​
usage
object
token 使用統計

​
使用範例

​
單次對話

{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "解释一下量子计算"}
  ]
}

​
多輪對話

{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "你好"},
    {"role": "assistant", "content": "你好！我是Claude。"},
    {"role": "user", "content": "能解释一下AI吗？"}
  ]
}

​
使用系統提示詞

{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "system": "你是一位经验丰富的数据科学家，专长包括统计分析和机器学习。",
  "messages": [
    {"role": "user", "content": "如何选择合适的机器学习算法？"}
  ]
}

​
預填充回應

{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "列出5个Python最佳实践"},
    {"role": "assistant", "content": "以下是5个Python最佳实践：\n\n1."}
  ]
}