Claude Haiku 5.5

透過 POST https://api.seedrouter.ai/v1/messages 使用 claude-haiku-5-5。模型接受文字、圖片與文件，回傳文字或工具呼叫請求。模型頁列出目前的 token 費率。

以下契約依據 Anthropic 的模型專屬文件，查核日期為 2026 年 10 月 9 日。官方能力上限與端到端驗證須分開看待：欄位被接受，不能證明預期效果已生效。使用進階選項前，請先查看下方相容性結果。

快速開始

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Classify this request as billing, technical or account: I was charged twice. Return only the label."}]
  }'

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai",
)
message = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize the purpose of a database index."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

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

const client = new Anthropic({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: 'https://api.seedrouter.ai',
});
const message = await client.messages.create({
  model: 'claude-haiku-5-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Summarize the purpose of a database index.' }],
});
for (const block of message.content) {
  if (block.type === 'text') console.log(block.text);
}

API 金鑰請保存在伺服器端。依 type 選取回應區塊，回應可能先出現思考或工具呼叫。

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    body, err := json.Marshal(map[string]any{
        "model": "claude-haiku-5-5",
        "max_tokens": 1024,
        "messages": []map[string]string{
            {"role": "user", "content": "Summarize the purpose of a database index."},
        },
    })
    if err != nil { panic(err) }
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/messages", bytes.NewReader(body))
    if err != nil { panic(err) }
    req.Header.Set("x-api-key", os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("anthropic-version", "2023-06-01")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 2 * time.Minute}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    data, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    if res.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, data)) }
    fmt.Println(string(data))
}

請求參數

原生契約共有 25 個頂層欄位。選填不代表可為 null，只有明確提到 null 的項目才接受它。依文字模型參數政策，未知欄位與不支援的取樣欄位會在轉送前捨棄。支援欄位若取值無效，會在生成前回傳 invalid_request_error。

線上體驗為支援的欄位提供控制項，巢狀結構也有 JSON 控制項。表單省略取樣參數與固定的標準速度，模型 ID 固定為本頁模型。請使用 JSON 請求預覽檢視提交的本文。

思考與投入程度

預設使用 medium 投入程度的自適應思考，且省略思考文字。投入程度接受 low、medium、high、xhigh、max，或以 null 使用預設值。

{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}

關閉思考時，使用 {"type":"disabled"} 搭配 low、medium 或 high 投入程度。disabled 模式不可包含 display 或 block_binding。enabled、budget_tokens、between_tools，以及 xhigh/max 下的 disabled 思考均無效。

自適應 display 接受 omitted、summarized 或 null。通用 beta 值 updates 需要 thinking-display-updates-2026-08-18；Anthropic 目前未確認 Haiku 提供可讀的進度更新，因此請勿依賴此輸出。

選填的 thinking.block_binding 需要 thinking-binding-controls-2026-08-01。它可為 null 或物件，物件的 prefix_mismatch_behavior 為 error、drop_block 或 null。重播歷史時，先前的對話輪次與完整思考區塊應保持原樣。思考簽章綁定於產生它的帳戶或與之連結的帳戶。

output_config.task_budget 為 null 或 { "type": "tokens", "total": 20000 }，選填的 remaining 為整數或 null。需要 task-budgets-2026-03-13，且 total 至少為 20000。此處不另外限制 remaining 範圍。

工具與結構化輸出

用戶端工具名稱須由 1–128 個字母、數字、底線或連字號組成，input_schema 必須包含 type: "object"。使用 tool_choice: {"type":"any"} 或 {"type":"tool","name":"lookup"} 強制呼叫已宣告的工具。自適應思考下，強制工具回應直接從工具呼叫開始，不含思考區塊。

disable_parallel_tool_use 是 auto、any 與 tool 選擇的選填布林欄位，不屬於 none。回傳工具結果時使用原本的 tool_use_id。線上體驗會顯示呼叫，但不會執行你的用戶端工具。

{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}

結構化回應使用 output_config.format: {"type":"json_schema","schema":{...}}。請遵循 Anthropic 支援的 JSON Schema 子集，包括物件上的 additionalProperties: false。結構有效不保證值符合事實。嚴格工具與結構化輸出有整份 schema 的限制，請參閱官方結構化輸出參考。

電腦使用需要 computer_toolset_20260801，舊版電腦工具無效。瀏覽器使用有自己的 browser_toolset_20260801。宣告工具不能驗證完整伺服器端工具工作階段可運作。使用前請閱讀工具的官方指南與 beta 要求。

對話與上下文管理

不支援一般 assistant 預填。暫停的伺服器端工具接續屬於不同情況：請依 Messages 協定重新傳送完整的 assistant 區塊。

