ZDR ゼロデータ保持:設定・対応範囲・エラーコード|BazaarLink
ZDR(ゼロデータ保持)は API キーのモードです。有効にすると、そのキーのリクエストはゼロデータ保持を表明した上流プロバイダーにのみ送られ、BazaarLink が固定指定します。BazaarLink 自身もプロンプトと応答を保存しません。
ZDR キーが保証すること
- リクエストは BazaarLink が承認した ZDR ルートのみを使い、上流は固定されます。失敗時も ZDR ルート間でのみ切り替わり、通常ルートには戻りません。
- ZDR ルートのないモデルは、別ルートを黙って使わずエラーを返します。
- このキーのプロンプト、モデルの応答、上流のエラー内容は保存しません。利用記録に残るのは時刻、モデル、使用量、料金、ステータスのみです。
- 既定では第三者のコンテンツ審査サービスに内容を送りません。
- 料金は通常のリクエストと同じで、上乗せはありません。
有効にする方法
個人キー:/keys でキーを作成・編集するときに「ZDR を有効にする」をオンにします。
組織:組織管理者は組織設定で ZDR ポリシーを「すべてのキーで必須」にできます。組織内のすべてのキーが ZDR になり、キー作成フォームではチェック済みでロックされます。
ZDR をオフにするとキーの保護レベルが下がるため、再確認と監査ログの記録が必要です。組織ポリシーでロックされたキーは単独でオフにできません。
使い方
base_url を https://api.bazaarlink.ai/v1 に設定し、ZDR を有効にしたキーを使います。それ以外は通常の呼び出しと同じです。
ZDR ルートのあるモデルは、/v1/models の各モデルの zdr_available で確認できます。?zdr=only を付けると利用可能なモデルだけが返ります。
GET https://api.bazaarlink.ai/v1/models?zdr=onlyZDR で対応していない機能
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 ルートが一時的に利用できません | しばらくしてから再試行してください。通常ルートへ自動で戻ることはありません |
{"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"}}{"error":{"message":"This endpoint is not available for zero-data-retention API keys.","type":"invalid_request_error","code":"zdr_endpoint_unsupported"}}{"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 として扱われます。