如何取得 Poe API 金鑰
每個使用 AI 模型的 Poe Canvas 應用,要在 Poe 平台以外運作都需要 Poe API 金鑰。當你用 AppToPub 把 Canvas 應用轉換成獨立網頁應用時,API 金鑰就是讓你部署的應用能與 GPT-4、Claude、Gemini 等 AI 模型通訊的關鍵。本指南會清楚說明如何取得。
什麼是 Poe API 金鑰?
Poe 提供一個開發者 API,讓外部應用向 AI 模型傳送訊息並接收回應。你的 API 金鑰就是用來驗證這些請求的憑證。可以把它想成一個密碼,證明你的應用有權使用 Poe 的 AI 基礎設施。
當你的 Canvas 應用在 Poe 內執行時,會自動使用 Poe 的內建驗證。但一旦你把它匯出並託管成獨立網頁應用,就需要你的 API 金鑰才能繼續運作。AppToPub 會以 AES-256 加密你的金鑰,絕不會在應用原始碼中外露。
逐步教學:取得你的 Poe API 金鑰
- 登入 Poe。 前往 poe.com 並以你的帳號登入。
- 開啟你的帳號設定。 點擊右上角的個人頭像,然後在下拉選單中選擇 Settings 。
- 前往 API Keys。 直接前往 poe.com/api_key ,或在設定側邊欄找到 API Keys / Developer 區塊。
- 產生一把新金鑰。 點擊 Create API Key 按鈕。Poe 會產生一串獨一無二的金鑰 — 通常以某個前綴開頭,並包含一長串英數字元。
- 安全地複製並保存金鑰。 立即複製金鑰。Poe 可能只會顯示一次。請把它存進密碼管理器或安全筆記 — 不要公開分享,也不要提交到原始碼。
API 金鑰安全檢查清單
你的 API 金鑰可存取你帳號下的 Poe AI 模型。請把它當成密碼對待:
- 要 把金鑰存進密碼管理器或加密筆記。不要 把它貼到公開聊天室、GitHub 倉庫或社交媒體貼文。
- 要 使用 AppToPub 的加密金鑰儲存 — 你的金鑰在進入資料庫前已用 AES-256 加密。不要 把原始金鑰直接嵌入任何你分享的 HTML 或 JavaScript 檔案。
- 要 一旦懷疑金鑰外洩,立即輪換金鑰。不要 在安全事件後,未先撤銷舊金鑰就重複使用同一把金鑰。
- 要 留意你的 Poe 使用儀表板是否有異常飆升。不要 忽略 Poe 關於異常活動的電郵警示。
AppToPub 如何使用你的 API 金鑰
當你在 轉換流程 中把 API 金鑰貼進 AppToPub 時,會發生以下事情:
- 你的金鑰在存入資料庫前會以 AES-256 加密。原始金鑰絕不會以明文儲存。
- 當有人造訪你部署的應用時,AppToPub 的後端伺服器會即時解密金鑰,以代理向 Poe 發出的 API 請求。金鑰絕不會傳送到使用者的瀏覽器。
- 原始 Canvas 應用的 API 呼叫會被改寫,改為經 AppToPub 的安全代理路由,因此你的金鑰對終端使用者保持隱藏。
這套架構意味著你的訪客能獲得流暢的 AI 體驗,同時你的 API 憑證仍受保護。詳情請見我們的隱私權政策,了解我們如何處理敏感資料。
API 金鑰的限制與用量
Poe API 金鑰有用量限制,視你的 Poe 訂閱層級而定。以下是一些實務考量:
- 速率限制 — Poe 對 API 呼叫設有速率限制。高流量應用在尖峰時段可能會觸及這些限制。廣泛分享應用時請納入考量。
- 模型存取 — 你的 API 金鑰可用的模型視你的 Poe 訂閱而定。免費帳號可用的模型可能比付費訂閱受限。
- 成本 — API 呼叫會消耗 Poe 的運算點數。請在 Poe 的儀表板以及 AppToPub 的分析 中監控用量,以免產生意外費用。
疑難排解
- 我的設定裡看不到 API Keys 區塊
- API 金鑰存取可能需要 Poe 訂閱或開發者帳號註冊。請查閱 Poe 的文件了解目前的資格要求。
- 把金鑰貼進 AppToPub 後不能用
- 請確認你複製了完整的金鑰字串,且沒有前後多餘的空格。也請確認金鑰未在你的 Poe 設定中被撤銷。
- 我可以用同一把金鑰於多個應用嗎?
- 可以。單一 Poe API 金鑰可用於你所有的 AppToPub 部署。所有應用會共用綁定於該金鑰的速率限制與用量配額。
- 我應該定期輪換金鑰嗎?
- 這是良好的安全習慣。如果你在 Poe 輪換金鑰,就需要透過 專案儀表板 為每個已部署的應用更新新金鑰。
下一步?
你已經有 API 金鑰 — 現在該取得應用的原始碼了。下一步是 把你的 Poe Canvas 應用匯出成 HTML,大約 30 秒就能完成,並為轉換流程做好準備。