常见问题
关于 BazaarLink AI API、计费、模型访问、安全与开发集成的常见解答。
BazaarLink 与 OpenRouter 有什么区别？可以直接替代吗？
BazaarLink 同样提供统一的 OpenAI 兼容 API，并加入台湾本地支付与电子统一发票渠道、中文支持以及 AI Agent 自动申请 API Key。模型供应、价格与能力可能随时间调整，接入前请以模型目录为准。
如何从 OpenRouter 或 OpenAI API 迁移到 BazaarLink？
通常只需将 base_url 改为 https://bazaarlink.ai/api/v1、换成 BazaarLink API Key，并通过模型目录确认完整的 model ID。上线前仍应测试流式输出、工具调用与错误处理，因为不同模型的能力和参数不一定相同。
哪些支付方式可以取得台湾电子统一发票？
需要公司统一编号与台湾电子统一发票时，请选择充值页面明确标示可开具发票的新台币支付渠道，并在付款前填写完整的发票信息。不同渠道提供的凭证不同，是否开具台湾发票应以结账页面当时的标示为准。
BazaarLink 是否兼容 OpenAI SDK、Cursor、Claude Code 与其他工具？
BazaarLink 支持 OpenAI 兼容 API，也提供 Anthropic Messages API。凡是允许自定义 API Key 与兼容端点的 SDK 或工具，通常都能接入；实际设置字段与功能支持仍应根据各工具版本及 BazaarLink 文档进行测试确认。
哪些场景适合使用 BazaarLink？
适合需要通过单一 API 访问多家模型、使用台湾公司报账渠道、获得中文支持、让 AI Agent 以编程方式申请 Key，或希望通过公开 Probe 信息评估 API 质量的开发者与团队。
BazaarLink 如何计费？模型费用会加价吗？
模型推理用量采用零加成计费，根据模型页面公开的输入、输出或其他计费单位扣款；平台费用在充值时收取，部分渠道另有固定手续费、汇率或营业税。请以模型页面和付款确认页面显示的实时金额为准。
Stripe 收据和台湾电子统一发票有什么区别？
通过 Stripe 使用美元信用卡付款时提供的是 Stripe 付款收据，不等同于 BazaarLink 新台币渠道开具的台湾电子统一发票。公司需要统一编号与台湾发票报账时，请选择结账页面标示可开具发票的渠道。
BazaarLink 有免费的 API Key 吗？需要信用卡吗？
可以先注册并创建 API Key，无需预先绑定信用卡即可使用当前开放的免费模型或 auto:free。免费模型、额度与使用限制会动态调整，请以免费 API 页面显示的信息为准。
免费额度用完后会怎样？
免费 quota 用完后，如果账户仍有可用余额，可以按正常付费费率继续调用；如果没有余额，请等待 quota 重置或先充值。免费额度与重置规则采用动态设置，FAQ 不承诺固定数值。
BazaarLink 支持哪些 API 格式与功能？
公开 API 包括 OpenAI 兼容的 Chat Completions、Responses、Embeddings、图像、视频与语音功能，也支持 Anthropic Messages API。每个模型可用的输入格式和功能不同，请同时查看 API 文档与模型目录。
模型名称应该如何填写？如何查询价格、Context Window 与能力？
请优先使用 /api/v1/models 或模型目录返回的完整 model ID。模型页面会列出当前价格、Context Window 与支持的能力；无法识别的 model ID 会被拒绝，因此请勿自行猜测或沿用过时名称。
BazaarLink 的 API 速率限制是多少？如何查看？
速率限制会根据账户、方案与模型的实时设置而有所不同，不应使用单一固定 RPM 表示。可以通过 Key 与用量信息查看当前状态；超过限制时 API 会返回 429，客户端应根据 Retry-After 或退避策略重试。
BazaarLink 会存储我的 Prompt 或模型响应吗？
一般成功请求主要保留模型、Token、时间与费用等计费及运营数据，不会将完整 Prompt 和响应作为常规产品记录。错误排查或滥用调查可能会保留有限且经过截断的信息；同时请留意实际上游模型供应商的数据政策。
BazaarLink 如何保护 API Key 与 BYOK 密钥？
BazaarLink API Key 采用不可逆哈希保存，BYOK 上游密钥采用加密方式保存，传输过程使用 TLS。Key 可以撤销，也可以通过先创建新 Key、完成部署验证后再撤销旧 Key 的方式进行轮换。
上游模型供应商发生故障或限流时会如何处理？
具备备用路由时，如果主要供应商出现超时、限流或部分上游错误，可以根据路由设置尝试下一个供应商或模型。如果所有上游都失败，API 会返回可供判断的错误；客户端仍应实现 timeout、重试与降级策略。
可以为每个 API Key 设置消费上限、停用或轮换吗？
可以创建多个 API Key，并分别管理消费上限与启用状态。需要轮换时，先部署并验证新 Key，再撤销旧 Key，可以降低服务中断风险；请勿在源代码或公开记录中保存完整 Key。
API 返回 402、429、502、503 分别代表什么？
402 通常表示余额、信用或预算限制；429 表示速率限制；502 表示上游请求失败；503 表示当前没有可用路由或服务暂时不可用。应记录 request ID，并根据错误类型进行充值、退避重试、切换模型或联系支持团队。
遇到付款、账单或 API 故障时，如何联系支持团队？
可以通过支持页面或 support@bazaarlink.ai 联系团队。报告 API 问题时，请提供发生时间、request ID、使用的 model ID、HTTP 状态码与可以安全分享的错误内容，但请勿附上完整 API Key、Prompt 或其他敏感数据。