ZDR 零資料保留：設定、支援範圍與錯誤碼｜BazaarLink

ZDR（Zero Data Retention，零資料保留）是 API 金鑰的一個模式。開啟後，這把金鑰的請求只會交給宣稱零資料保留的上游供應商，並由 BazaarLink 固定指定；BazaarLink 本身也不保存提示詞與回應內容。

ZDR 金鑰保證什麼

請求只走 BazaarLink 已核准的 ZDR 路線，並固定指定上游；上游失敗時只會在 ZDR 路線之間切換，不會退回一般路線。
沒有 ZDR 路線的模型會直接回錯誤，不會偷偷改走其他路線。
BazaarLink 不保存這把金鑰請求的提示詞、模型回覆與上游錯誤內容；用量紀錄只含時間、模型、用量、費用與狀態。
預設不把內容送到第三方內容審核服務。
價格與一般請求相同，不加價。

如何開啟

個人金鑰：到 /keys 建立或編輯金鑰時打開「啟用 ZDR」。

組織：組織管理員可在組織設定把 ZDR 政策設為「所有金鑰一律啟用」。此時組織底下所有金鑰自動啟用 ZDR，建立金鑰的表單會顯示已勾選並鎖住。

關閉 ZDR 會降低這把金鑰的保護等級，需要二次確認並留下稽核紀錄；被組織政策鎖住的金鑰無法單獨關閉。

使用方式

把 base_url 設為 https://api.bazaarlink.ai/v1，並使用開啟 ZDR 的金鑰，其餘與一般呼叫相同。

1
2
3
4
5
6
7
8
9
10
11
12
13
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BAZAARLINK_API_KEY"],  # a key with ZDR turned on
    base_url="https://api.bazaarlink.ai/v1",
)

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-5.5",
    messages=[{"role": "user", "content": "Reply with exactly one line: hello"}],
)
print(response.choices[0].message.content)

查詢哪些模型有 ZDR 路線：/v1/models 會在每個模型標示 zdr_available，加上 ?zdr=only 只列出可用的模型。

1
GET https://api.bazaarlink.ai/v1/models?zdr=only

不支援 ZDR 的功能

以下請求用 ZDR 金鑰會直接回 400，不會被轉去其他路線：

圖片、音訊、影片、向量（embeddings）、重排序、搜尋與研究類端點。
虛擬模型（vm/ 開頭）、自動路由（auto）。
模型後綴 :free、:floor、:nitro、:online、:eco，以及 web search 外掛。
models 備援清單。

錯誤碼

所有 ZDR 相關錯誤都由 BazaarLink 本身產生，訊息不含任何上游供應商資訊。

錯誤碼	意思	怎麼辦
400 zdr_route_unavailable	這個模型目前沒有零資料保留路線	改用 zdr_available 為 true 的模型，或改用沒有開 ZDR 的金鑰
400 zdr_endpoint_unsupported	這個端點或功能不支援 ZDR	改用支援的對話端點（chat completions、messages、responses），並移除不支援的功能
400 zdr_requires_gateway	ZDR 尚未對您的連線開放，為保護您，我們拒絕處理而不是當成一般請求	請聯絡我們確認開通時間，並使用 https://api.bazaarlink.ai/v1
503	所有 ZDR 路線暫時都無法使用	稍後重試；系統不會自動退回一般路線

1
{"error":{"message":"This model is not available for zero-data-retention (ZDR) API keys. ZDR keys can only use the models listed at https://bazaarlink.ai/docs/zdr (or GET /v1/models?zdr=only). You can also turn off ZDR mode for this key on the API keys page.","type":"invalid_request_error","code":"zdr_route_unavailable"}}

1
{"error":{"message":"This endpoint is not available for zero-data-retention API keys.","type":"invalid_request_error","code":"zdr_endpoint_unsupported"}}

1
{"error":{"message":"This model variant is not available for zero-data-retention (ZDR) API keys (the :free, :floor, :nitro, :online and :eco variants, the auto router and virtual models are not supported). Use a regular model listed at https://bazaarlink.ai/docs/zdr, or turn off ZDR mode for this key on the API keys page.","type":"invalid_request_error","code":"zdr_endpoint_unsupported"}}

BYOK、BYOC 與虛擬模型

ZDR 金鑰不使用您自己設定的 BYOK 或 BYOC 供應商金鑰：一律改走 BazaarLink 的 ZDR 路線，並照平台價格計費。
以 byok-custom/ 或 byoc/ 開頭的模型沒有 ZDR 路線，會回 400（zdr_route_unavailable）。
虛擬模型（vm/ 開頭）不支援 ZDR，會回 400（zdr_endpoint_unsupported）。
需要使用自己的供應商金鑰或虛擬模型時，請改用沒有開 ZDR 的金鑰。

資料保留範圍

ZDR 請求的用量紀錄只保存時間、模型、用量、費用、狀態與是否為 ZDR；不保存提示詞、回應或錯誤內文。
ZDR 說明的是 BazaarLink 與其固定指定的上游供應商；您的程式、日誌或其他服務自行保存的資料不在此範圍。

常見問題

開了 ZDR 價格會不一樣嗎？

目前與一般請求相同，不加價。若日後調整，會先公告。

ZDR 金鑰可以呼叫所有模型嗎？

不行。只有已建立 ZDR 路線的模型可用，可用 /v1/models?zdr=only 查詢；其他模型會回 400（zdr_route_unavailable）。

組織強制 ZDR 後，成員還能建立一般金鑰嗎？

不能。組織政策設為「所有金鑰一律啟用」後，組織底下新建與既有的金鑰都視為 ZDR。