選擇 TokenLab 交付層級：Auto、Verified 或 Official

即使模型 ID 完全有效，請求仍可能因 503 錯誤而失敗，原因通常與您指定的交付層級有關。在我們的管線中，當我們強迫某個模型使用它不提供的選項時，就遇到了這個問題。本指南說明了三種交付層級選項、設定生效的順序，以及每一項對您的帳單意味著什麼。以下所有事實均來自 TokenLab 文件與即時模型 API，觀察日期為 2026-10-03。

重點摘要

• 交付層級有三個值：auto、verified 和 official。
• 請求標頭 (Header) 會覆蓋 API 金鑰設定，而 API 金鑰設定會覆蓋工作區 (Workspace) 預設值。
• 如果請求的選項沒有供應，您會收到 503 delivery_tier_unavailable。當 retryable 為 false 時，請勿重新發送相同的請求。
• 您只需為完成請求的選項付費一次。
• 在指定層級之前，請先檢查 GET /v1/models/{model}。它是公開的，不需要金鑰。

三種交付層級選項

API 參考文件（觀察日期 2026-10-03）定義了三個選項：

• Auto：在可用時使用 TokenLab Verified，必要時使用 Official。您需為完成請求的選項付費。
• TokenLab Verified：由 TokenLab 驗證交付。適用 TokenLab 價格。
• Official：基於模型製造商的公開價格。您支付的是 TokenLab 上顯示的價格。

生成請求接受標頭 X-TokenLab-Delivery-Policy: auto | verified | official。無效的標頭值會回傳 400。

設定生效的優先順序

有三個地方可以設定交付層級。記錄的順序為：

1. 請求標頭。
2. API 金鑰設定。
3. 工作區預設值。

標頭會覆蓋金鑰，金鑰會覆蓋工作區。即時 (Realtime) 工作階段是個例外：它們使用 API 金鑰或工作區設定，不接受查詢字串 (query-string) 覆蓋。

在請求中設定交付層級

以下是一個指定 Official 交付的 Chat Completions 呼叫。模型 ID claude-sonnet-5 在即時模型 API 中列出，且兩個選項皆可用。請參閱模型頁面。

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-TokenLab-Delivery-Policy: official" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

相同的標頭也適用於 Anthropic Messages 端點。對於 /v1/messages，金鑰標頭可以是 x-api-key，API 參考文件指出 Anthropic Messages 接受此標頭。

curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: $TOKENLAB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -H "X-TokenLab-Delivery-Policy: verified" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

在 API 金鑰上設定交付層級

若要將交付層級設為某個金鑰的預設值，請使用帶有管理權杖 (management token, mt-...) 的 Management API。建立 API 金鑰與更新 API 金鑰頁面（皆於 2026-10-03 觀察）記錄了一個 deliveryPolicy 欄位。其值為 auto、verified、official 或 null。null 值會繼承工作區政策。

此草稿遵循記錄的 PATCH 格式。金鑰 ID 為文件範例值。

curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryPolicy": "verified"
  }'

更新至少需要一個欄位，因此此主體本身是有效的。回應會將設定回報為 delivery_policy，其中 null 表示該金鑰繼承工作區預設值。建立端點在請求主體中接受相同的 deliveryPolicy 欄位。在建立時省略它與記錄的 null 繼承一致，如建立範例回應顯示 delivery_policy: null 所示。

當請求的選項不可用時

如果您請求的選項沒有供應，TokenLab 會回傳 503 delivery_tier_unavailable 和一個請求 ID。錯誤處理指南（觀察日期 2026-10-03）說明了如何讀取 retryable。

5xx 狀態並不總是意味著暫時性中斷。當選定的操作在該層級沒有供應時，retryable 為 false 且會省略 retry_after。請勿重複發送相同的請求。相反地，請執行以下操作：

1. 讀取 code 和 retryable，而不是人類可讀的 message。
2. 儲存回應標頭中的請求 ID。
3. 在選擇另一個模型或層級之前，先使用 GET /v1/models 檢查模型的交付可用性。

該指南警告說，相似的模型名稱並不代表可用性。客戶端應根據 code 進行分支處理，僅在 retryable 為 true 時重試 5xx 錯誤，並遵守 retry_after 以及限制嘗試次數。

