Claude Messages API — TokSpan 文件

端點

http
POST https://api.tokspan.com/v1/messages

快速範例

使用 Anthropic SDK，並以 TokSpan 作為 base URL — 除了設定外無需任何程式碼變更：

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-key",
    base_url="https://api.tokspan.com",  # ← host root; the SDK appends /v1/messages
)

response = client.messages.create(
    model="MODEL_NAME",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.content[0].text)

shell
curl -X POST "https://api.tokspan.com/v1/messages" \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

json — Response
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [{
    "type": "text",
    "text": "Hello! How can I help you today?"
  }],
  "model": "MODEL_NAME",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12
  }
}

請求主體

參數	類型	必要	說明
model	string	是	Claude 模型 ID（例如 `claude-opus-4-8`、`claude-sonnet-4-6`）。
max_tokens	integer	是	要生成的最大 Token 數。Messages API 的<strong>必要</strong>欄位。
messages	array	是	訊息陣列，依序在 <code>user</code> 與 <code>assistant</code> 角色之間交替。第一則訊息必須來自使用者。
system	string	否	系統提示 — 字串或內容區塊的陣列。
temperature	number	否	取樣溫度（0–1）。
stream	boolean	否	啟用 SSE 串流。預設值：<code>false</code>。
top_p	number	否	核取樣（0–1）。
tools	array	否	用於工具使用的工具定義。請參閱工具呼叫。
tool_choice	object	否	控制工具選擇：`{"type": "auto"}` 或指定工具。
thinking	object	否	擴展思考設定：`{"type": "enabled", "budget_tokens": 1024}`。預算必須 ≥1024 且小於 `max_tokens`。

系統提示

將系統提示以頂層的 <code>system</code> 欄位傳入（而非訊息）：

json
{
  "model": "MODEL_NAME",
  "max_tokens": 1024,
  "system": "You are a helpful assistant that always answers in French.",
  "messages": [{"role": "user", "content": "What is the capital of France?"}]
}

串流（SSE）

設定 stream: true 即可接收 Anthropic SSE 事件（message_start、content_block_delta、message_stop 等）。

shell
curl -X POST "https://api.tokspan.com/v1/messages" \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Tell me a story."}],
    "stream": true
  }'

設定：將 Anthropic SDK 的 base_url 設為 https://api.tokspan.com——SDK 會自行追加 /v1/messages。驗證同時接受 x-api-key + anthropic-version 標頭（Anthropic 原生）與 Authorization: Bearer。Anthropic SDK 會自動處理。