Anthropic: Claude Haiku 5.5 (batch)
Claude Haiku 5.5 是 Anthropic 用於分類、擷取、摘要、路由與聚焦代理任務的小模型。它結合文字及圖片理解與自適應推理,針對需要迅速回應的重複工作設計。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。
Claude Haiku 5.5 是 Anthropic 用於大量、對延遲敏感任務的小模型版本。主要用途包括分類、路由、資訊擷取、摘要、對話壓縮與聚焦的子代理工作。它接收文字與圖片,產生文字。實用簡報給它範圍明確的問題與明確結果:分類、一組指定欄位、短摘要,或大型任務另一部分需要的相關證據。請將來源識別碼與結果保留在一起,讓應用程式能把擷取資訊連回原始資料。
Anthropic 將此版本定位於即時客服、瀏覽器操作與短程式設計子任務,以及重複分析。它可在流程中搭配 Claude Sonnet 5.5 或 Claude Opus 5.5,由較大模型處理大型專案,Haiku 負責範圍明確的查詢或摘要。客服任務應提供問題與允許的參考資料,再指定回應語氣及必要回傳內容。程式設計子任務則指出相關檔案或摘錄及確切問題,不要指派沒有完成條件的開放式專案。
文件記載的上下文視窗是一百萬詞元,一般生成最多輸出 128,000 詞元。思考詞元計入生成額度,因此結果須為推理與可見文字都留空間。可靠知識截止為 2026 年 6 月;後續資訊需要提供證據或搜尋工具。Anthropic 另外記載此版本僅限批次的 beta,可把輸出提高到 300,000 詞元。較大額度需要開發者的延伸輸出功能,與一般上限不同。非同步批次會獨立處理各請求,適合處理後才需要結果,而非立即需要的文件或紀錄集合。
自適應思考預設啟用,effort 是推理深度的主要控制。層級為 low、medium、high、xhigh 與 max,預設為 medium。Anthropic 建議多數工作用 medium,較持續的任務或嚴格指令遵循用 high,較簡單、較短請求用 low。在 low、medium 或 high 可停用思考;在 xhigh 或 max 停用會被拒絕。提示詞要求直接答案,不能取代該控制。Haiku 4.5 的手動 budget_tokens 設定不能直接用於此版本,文件介面中應省略 temperature、top_p 與 top_k。
Haiku 5.5 使用較早 Claude 世代引入的新 tokenizer。Anthropic 估計,相同文字可能比 Haiku 4.5 多使用約 30% 詞元,視內容而定。它也保留先前助理輪次的思考區塊,因此對話大小增加不只來自 tokenizer 變更。最短可快取提示詞為 512 詞元。保留推理時,讓先前輪次不變,將新指令放在最新輪次。修改頂層 effort 會使對話訊息快取失效;開發者另外記載在自適應對話中修改 effort 的 beta。這些能力都不能確立某個特定請求實際命中快取。
檢索方面,模型提示指南建議在搜尋工具旁提供當前日期,並維持原始系統與工具定義穩定。對話在後一天繼續時,於最新輪次給新日期。說明必須找到什麼,要求結論之前先保留回傳來源。例如,任務示例可詢問指定軟體版本的文件記載行為,再要求依檢索段落提出短說明。應用程式提供搜尋工具並回傳實際結果;模型查詢提案不是查詢已發生的證據。
結構化 JSON 輸出結合工具時,指南記載特定互動:停用思考時,Haiku 可能略過必要工具呼叫。Anthropic 建議這類請求採自適應思考,或把最終 JSON 要求與工具步驟分開。定義輸出欄位,明確說明最終答案須在工具結果之後。資料擷取簡報可指定必要欄位與缺值表示方式;查詢簡報則可先要求填入欄位所需證據。應依型別讀取回應區塊,因為答案不一定是第一個區塊,思考文字也預設省略。
較長代理提示中,Anthropic 指出 low 投入可能提早停止、略過搜尋或漏做檢查。指南建議明確完成指令,並在報告程式碼修改完成前進行實際檢查。請準備預期結果與證明它的證據:報告選定段落、程式碼提案的行為變化,或從文件擷取的欄位。指南也區分使用者在任務中途發出的訊息與工具輸出:新使用者指令屬於使用者輪次,回傳工具證據仍須分開。
此版本具有自己的防護,可對網路危害、生物危害、競爭模型開發或其他禁止用途等類別拒絕回應。開發者未記載 Haiku 5.5 的伺服器端回退機制。指南也指出,xhigh 投入偶爾會在沒有可見答案文字的情況下結束多輪回應;low 投入或停用思考時,則較常出現類似推理的文字。流程需要可見、結構化結果時,應考量這些特定行為。一般擷取或摘要工作,請使用聚焦來源、明確輸出,以及符合任務的投入層級。
Ailoot Ultra · 批次處理(Batch) POST /v1/batches anthropic/claude-haiku-5.5:batch
anthropic/claude-haiku-5.5:batch
anthropic/claude-haiku-5.5:batch入門
Claude Haiku 5.5 是 Anthropic 用於分類、擷取、摘要、路由與聚焦代理任務的小模型。它結合文字及圖片理解與自適應推理,針對需要迅速回應的重複工作設計。
- 接受的輸入
- 文字
- 結果
- 文字
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 批次處理(Batch) POST /v1/batches
- 輸入
text- 輸出
text- 輸出格式
- 內嵌的 results[].response.body JSON
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位endpoint | 類型string | 要求必填 | 值與限制 /v1/chat/completions | 預設值— |
欄位model | 類型string | 要求必填 | 值與限制 anthropic/claude-haiku-5.5:batch | 預設值— |
欄位requests | 類型batch_item[] | 要求必填 | 值與限制 項目數下限: 1 | 預設值— |
欄位requests[].custom_id | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位requests[].body.messages | 類型message[] | 要求必填 | 值與限制 | 預設值— |
欄位completion_window | 類型string | 要求選填 | 值與限制 24h | 預設值— |
欄位provider | 類型object|null | 要求選填 | 值與限制 | 預設值— |
欄位requests[].body.model | 類型string | 要求選填 | 值與限制 anthropic/claude-haiku-5.5:batch, anthropic/claude-haiku-5.5 | 預設值— |
欄位provider.only | 類型string[] | 要求選填 | 值與限制 anthropic | 預設值— |
欄位provider.allow_fallbacks | 類型boolean|null | 要求選填 | 值與限制 false, null | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格endpoint, model, requests |
參數material_types | 規格text |
參數representation | 規格內嵌的 requests[];每個項目皆含 custom_id 與 body |
參數request_endpoint_profile | 規格/v1/chat/completions |
參數file_material | 規格呼叫端可在本機將實際的 UTF-8 JSONL 讀入 requests[]。此流程不使用上傳用途、input_file_id 或檔案參照。若缺少客戶素材或素材為空,應在 POST 前停止準備。 |
參數serialization_order | 規格endpoint, model, provider(如有提供), completion_window(如有提供), requests 放在最後 |
參數optional_controls | 規格provider.only, provider.allow_fallbacks, completion_window |
參數schema_scope | 規格依文件規定的內嵌 Batch 封裝格式提供文字 Chat Completions 請求主體。 |
生命週期: asynchronous
GET /v1/batches/{operation_id} · 原始建立回應中實際回傳的 response.id;使用相同使用者/金鑰/群組
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
- 顯式快取計價
- 已啟用 請求顯式快取時
Ailoot 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 上下文 Token 數大於 | 上下文 Token 數小於或等於 | 費用 |
|---|---|---|---|---|
| 設定詞元基本費率 | 費率表基本費率 | 上下文 Token 數大於— | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token $0.0001 / 1K Token 輸出 · 輸出 Token $0.0005 / 1K Token 輸入 · 讀取快取 $0.00001 / 1K Token 輸入 · 寫入快取 $0.000125 / 1K Token 輸入 · 寫入快取,1 小時 $0.0002 / 1K Token |
| 設定請求長度級距 1 | 費率表— | 上下文 Token 數大於0 | 上下文 Token 數小於或等於100,000 | 費用 輸入 · 輸入 Token $0.0001 / 1K Token 輸出 · 輸出 Token $0.0005 / 1K Token 輸入 · 讀取快取 $0.00001 / 1K Token 輸入 · 寫入快取 $0.000125 / 1K Token 輸入 · 寫入快取,1 小時 $0.0002 / 1K Token |
| 設定請求長度級距 2 | 費率表— | 上下文 Token 數大於100,000 | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token $0.0005 / 1K Token 輸出 · 輸出 Token $0.0025 / 1K Token 輸入 · 讀取快取 $0.00005 / 1K Token 輸入 · 寫入快取 $0.000625 / 1K Token 輸入 · 寫入快取,1 小時 $0.001 / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · 批次處理(Batch)
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"anthropic/claude-haiku-5.5:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen
def prepare_requests(customer_path):
path = Path(customer_path)
if not path.is_file(): raise ValueError("Customer JSONL file is missing")
items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
if not items: raise ValueError("Customer JSONL contains no requests")
ids = set()
for item in items:
if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
cid = item["custom_id"]
if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
ids.add(cid)
if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
supplied_model = item["body"].get("model")
if supplied_model is not None and supplied_model not in ['anthropic/claude-haiku-5.5:batch', 'anthropic/claude-haiku-5.5']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"anthropic/claude-haiku-5.5:batch", "requests":items}
if __name__ == "__main__":
material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
body = prepare_requests(material)
key = os.environ.get("AILOOT_API_KEY", "")
if not key: raise SystemExit("Set AILOOT_API_KEY")
request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
with urlopen(request) as response:
raw = response.read()
Path("batch-create-response.json").write_bytes(raw)
print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.
接收並儲存結果
Ailoot Ultra · 批次處理(Batch)
內嵌的 results[].response.body JSON
GET /v1/batches/{operation_id}
查看工作狀態
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
保留完整的原始狀態 JSON、每個結果/custom_id,以及完整的回應或錯誤主體。將已完成的 results[] 儲存為 JSONL,不得篩除任何項目。
需要檢查原始回應時
保留原始作業 ID。503 result_pending_check 回應帶有 X-Should-Retry:false;請勿重新提交狀態不明的原始批次。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位results[].custom_id | 類型string |
欄位results[].response.body.choices[].message.content | 類型string|null |
欄位results[].error | 類型object|null |
欄位usage | 類型object|null |
欄位id | 類型string |
欄位model | 類型string |
欄位endpoint | 類型string |
欄位status | 類型string |
欄位request_counts | 類型object |
欄位results[].id | 類型string |
欄位results[].response.status_code | 類型integer |
欄位results[].response.request_id | 類型string |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件文件規定的內嵌封裝格式無效、索引鍵重複、項目識別有誤,或與已設定的模型能力衝突。 | 下一步再次提交前,請先修正指出的欄位。 |
回應401 · authentication_error | 條件API 金鑰無效。 | 下一步使用已獲授權的 Ailoot 金鑰。 |
回應403 · permission_error | 條件批次處理群組無法使用。 | 下一步檢查金鑰/群組的使用權限。 |
回應422 · invalid_request_error | 條件批次處理採用餘額計費;透過訂閱建立批次的請求會遭拒絕。 | 下一步使用已獲授權、以餘額計費的群組。 |
回應422 · price_unavailable | 條件無法為批次輸入估價。 | 下一步保留回應;使用文件規定的該 API 家族輸入格式。 |
回應402 · billing_error | 條件批次處理的預留額度無法取得。 | 下一步提交新請求前,請先解決請求受理問題。 |
回應503 · price_unavailable | 條件批次處理方法的價格/原生費率無法取得。 | 下一步保留回應;請勿替換價格。 |
回應503 · api_error | 條件指定的供應商路由無法使用。 | 下一步保留回應,以供修復路由。 |
回應503 · result_pending_check | 條件原始結果需要檢查;X-Should-Retry:false。 | 下一步保留原始 operation_id/id 並讀取其狀態;請勿重複原始 POST。 |
回應404 · not_found | 條件查詢批次狀態所需的作業不存在,或屬於其他身分。 | 下一步使用完全相同的原始 id,以及相同的使用者/金鑰/群組。 |
別名
模型別名
Ailoot Ultra anthropic/claude-haiku-5.5:batch
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Anthropic: Claude Haiku 5.5 (batch)
- 可以使用哪些輸入與結果?
POST /v1/batches·anthropic/claude-haiku-5.5:batch:text→text- 請求使用哪些欄位?
POST /v1/batches·anthropic/claude-haiku-5.5:batch:endpoint,model,requests,completion_window,provider- 適用哪些限制?
POST /v1/batches·anthropic/claude-haiku-5.5:batch:requests.min_items:1