檢查模型擁有的選項

模型端點會回報 delivery availability by option。這些值來自即時模型 API，觀察日期 2026-10-03：

模型 ID	Verified	Official	模型頁面
claude-sonnet-5	true	true	/models/claude-5/claude-sonnet-5
gpt-5.6-terra	true	true	/models/gpt-5-6/gpt-5.6-terra
deepseek-v4-flash	false	true	/models/deepseek-v4/deepseek-v4-flash

例如，在 deepseek-v4-flash 上指定 verified 就是會觸發 delivery_tier_unavailable 的請求，因為 API 回報目前沒有 Verified 供應。Official 和 Auto 在該模型上仍然有效。

您可以自行檢查任何模型：

curl "https://api.tokenlab.sh/v1/models/deepseek-v4-flash"

可用性會在每次請求執行時進行檢查，計費指南指出交付標籤描述了支援的選項。請將模型 API 視為快照，並在硬編碼指定層級之前重新讀取它。

選擇如何影響您的費用

計費指南（觀察日期 2026-10-03）指出，每個完成的請求都會被收取一次費用，費用取決於產生結果的選項：

• TokenLab Verified 使用 TokenLab 公開價格。
• Official 使用基於模型製造商公開價格的 Official 價格層級。
• Auto 根據完成請求的選項收費。

對於付費生成，控制台會在確認前顯示最高預估費用，而「使用量」(Usage) 頁面會顯示最終費用。任何未使用的預留金額將被釋放。在模型頁面上，TokenLab 價格欄中的破折號表示目前沒有 Verified 優惠，並不代表免費。

該指南未記錄 Verified 與 Official 之間有固定的價格差距，因此我們不會聲稱有此差距。以 2026-10-02 更新的 claude-sonnet-5 即時 TokenLab 價格為例，模型 API 列出的輸入價格為每 100 萬 token 0.9 美元，輸出價格為 4.5 美元。作為估算，100,000 個輸入 token 加上 10,000 個輸出 token 為 0.09 + 0.045 = 0.135 美元。該數字僅使用列出的 TokenLab 價格。在比較之前，請先閱讀模型頁面上的 Official 價格。

簡短決策指南

• 預設為 Auto：當您希望請求完成且可以接受任一價格層級時。
• 指定 Verified：當您需要 TokenLab 價格且模型回報 verified: true 時。
• 指定 Official：當您需要基於模型製造商的公開價格，或模型沒有 Verified 供應時。
• 設定金鑰預設值：適用於始終需要相同層級的工作負載，並使用標頭處理一次性的例外情況。

在指定之前，請先讀取 GET /v1/models/{model}。進行小規模測試並在「使用量」頁面確認費用。

下一步：建立帶有交付政策的金鑰

在控制台中建立 API 金鑰，或使用管理權杖呼叫 POST /v1/management/api-keys 並在主體中設定 deliveryPolicy，如建立 API 金鑰頁面所述。然後使用上述標頭發送一個小請求，並在「使用量」頁面檢查費用。

常見問題集

如果標頭、API 金鑰和工作區設定不一致，哪一個會生效？

請求標頭會勝出。API 金鑰設定會覆蓋工作區預設值。即時工作階段會跳過標頭，並使用金鑰或工作區設定。

為什麼我收到 503 delivery_tier_unavailable，我應該重試嗎？

您請求的層級在該操作中沒有供應。請讀取 retryable：當它為 false 時，請勿重新發送相同的請求。請使用 GET /v1/models 檢查可用性並更改層級或模型。

Official 是否比 TokenLab Verified 更貴？

文件未說明固定的差異。Verified 使用 TokenLab 公開價格，而 Official 使用模型製造商的公開價格基礎。請在模型頁面上比較兩者，並在「使用量」頁面確認最終費用。

我該如何查看模型支援哪些交付選項？

呼叫 GET /v1/models/{model}，這不需要金鑰。目前 claude-sonnet-5 和 gpt-5.6-terra 回報支援 Verified 和 Official，而 deepseek-v4-flash 僅回報支援 Official。

我可以為即時工作階段設定交付選項嗎？

可以，透過 API 金鑰或工作區設定。即時工作階段不接受查詢字串覆蓋。

在控制台建立您的 TokenLab API 金鑰