BazaarLinkBazaarLink
ログイン
ドキュメントAPIリファレンスSDKリファレンスエージェント利用AIスキル

ZDR ゼロデータ保持:設定・対応範囲・エラーコード|BazaarLink

ZDR(ゼロデータ保持)は API キーのモードです。有効にすると、そのキーのリクエストはゼロデータ保持を表明した上流プロバイダーにのみ送られ、BazaarLink が固定指定します。BazaarLink 自身もプロンプトと応答を保存しません。

ZDR キーが保証すること

  • リクエストは BazaarLink が承認した ZDR ルートのみを使い、上流は固定されます。失敗時も ZDR ルート間でのみ切り替わり、通常ルートには戻りません。
  • ZDR ルートのないモデルは、別ルートを黙って使わずエラーを返します。
  • このキーのプロンプト、モデルの応答、上流のエラー内容は保存しません。利用記録に残るのは時刻、モデル、使用量、料金、ステータスのみです。
  • 既定では第三者のコンテンツ審査サービスに内容を送りません。
  • 料金は通常のリクエストと同じで、上乗せはありません。

有効にする方法

個人キー:/keys でキーを作成・編集するときに「ZDR を有効にする」をオンにします。

組織:組織管理者は組織設定で ZDR ポリシーを「すべてのキーで必須」にできます。組織内のすべてのキーが ZDR になり、キー作成フォームではチェック済みでロックされます。

ZDR をオフにするとキーの保護レベルが下がるため、再確認と監査ログの記録が必要です。組織ポリシーでロックされたキーは単独でオフにできません。

使い方

base_url を https://api.bazaarlink.ai/v1 に設定し、ZDR を有効にしたキーを使います。それ以外は通常の呼び出しと同じです。

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 を付けると利用可能なモデルだけが返ります。

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_gatewayZDR はまだお客様の接続に開放されていません。保護のため、通常リクエストとして処理せず拒否します開放時期はお問い合わせください。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 として扱われます。

サポート
サポート
こんにちは。どのようなご用件でしょうか?
メッセージをお送りください。担当者より返信します。
ZDR ゼロデータ保持:設定・対応範囲・エラーコード|BazaarLink