BazaarLink API 金鑰完整指南：申請、設定、在程式碼中使用

如何申請和使用 BazaarLink AI API 金鑰？本文提供從申請到在 Python、Node.js 程式碼中呼叫 300+ AI 模型的完整步驟，並說明金鑰管理最佳實踐。

什麼是 AI API 金鑰？

API 金鑰（API Key）是一組唯一的字串，用來驗證你的身分並授權你呼叫 AI 服務。 每次你的程式送出請求——例如請 GPT-4o 生成文章、叫 Claude 分析文件——伺服器都會驗證這組金鑰， 確認請求來自合法的帳戶，並記錄對應的用量與費用。

BazaarLink 的 API 金鑰格式以 blk- 開頭， 讓你一眼就能區分它和其他平台的金鑰。一個 BazaarLink 帳戶可以建立多組金鑰， 每組金鑰可設定獨立的名稱、用量上限，方便不同專案或團隊成員分開管理。

第一步：申請 BazaarLink API 金鑰

第二步：在程式碼中使用 API 金鑰

BazaarLink 使用與 OpenAI 完全相容的 API 格式。 如果你之前用過 OpenAI API，只需修改兩個參數：api_key 和 base_url， 其餘程式碼完全不需要動。

Python（openai 套件）

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BAZAARLINK_API_KEY"],
    base_url="https://bazaarlink.ai/api/v1"
)

response = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "你好！"}]
)
print(response.choices[0].message.content)

TypeScript / Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BAZAARLINK_API_KEY,
  baseURL: "https://bazaarlink.ai/api/v1",
});

const res = await client.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "你好！" }]
});
console.log(res.choices[0].message.content);

curl（直接測試）

curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-4o-mini","messages":[{"role":"user","content":"你好！"}]}'

支援哪些 AI 模型？

一組 BazaarLink API 金鑰可以呼叫 300+ 個模型，包含各大主要供應商， 只需修改 model 參數即可切換，不需要另外申請帳戶：

完整模型列表請參考 BazaarLink 模型頁面。

金鑰管理最佳實踐

用環境變數存放金鑰

永遠不要把 API 金鑰直接寫進程式碼或提交到 Git。請使用環境變數：

# .env.local（本地開發）
BAZAARLINK_API_KEY=blk-xxxxxxxxxxxxxxxx

# 絕對不要這樣做 ❌
api_key = "blk-xxxxxxxx"  # 寫死在程式碼裡

一個專案一組金鑰

建議每個獨立的服務或專案使用不同的金鑰，並以清楚的名稱標記（例如：prod-api-server、dev-local、marketing-bot）。 這樣當某個服務出問題時，可以單獨撤銷該金鑰，不影響其他服務。

設定用量上限

在 API Keys 頁面，可以為每組金鑰設定月費用上限（以 USD 為單位）。 超過上限後，該金鑰的請求會自動被拒絕，不會繼續扣費， 是防止意外爆量的最有效防線。

金鑰洩漏了怎麼辦？

如果你懷疑金鑰被洩漏，請立即執行以下步驟：

1. 前往 API Keys 頁面，點選洩漏的金鑰旁的「刪除」
2. 立即建立一組新金鑰，更新你的服務的環境變數
3. 至 Logs 頁面 檢查是否有異常呼叫記錄
4. 如有異常用量，請 聯繫客服 申請費用核查

常見問題

Q：API 金鑰申請要付費嗎？

不需要。建立 BazaarLink 帳戶和申請 API 金鑰都是免費的。 使用 auto:free 模型也完全免費，不需要信用卡。 只有在使用付費模型（如 GPT-4o、Claude Sonnet）時，才會依實際 token 用量計費。

Q：一個帳戶可以建立幾組金鑰？

一般帳戶可建立多組金鑰，沒有嚴格上限。企業方案可支援更大量的金鑰， 並支援組織架構下的集中管理。

Q：BazaarLink 的 API 格式和 OpenAI 完全相容嗎？

是的。BazaarLink 完全支援 OpenAI Chat Completions API 格式，包含 streaming、function calling、vision 等功能。 只需換掉 api_key 和 base_url， 其他程式碼無需修改即可運作。

Q：可以用在台灣公司的專案報帳嗎？

可以。BazaarLink 是台灣登記公司，支援開立三聯式統一發票，可填入公司統編， 符合台灣企業的報帳需求。詳情請參考 AI API 費用台灣報帳指南。

Q：API 金鑰有效期限多久？

BazaarLink 的 API 金鑰沒有自動過期機制，永久有效直到你主動刪除。 建議定期稽核並刪除不再使用的金鑰，降低安全風險。

Q：如何查看金鑰的使用量？

登入後前往 Logs 頁面， 可以依時間範圍、模型、API Key 篩選查看每筆呼叫的詳細記錄， 包括 token 數量、費用與請求狀態。

台幣計費（Beta）・統一發票即將上線・300+ AI 模型・OpenAI 相容 API