AI-Pay 是什麼
AI-Pay 是 AI App 的共用錢包與計量閘道：使用者在 AI-Pay 用同一份 AI 額度，授權多個 App 在自己設定的花費上限內使用 AI；每一筆 AI 用量由 AI-Pay 計量、從使用者的錢包結算，並開出收據。開發者不接金流、不保管模型金鑰，也不替使用者墊付模型費用。
| 角色 | 你在 AI-Pay 做什麼 | 誰付費 |
|---|---|---|
| 使用者 | 登入、查看 AI 額度、授權 App 並設定每次／每日／每月上限、查看每筆收據，隨時暫停或撤銷授權。 | 使用者用自己的 AI 額度支付模型費用。 |
| 開發者 | 建立 App、接上「Sign in with AI-Pay」、以使用者的授權呼叫模型、在 Console 逐筆對帳。 | 你的 App 沒有模型帳單。透過 AI-Pay 向使用者收取 App 服務費的功能目前未開放。 |
目前為邀請制 Beta 測試，僅提供受邀使用者測試，不開放一般公開註冊。系統可能出現功能異常、服務中斷或資料遺失；不建議上傳敏感或重要資料，請自行保留備份，了解風險後再開始使用。正式環境目前不受理儲值。詳見服務條款與隱私政策。
目前開放哪些功能
本階段僅供受邀使用者測試，下列已開放功能均受邀請與授權限制。測試額度依邀請而定；細節以開發者文件與各環境的畫面為準。
| 功能 | 狀態 | 說明 |
|---|---|---|
| 開戶（Beta 測試） | 僅限受邀使用者 | 請先與邀請人溝通，確認了解測試限制與資料風險，再依邀請方式登入及建立帳號。在 AI-Pay 網站或透過 App 的「Sign in with AI-Pay」皆須符合邀請資格；不開放一般公開測試名額。 |
| 測試額度 | 依邀請而定 | 額度依邀請內容提供，通常在登入時入帳，未入帳時系統會自動重試（最長約一天）。用途與收回見費用怎麼算。 |
| Sign in with AI-Pay（登入連線） | 已開放 | 標準 OAuth 2.0 授權碼＋PKCE，public client、沒有 client secret。只要求身份 scope 時是純登入，不會出現花費介面。 |
| AI 額度授權（用使用者的額度呼叫模型） | 已開放 | 使用者在授權畫面設定上限後，App 以 ai.chat.create＋wallet.charge 呼叫 POST /v1/chat/completions；每個成功回應附收據。 |
| OpenAI 相容 | 限定子集 | 只支援文字 Chat Completions：body 只認 model／messages／max_tokens／stream，其餘欄位會被拒絕，且必須帶 Idempotency-Key。不是完整的 OpenAI API 相容。 |
| 模型目錄 | 已開放 | 純文字模型，主要經 OpenRouter 路由；即時清單、數量與價目見模型與價目（目錄會隨上游上下架與調價變動，本頁不寫死數量）。列在目錄不保證上游每次都成功。 |
| 儲值（Stripe／PayPal） | 正式環境未開放 | 正式環境目前不受理儲值；測試環境的付款為測試模式，不會實際扣款。開放後，付款總額含付款處理費，不等於入帳的 AI 額度。 |
| App 服務費與提領 | 未開放 | 程式支援每次服務費與用量加成，但目前不向使用者收取任何 App 費用，也不受理收款帳戶設定與提領申請；開放時間未定。 |
| Live（即時語音） | 未開放 | 程式已入庫，正式環境目前未啟用，公開開發者文件也尚未涵蓋。SDK 0.4.0 起有唯讀的 Live 查詢方法，服務未啟用時沒有可用的 offering；開放與接入指南另行公告。 |
費用怎麼算
- 模型費：依模型目錄各模型的零售單價計算。
openrouter_reference_markup_v1政策的零售價＝審核時凍結的上游參考價加上該模型的加價（例如markup_bps: 1200＝ +12%）；legacy 政策的費用已含在其零售價內。價目在請求建立預留時凍結，之後改價不影響已送出的請求。 - App 服務費：目前未開放收取；實際請求不會向使用者收取任何 App 費用。
- 免費封測額度：只能支付透過 AI-Pay 的 AI 用量，不能提領、轉讓或兌換現金；正式環境目前不受理儲值，用完後無法自行增加。封測結束或發放錯誤時，平台可以收回贈額：從收回當下的可用額度扣，最多扣所贈金額；額度不夠時只扣到 0，不會變成負數，也不會另外向你追討。
- 儲值處理費：儲值時由付款畫面顯示；付款總額不等於入帳額度。正式環境目前未開放儲值。
- 收據：每個成功回應都附帶收據（實際扣款與分帳）；Console 的「請求」分頁與錢包活動都能逐筆對帳。
完整公式、凍結規則與收據欄位見開發者文件的〈模型目錄與計價〉。
使用者的控制權與資料
- 上限：每次／每日／每月花費上限由使用者在授權畫面設定，App 只能在上限內花費。
- 暫停與撤銷：暫停、撤銷或調整上限會立即阻止新的 AI 用量；已派發的請求仍可能依原規則結算。撤銷不會替你登出 App 本身，也不會刪除 App 已取得的資料。
- 身份：App 拿到的是 App 專屬的假名識別碼（
sub），不同 App 之間無法用它關聯同一位使用者；email 只在使用者授權該 scope 時才提供。 - 資料處理：提示與回應會以明文送到模型供應商（目前主要是 OpenRouter 及其路由到的實際供應商）處理，不是端對端加密；各供應商的保留政策不同。詳見隱私政策。
下一步
| 你想… | 從這裡開始 |
|---|---|
| 評估 AI-Pay 適不適合 | 模型與價目、計價說明、服務條款與隱私政策。 |
| 把 App 接上 | 快速開始（五步）。SDK @coswic/aipay-sdk 與 CLI @coswic/aipay 都是公開 npm 套件；建立 App 與驗證在 Console。 |
| 以使用者身份使用 | 登入後可查看 AI 額度、每筆費用與已連接 App；授權機制說明見Sign in with AI-Pay。目前沒有公開的 App 目錄，額度要在已接上 AI-Pay 的 App 裡使用。 |
| 讓 coding agent 讀文件 | 下載 Markdown 版：中文／English；API 契約 /openapi.yaml。 |
版本與依據
- 本頁核對日期：2026-09-30。功能狀態依當日正式程式、正式環境設定與公開文件核對；之後的變更以開發者文件與各環境畫面為準。
- API 契約：
/openapi.yaml（生成自程式碼）。SDK／CLI 的現行版本以 npm 為準。 - 法律文件的版本見服務條款與隱私政策頁首。
- 本頁是說明，不參與交易：實際扣款以請求當次凍結的價目與收據為準；授權內容以使用者在授權畫面同意的版本為準。