常見問題
關於 BazaarLink AI API、台灣統一發票、OpenRouter 替代方案與開發整合的常見解答。
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 或其他敏感資料。