API教學

Claude Fable 5.2 API 快速入門

一根琥珀色細桿連著兩個石墨色連接件

把 Fable 5.2 接入審查流程時,先發一個結果容易核對的小請求。本文依據 Anthropic 的 API 參考和模型說明整理步驟,使用官方端點與虛構簡報;示例並非一次已完成的付費 API 實測。

快速步驟

在程式碼之外配置 Claude API 憑證,使用 claude-fable-5-2 呼叫 Messages API,再檢查文字塊、stop_reason 和 usage。最小請求透過核驗後,再逐項新增圖片或工具。

1. 準備許可權和小規模輸入

使用 Claude Platform API 金鑰,在本地 shell 透過 ANTHROPIC_API_KEY 環境變數提供。驗證整合時只用虛構簡報。金鑰應儲存在憑證儲存中,不得寫入請求日誌。

2. 傳送第一條訊息

將示例複製到已配置金鑰的 shell。請求只詢問缺少的三個輸入條件。響應可能包含多種內容區塊,提取文字時應檢查區塊型別,不要假定所有區塊都是文字。

最少的第一方請求
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_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":"一家虛構的麵包店需要製作上新宣傳圖。請列出撰寫設計簡報前要確認的三項資訊。"}]}'

3. 檢查實際響應

閱讀文字區塊,並檢視 stop_reason。達到最大 token 數而結束時,需要收緊請求或調整預算。記錄請求 ID、模型 ID 和 token 用量,再結合官方 API 單價對賬。

4. 一次只新增一項能力

文字請求成功後,按視覺文件的格式新增一張圖片,用已知標籤檢驗回答,再考慮工具。Fable 5.2 採用自適應思考,文件列有不支援的強制工具選擇和部分取樣設定;最初請求先不要加入這些選項。

5. 保留可讀的交接說明

設計流程的輸出應為包含來源 ID、必需文案和未知項的短簡報。先由人核對,再複製到 Ciyo 製作視覺。保留核准結果和來源圖片 ID,便於日後重建決策。

先診斷一個小請求,再連線自動化流程

認證失敗應檢查憑證和所屬組織;請求結構報錯則要讀返回的錯誤資訊與模型說明。兩類問題分開處理。記錄狀態、請求 ID 和去除敏感資訊後的錯誤內容,不要把金鑰複製到支援記錄中。

達到 token 上限而停止時,要看回答是否包含要求的三個事項。HTTP 請求成功不等於簡報完整。縮小輸出範圍或調整上限,再核對下一次結果,最後才加入其他工具。

常見問題

Bedrock 的模型 ID 與官方 API 一樣嗎?

官方 API 使用 claude-fable-5-2;Bedrock 有單獨的模型標識。應按實際平臺的路由和部署說明配置。

認證錯誤應如何排查?

確認環境中存在預期金鑰,並屬於目標組織。截圖和共享日誌中不得出現憑證。

根據核准簡報繼續製作

資料與視覺任務準備好後,再將明確需求交給 Ciyo 設計助手。