你可以在 Heptabase 的 AI Agent 與轉錄功能（僅限 OpenAI API 金鑰）使用自己的 API 金鑰。用量、計費與速率限制由供應商專案決定。使用自己金鑰的請求不會消耗 Heptabase AI 額度。

​

以下簡介如何申請 API 金鑰。目前支援五種選項：自訂供應商、OpenRouter、Google Gemini、OpenAI 及 Anthropic Claude。（點擊連結即可前往對應章節）

若要用於 AI Chat／Agent，請開啟目前版本的桌面版或網頁版，前往 Settings → AI Features → Custom providers。

​

使用可公開存取的 HTTPS OpenAI 相容基底網址。

​

Base URL 必須保留供應商要求的 API 版本或基底路徑。例如，供應商文件中的 OpenAI 相容基底網址以 /v1 結尾，就必須包含 /v1。不要假設每個供應商都使用 /v1，請遵循供應商文件列出的 OpenAI 相容基底網址。

​

不要包含 /chat/completions，因為 Heptabase 會自行附加此路徑。

​

驗證可使用 Bearer token 或自訂 API 金鑰標頭，也支援額外的自訂標頭。

​

請手動加入模型 ID；Heptabase 不會從端點自動探索模型。端點必須支援 AI Chat 所需的串流與工具使用功能。

​

自訂供應商目前適用於 AI Chat／Agent，不是用來全面覆蓋 AI Tutor、轉錄或所有其他 Heptabase AI 功能的網路設定。

​

ChatGPT 與 Claude 的消費者訂閱和 API 計費分開，目前不能作為 AI Tutor 的用量來源。AI Tutor 目前使用 Heptabase AI 額度，包含方案額度用完後的按用量計費。

OpenRouter 讓你透過一組由 OpenRouter 發出的 API 金鑰，在 Heptabase 使用更多模型。OpenAI、Anthropic 與 Gemini 模型仍使用各自的官方 API 金鑰欄位。目前不支援 OpenRouter 的 :free 版本。

​

登入 openrouter.ai/keys，建立由 OpenRouter 發出的 API 金鑰（通常以 sk-or- 開頭）。

​

如果希望 OpenRouter 使用原生供應商金鑰，請將它加入 OpenRouter Integrations。貼入 Heptabase 的金鑰仍必須是 OpenRouter 發出的金鑰，不能是 DeepSeek、Kimi 或其他供應商的原生金鑰。

​

開啟 Heptabase 桌面版或網頁版，前往 Settings → AI Features → Use my API key to use AI features without limits。點擊 +，選擇 OpenRouter，並貼上 OpenRouter 發出的金鑰。

前往 Gemini API 頁面，確認瀏覽器已登入你想與 API 金鑰關聯的 Google 帳戶。如果沒有 Google 帳戶，需先建立。

​

登入後，點擊「Get a Gemini API key」按鈕。

​

點擊頁面右上角的「Create API key」，選擇現有專案，再點擊「Create API key in existing project」。

依照頁面指示，將 API 金鑰存放在安全的地方。

開啟 Heptabase 桌面版或網頁版，前往 Settings → AI Features → Use my API key to use AI features without limits。

​

接著點擊 +，選擇 Gemini，並貼上密鑰。

​

Heptabase 目前透過 API 金鑰連接 Gemini，不支援透過 Google AI Pro 或 Ultra 消費者方案登入。Google AI Pro 或 Ultra 會員本身不會讓 Gemini API 專案成為付費專案，也不會把消費者方案額度轉移到 Heptabase。Gemini API 用量會透過連結至 API 專案的 Google Cloud Billing 帳戶另外計費。你可以在 Google AI Studio 查看 API 專案的方案與帳務狀態。詳情請參閱 Google 的 Gemini API 帳務文件。

​

使用自己的 Gemini API 金鑰時，請求適用於該金鑰所屬 Google AI Studio 專案的限制。金鑰在 Heptabase 顯示 Verified，只代表它可使用，不代表專案仍有剩餘配額。Gemini API 限制可能包含每分鐘請求數（RPM）、每分鐘 Token 數（TPM）與每日請求數（RPD）。超過任何適用限制都可能造成 429 速率限制錯誤。

​

在 Google AI Studio 確認金鑰所屬專案，並檢查 Usage 與 Rate limits。如果兩個頁面都沒有顯示超限，請稍候再試。如果持續出錯，請聯絡 Heptabase 客服，提供這兩個頁面的截圖，以及大約發生時間與時區。詳情請參閱 Google 的 Gemini API 速率限制文件。

如果沒有帳戶，請前往 OpenAI 平台建立。註冊時可能需要驗證電子郵件與電話號碼（帳戶驗證需要有效電話）。建立並驗證完成後，請登入。

​

登入後，前往 OpenAI API keys 區域，點擊右上角「Create new secret key」。可依需求選擇不同設定；若沒有特別偏好，直接點擊「Create secret key」。

依照頁面指示，將密鑰存放在安全的地方。

開啟 Heptabase 桌面版或網頁版，前往 Settings → AI Features → Use my API key to use AI features without limits。

​

接著點擊 +，選擇 OpenAI，並貼上密鑰。

​

使用服務前，必須先購買至少 $5 的額度。可以到 OpenAI 平台的 Billing 頁面購買額度，並設定用量上限。

如果沒有帳戶，請前往 Anthropic Console 建立。註冊時可能需要驗證電子郵件與電話號碼（帳戶驗證需要有效電話）。建立並驗證完成後，請登入。

​

登入後，前往 API Key 區域，點擊右側「Create key」。可以替金鑰命名，再點擊「Add」。

依照頁面指示，將密鑰存放在安全的地方。

開啟 Heptabase 桌面版或網頁版，前往 Settings → AI Features → Use my API key to use AI features without limits。

​

接著點擊 +，選擇 Anthropic，並貼上密鑰。

​

使用服務前，必須先購買至少 $5 的額度。可以到 Anthropic Console 的 Billing 頁面購買額度、設定自動儲值，或設定用量上限。