Claude Fable 5.2 API
Claude Fable 5.2 API:自適應思考、預設 high effort、原生參數、Beta 要求,以及各分組即時 Token 價格。
本文件介紹 Claude Fable 5.2 及其專屬的 Messages 參數。請在 POST https://api.wanapi.app/v1/messages 中使用 claude-fable-5-2。比較 Claude 模型。
模型設定
| 設定 | Claude Fable 5.2 |
|---|---|
| 模型 ID | claude-fable-5-2 |
| 上下文視窗 | 1M Token |
| 同步輸出上限 | 128000 Token,包含思考用量 |
| 思考模式 | 自適應,始終啟用 |
| 預設 effort | high |
強制工具呼叫(any / tool) | 不支援 |
連線並傳送請求
在 API 金鑰設定建立金鑰。一把 API 金鑰即可存取所有模型與分組。請將它保存在伺服器環境的 WAN_API_KEY 中。傳送 anthropic-version: 2023-06-01;只有功能需要時才加入 anthropic-beta。
curl https://api.wanapi.app/v1/messages \
-H "x-api-key: $WAN_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-fable-5-2",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
}'import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["WAN_API_KEY"],
base_url="https://api.wanapi.app",
)
message = client.messages.create(
model="claude-fable-5-2",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))目前 API 支援範圍
下表說明此模型的原生介面規格。Wan API 目前透過相容層轉送請求。請將 max_tokens 設為正整數:網關目前會將 0 替換為生成額度,因此此處無法用它僅預熱快取而不生成內容。
目前網關不會轉送 diagnostics、compaction、fallbacks、fallback_credit_token 或 thread。目前的通道設定也會過濾 speed、service_tier 與 inference_geo。下方仍記載這些欄位,以說明模型的原生規格,但目前尚無法透過此連線使用。回應成功不代表被忽略的欄位已生效。需要這些欄位的 Beta 功能也有相同限制。
參數
| 欄位 | 型別/預設值 | 限制 |
|---|---|---|
model | 必填字串 | claude-fable-5-2。請使用完整 ID;分組由系統自動處理。 |
max_tokens | 必填整數 | 0–128000,包含思考用量。零不可與 stream true、結構化輸出或強制工具同時使用。 |
messages | 必填陣列 | 1–100000 個符合官方規格的輪次;只有在 pause_turn 後接續 thread 時才可為空。 |
system | 字串或文字區塊陣列 | 接續 thread 時必須完全省略。 |
thinking | 物件,預設為 adaptive | 僅支援 adaptive。display:omitted(預設)、summarized、updates 或 null。 |
output_config | 物件 | effort:low、medium、high(預設)、xhigh、max 或 null。選填 format 與 task_budget。 |
output_format | 物件或 null | 已棄用的結構化輸出別名;請優先使用 output_config.format。 |
stop_sequences | 字串陣列 | 不可為 null;不能與隨需壓縮同時使用。 |
stream | 布林值,false | true 時使用 SSE;不可為 null。 |
tools | 陣列 | 官方用戶端工具與伺服器工具/工具組。用戶端工具由您的應用程式執行。 |
tool_choice | 物件 | auto 或 none;強制工具呼叫會被拒絕。 |
metadata | 物件 | user_id 為字串或 null,最多 512 個字元。 |
cache_control | 物件或 null | type 為 ephemeral,ttl 為 5m 或 1h。 |
container | 字串、物件或 null | 選填 id,以及最多 20 個 skills。 |
context_management | 物件或 null | 官方上下文編輯設定;需要對應的 Beta。 |
mcp_servers | 陣列 | 最多 20 個 HTTPS 伺服器;需要對應的 MCP Beta。 |
diagnostics | 物件或 null | previous_message_id 為字串或 null,最多 256 個字元。 |
service_tier | auto 或 standard_only | 選填;不可為 null。 |
inference_geo | 字串或 null | global 或 us,取決於帳號可用範圍。 |
speed | 字串或 null | standard、fast 或 null;fast 不需要 Beta。 |
compaction | 物件或 null | type 為 summarize,選填 instructions,最多 16384 個 Unicode 字元。 |
fallbacks | default、陣列或 null | 最多三個不同目標;需要官方 server-side-fallback Beta。 |
fallback_credit_token | 字串、物件或 null | 權杖最多 2048 個字元;需要官方 credit Beta;不能與 fallbacks 同時使用。 |
thread | 物件或 null | create,或使用 previous_message_id 的 continue;需要 message-threads-2026-08-12。 |
思考與工具
Claude Fable 5.2 預設採自適應思考與 high effort。不支援 enabled、disabled、between_tools 思考模式或 budget_tokens。thinking.display: updates 需要 thinking-display-updates-2026-08-18。搭配 thinking-binding-controls-2026-08-01 時,thinking.block_binding 的 prefix_mismatch_behavior 可為 error、drop_block 或 null。
output_config.task_budget 需要 task-budgets-2026-03-13,type 為 tokens,整數 total 至少為 20000,並可選填非負整數 remaining。使用壓縮或重播含簽章的壓縮區塊時,請省略 remaining。隨需壓縮需要 compact-2026-09-04,且不可與 context_management、stop_sequences、結構化輸出或強制工具同時使用。門檻式壓縮使用 compact-2026-01-12,input_tokens 觸發值至少為 50000。
系統訊息的逐則 effort 設定需要 mid-conversation-output-config-2026-07-01。不接受最後一則 assistant 預填;官方的 pause_turn 與壓縮接續方式仍然有效。
電腦操作請使用 computer_toolset_20260801。Advisor 工具需要 advisor-tool-2026-03-01 與支援的目標。工具執行與權限由您的應用程式控制。
接續 thread 時只傳送新訊息,且必須省略 system 與 tools。不可與壓縮或上下文編輯同時使用,保留所有思考內容的設定除外。五分鐘內沒有請求,狀態就會到期;請在本機保存對話。接續時會檢查與狀態相關的限制。
Fable 5.2 的備援目標為 Claude Opus 4.8 與 Claude Opus 5。進階 Beta 功能的執行與快速模式計費仍需實際驗證;請求結構描述不代表已實測保證的能力。
媒體輸入
圖片與 PDF 請使用可公開存取的 HTTP(S) URL,放在使用者訊息的 content 區塊中。檔案須由您自行託管;此整合不提供 Files API 或上傳功能。圖片輸入範例:
{"role":"user","content":[
{"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
{"type":"text","text":"What does this chart show?"}
]}PDF 請使用 document 區塊。繼續對話時,請保持工具呼叫 ID、完整思考區塊與簽章不變。用戶端工具由您的應用程式執行並傳回結果;宣告工具不會執行工具。
價格
每 100 萬 Token 的美元價格
目前費率已包含各分組的倍率。價格快取最長保留 2 分鐘。
一把 API 金鑰即可存取所有模型與分組。「預設」標示自動路由順序中第一個符合條件的分組;請求依實際選用分組的費率計費。
Claude Fable 5.2
claude-fable-5-2
| 計費 Token | claude · 預設 |
|---|---|
| 所有輸入長度 | |
| 輸入(未快取) | US$4 |
| 輸出 | US$20 |
| 快取讀取 | US$0.1 |
| 快取寫入 · 5 分鐘 | US$5 |
| 快取寫入 · 1 小時 | US$8 |
— 表示目前沒有經確認的報價,不代表免費。
只有回應中回報相應快取用量時,才適用快取費率。請勿將快取 Token 再次計入未快取輸入。
將各項計費 Token 數量乘以對應費率後加總,再除以 1,000,000。思考 Token 已包含在輸出 Token 中,不會重複計費。快取讀取、5 分鐘寫入與 1 小時寫入分別採用不同費率。按長度計價時,請先選擇適用區間,再計算請求費用。
回應與串流
已完成的訊息包含 id、type、role、model、content、stop_reason 與 usage。請從 content 讀取文字區塊;第一個區塊也可能是思考內容或工具呼叫。以下僅為示例:
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-fable-5-2",
"content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 24, "output_tokens": 18}
}設為 stream: true 可使用 SSE,並搭配 curl -N。請處理 message_start、content_block_start、content_block_delta、content_block_stop、message_delta 與 message_stop,以及 ping 和串流錯誤。請讀取最終用量,不要將每個區塊視為完整回應。
OpenAI 相容格式
同一模型 ID 也適用於 POST /v1/chat/completions 與 POST /v1/responses。請使用 Authorization: Bearer YOUR_API_KEY,並將 OpenAI SDK 基底 URL 設為 https://api.wanapi.app/v1。Chat Completions 使用 messages;Responses 使用 input。這些欄位會轉換為 Messages 格式,因此使用上述原生參數時,請選用 /v1/messages。
curl https://api.wanapi.app/v1/chat/completions \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-fable-5-2","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'用量記錄與錯誤
LLM 記錄顯示最近 7 天已完成的呼叫,包含模型、輸入 Token、輸出 Token 與費用。呼叫完成後請重新整理,並依 claude-fable-5-2 篩選。圖片與影片請查看任務記錄。
請求失敗時,請檢查 HTTP 狀態與 error 物件。核對金鑰、餘額、模型 ID 與支援的參數組合。拒絕回應或因達到輸出上限而停止,與 HTTP 錯誤不同。若請求或串流中斷,請先查看記錄再重試:新請求可能產生另一筆費用。