含內容的 system 訊息可出現在 user 訊息或暫停的伺服器端工具結果之後，其後必須是 assistant 訊息，或該 system 訊息本身是最後一則。連續 system 訊息視為同一組評估。不可在用戶端工具呼叫與必要的結果之間插入 system 訊息。

空內容的 system 訊息只能透過 mid-conversation-output-config-2026-07-01 變更 output_config.effort，可出現在任何位置。關閉思考時，它無法變更實際生效的投入程度。system 的 clear_at 搭配 mid-conversation-system-clear-at-2026-08-21 時接受 never、next_user_message 或 null；僅適用當前輪次的訊息只允許文字，不含輸出設定或區塊快取。

上下文編輯項目包括：

隨選 compaction 需要 compact-2026-09-04，不可與 context_management、stop_sequences、輸出格式、強制工具或 task_budget.remaining 合併。具簽章的壓縮區塊也不可搭配 task_budget.remaining 或閾值壓縮。繼續對話時須保留回傳的區塊與簽章。

圖片、PDF 與請求大小

圖片接受以 URL、base64 或檔案參照提供 JPEG、PNG、GIF 與 WebP。PDF 接受 URL、base64 或檔案參照。檔案參照需要相關 Files API beta 與有效檔案存取權限。文字文件可使用 text 或 content 來源。

原生請求上限為 32 MB。官方圖片上限為 600 張，每張 base64 編碼資料最多 10 MB，任一邊最多 8000 像素；含大量圖片的請求可能有更嚴格的平台專屬限制。PDF 必須未加密，以此模型的上下文大小最多 600 頁。API 仍須檢查遠端檔案，本機結構檢查無法證明 URL 的內容。

線上體驗會先上傳附件再提交 URL。對話 JSON 也支援原生媒體內容區塊。完整媒體大小與上下文視窗邊界測試，不等同於小型範例請求。

提示快取與計費

Haiku 可快取提示詞的最低長度為 512 token。較短的提示詞即使標示快取，也可能正常執行而未建立快取項目。最多使用 4 個快取中斷點，自動頂層快取控制會占一個位置。有效期較長的快取前綴應放在較短的前綴之前。

max_tokens: 0 請求只預熱快取，不產生回答。不可搭配 stream: true、結構化輸出或強制工具使用。準備快取與重複使用快取的請求之間，思考和投入程度設定須一致。

讀取 usage.input_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens，以及 cache_creation 下的 5m/1h 明細。思考包含在輸出 token 中，回報的思考 token 明細不是須再次加計的額外費用。目前費率見價格區塊，詳細說明見價格指南。

回應、串流與錯誤

完整回應包含 id、type: "message"、role: "assistant"、model、content、stop_reason、stop_sequence 與 usage。回傳時保留選用的 container、diagnostics、context_management、stop_details 與 input_transformations。

請處理 end_turn、max_tokens、stop_sequence、tool_use、pause_turn、compaction、refusal 與 model_context_window_exceeded。達到上限而停止或拒絕回答，與 HTTP 錯誤不同。不可假定第一個內容區塊一定是文字。

串流使用 Messages SSE 事件：message_start、content_block_start、content_block_delta、content_block_stop、message_delta 與 message_stop。也須處理 ping 與 error 事件，保留後續輪次所需的思考簽章與工具區塊。

錯誤使用 Anthropic 格式：

{"type":"error","error":{"type":"invalid_request_error","message":"max_tokens must be an integer from 0 to 128000."}}

回傳錯誤的請求不收費。共用錯誤型別請參閱錯誤處理。

OpenAI 相容格式

同一 ID 可用於 /v1/chat/completions 與 /v1/responses。請使用各自的原生欄位：Chat 使用 messages，Responses 使用 input。原生 Claude 選項屬於 Messages，不應整套複製到 OpenAI 格式的本文。

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'

curl https://api.seedrouter.ai/v1/responses \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_output_tokens":256,"input":"Reply with OK."}'

相容性結果

2026 年 10 月 9 日於開發環境查核。這些檢查確認的是特定請求的實際行為，不代表所有官方上限或正式環境部署均已驗證。

1 小時快取寫入與壓縮計費尚未通過發行驗證。最大上下文與輸出執行、另行計費的託管工具、Files API 存取及備援額度兌換均未測試。請維持官方請求結構，不要只憑成功狀態推斷支援情況。

參考資料

• Haiku 5.5 模型概覽
• Haiku 5.5 遷移指南
• Messages 參考
• Beta Messages 參考
• 思考、投入程度、任務預算
• 隨選壓縮、上下文編輯
• 提示快取、視覺、PDF 支援