Anthropic Messages

POST /v1/messages

Anthropic 原生格式的訊息端點，適用 Claude 系列模型。也可以透過 OpenAI 格式的聊天補全端點呼叫 Claude 模型。

请求REQUEST

POSThttps://test.kailin.com.cn/v1/messages

API Key仅存本地浏览器，不会上传

请求体 JSONSSE 流式 · 逐段渲染{ "model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [ { "role": "user", "content": "Hello, introduce yourself" } ], "stream": true }

响应RESPONSE

填写参数并发送请求，响应会显示在这里

請求

curl https://test.kailin.com.cn/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-token" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, introduce yourself" }
    ]
  }'

備註

x-api-key: sk-xxx 與 Authorization: Bearer sk-xxx 兩種請求標頭都可用。anthropic-version 標頭可傳可不傳。

請求主體參數

參數	類型	必填	說明
model	string	是	Claude 模型名稱
max_tokens	number	是	最大生成 token 數（Anthropic 格式必填）
messages	array	是	訊息陣列；role 只有 user / assistant
system	string / array	否	系統提示詞，獨立於 messages 傳入
stream	boolean	否	串流輸出（SSE，事件類型見下方）
temperature	number	否	0–1，預設 1
top_p / top_k	number	否	取樣參數
stop_sequences	array	否	停止序列
tools	array	否	工具定義（name / description / input_schema）
tool_choice	object	否	{"type": "auto"} / {"type": "any"} / {"type": "tool", "name": "..."}

含系統提示詞與圖片的範例：

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a rigorous technical writer.",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "<base64>" } },
        { "type": "text", "text": "Describe this architecture diagram" }
      ]
    }
  ]
}

回應（非串流）

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "Hello! I'm Claude…" }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "output_tokens": 45
  }
}

欄位	說明
content[]	內容塊陣列——type 可為 text / tool_use / thinking
stop_reason	end_turn / max_tokens / stop_sequence / tool_use
usage.input_tokens / output_tokens	token 用量

串流事件

設定 "stream": true 時，回應是帶有不同 event: 類型的 SSE：

event: message_start
data: {"type":"message_start","message":{...}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Hello"}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":45}}

event: message_stop
data: {"type":"message_stop"}

事件	說明
message_start	訊息開始，含初始 usage
content_block_start / _delta / _stop	內容塊的開始 / 增量 / 結束——增量在 delta.text
message_delta	頂層狀態更新（stop_reason、最終 usage）
message_stop	訊息結束
ping	保活心跳
error	串流中的錯誤

使用 Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-token",
    base_url="https://test.kailin.com.cn",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'sk-your-token',
  baseURL: 'https://test.kailin.com.cn',
});

const message = await client.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello' }],
});
console.log(message.content[0].text);

提示

SDK 的 base_url 填根位址（不含 /v1），SDK 會自動補上 /v1/messages。