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。