系統設定詳細配置

什麼是易支付

易支付是聚合支付寶、微信等渠道的第三方收銀台。使用者儲值時透過 `POST /api/user/pay` 取得表單欄位，瀏覽器 POST 至易支付閘道完成付款，非同步回呼更新額度。

易支付設定

填寫支付位址、商戶 ID/金鑰與回呼位址；儲存後可在錢包頁驗證 `GET /api/user/recharge/info` 是否回傳 pay_methods。

Stripe 設定

在支付設定 Tab 設定 Stripe Secret Key、Webhook Secret 等；使用者儲值走 `POST /api/user/stripe/pay` 跳轉 Checkout。

其他支付方式

支援 Creem 等渠道（取決於 option 開關）；各渠道最低儲值與回呼路徑以介面回傳為準。

儲值方式設定

透過 JSON 自訂前端顯示的儲值方式按鈕（name、color、type），對應到易支付 type 參數。

欄位說明

見下方「易支付參數」與「伺服器位址」表格；修改金鑰後需重新測試一筆小額儲值。

儲值金額設定

設定固定級距（如 10/50/100 USD）或允許自訂金額；與 MinTopUp、Price 共同限制使用者輸入。

自訂儲值金額選項

開啟後錢包頁顯示任意金額輸入框；關閉則僅顯示預設級距。

儲值優惠

可依分組設定儲值贈送比例（TopUpGroupRatio），如 vip 分組儲值 100 美元到帳 110 美元等值額度。

易支付參數

全域限流

在「速率限制設定」Tab 設定全站 QPM/QPD 上限，超限回傳 429。適用於保護閘道整體容量。

依使用者分組限流

為不同 group 設定獨立閾值，優先順序高於全域限流；未設定的分組沿用全域值。

分組限流設定範例

JSON 範例：`{"default":{"qpm":60},"vip":{"qpm":300}}`。模型級限流可在同 Tab 依 model 名稱細化。

倍率體系概述

EasyAPI 透過 model_ratio、completion_ratio、group_ratio、cache_ratio 等組合計算額度消耗；模型中繼資料與 option 表共同生效。

額度與倍率的關係

使用者額度（quota）為統一貨幣單位；不同模型/分組透過倍率換算為等值 Token 或次數消耗。

額度計算公式

按量：消耗 ≈ (prompt_tokens × model_ratio + completion_tokens × model_ratio × completion_ratio) × group_ratio × 基準單價；按次：消耗 = model_price × group_ratio。

按量計費（Token）

quota_type = 0；輸入與補全 Token 分別計算倍率，詳見定價文件。

按次計費（固定價格）

quota_type = 1；每次呼叫扣 model_price，與 Token 數無關。

音訊模型（特殊處理）

部分音訊模型依時長或字元計費，model_ratio 含義以模型管理設定為準。

預扣費與後扣費機制

預扣費在請求前凍結估算額度，完成後依實際 Token 多退少補；後扣費在回應結束後一次性扣減。

計費類型對照

模型倍率設定

控制各模型輸入側基準倍率（model_ratio）。顯示價（美元側）≈ model_ratio × 2 / 1M Tokens，詳見 模型管理。

補全倍率設定

分組倍率設定

分組倍率（group_ratio）決定同一模型在不同令牌分組下的計費折扣，與 分組管理 中的 ratio 欄位一致。

{
  "default": 1,
  "vip": 0.8,
  "svip": 0.6,
  "test": 0
}

視覺化倍率設定

「倍率設定」Tab 提供表格化編輯，支援搜尋、排序與批次儲存，無需手寫 JSON。Web 控制台正在串接中。

未設定倍率模型

當渠道同步或手動新增帶來尚未設定 model_ratio 的模型時，行為由 option accept_unset_model_ratio_model 控制：

• 關閉（預設）：拒絕呼叫並在日誌中提示「模型倍率未設定」，避免誤計費。
• 開啟：允許呼叫，依預設倍率 1 或上游回傳值計費；適合快速接入新模型後再統一調價。

建議正式環境保持關閉，在「模型管理」或倍率同步完成設定後再開放。

上游倍率同步

從已串接的上游渠道拉取最新 model_ratio，減少手動維護成本。

1. 呼叫 GET /api/ratio_sync/channels 查看支援同步的渠道清單
2. 選擇渠道後呼叫 POST /api/ratio_sync/fetch 拉取倍率
3. 在視覺化表格或 JSON 中核對差異，確認後儲存
4. 必要時使用 POST /api/setting/rest_model_ratio 還原預設倍率

常見問題

配額計算實例

以下範例展示權重計算過程；最終 quota 數值還取決於網站基準單價與顯示幣別，精確扣費以 使用記錄 為準。

聊天應用設定

控制操練場、聊天頁預設模型與可見性；儲存後影響 `/console/playground` 與示範聊天入口。

聊天整合變數

一鍵匯入 URL 範本中可使用以下預留位置，由前端在開啟第三方應用時取代為目前使用者令牌與網站 API 位址：

• {apiKey} / {token}：目前選取的 EasyAPI 令牌（sk- 開頭）
• {baseUrl} / {openAIUrl}：網站 API 基底位址（NUXT_PUBLIC_API_BASE_URL）
• {openAIBaseUrl}：{baseUrl}/v1，供 OpenAI SDK 相容用戶端使用
• {siteName}：網站名稱，用於部分用戶端顯示標題

聊天應用整合

在令牌管理頁「聊天應用整合」區域，支援一鍵匯入至 ChatGPT Next Web、Lobe Chat、OpenCat 等用戶端。各應用參數組合規則見使用者指南「聊天應用整合」。

• 匯入前需先在令牌頁建立並選取目標令牌
• 匯入連結在新分頁開啟，不會洩漏完整 Key 到目前頁面 URL 歷史（部分用戶端仍會在 hash 中短暫出現）
• 手動串接時使用 Authorization: Bearer {apiKey} 與 {openAIBaseUrl}

完整步驟見 聊天應用整合 使用者指南。

Midjourney 設定

控制 MJ 代理行為、通知與帳號過濾；需先在「渠道管理」設定 Midjourney 類型渠道。

繪圖計費

Midjourney 等繪圖模型通常按次計費（quota_type=1），在模型管理中設定 model_price；分組倍率 group_ratio 同樣生效。

• imagine / upscale / variation 等動作各計一次或依模型設定扣費
• 任務提交後先預扣額度，失敗任務依閘道策略退還
• 使用者可在 `/console/tasks` 查看 mj_id、進度與扣費記錄
• 詳見使用者指南「任務中心」與「定價」中的按次計費說明

相關文件：任務中心、定價。

看板設定 - 基礎設定

控制儀表板預設時間範圍、是否顯示額度/請求量等核心指標卡片。

看板設定 - 圖表設定

設定折線圖/長條圖的資料粒度與顯示項目，便於營運分析尖峰時段與模型分布。

看板設定 - 進階選項

面向 Root/管理員的擴充能力：原始日誌匯出、跨使用者彙總等。

• 資料匯出：支援依時間範圍匯出 CSV（具體欄位以控制台為準）
• 管理員檢視：可查看全站彙總；一般使用者僅看本人資料
• 快取重新整理：修改看板選項後建議清除 CDN/瀏覽器快取以立即生效

模型顯示設定

影響模型廣場 `/models` 與控制台下拉選單的顯示內容。

模型行為設定

全域影響 API 閘道路由、重試與未設定倍率模型的處理方式。

模型同步設定

從渠道自動發現模型名稱並寫入模型表；可與倍率同步搭配使用。

• 在「渠道管理」啟用渠道後，可在模型設定中觸發「從渠道同步模型清單」
• 同步僅更新模型名稱與中繼資料，倍率需單獨設定或透過 `POST /api/ratio_sync/fetch` 拉取
• 模型對應（model_mapping）在渠道級設定，不在本 Tab 重複維護

渠道與模型清單維護見 渠道管理、模型管理。

基礎營運設定

控制新使用者註冊、初始額度與網站營運模式。

儲值設定

與支付 Tab 連動，控制錢包頁 `/console/wallet` 儲值能力。

兌換碼設定

控制使用者自助兌換與管理端批次發碼能力。

• 管理端批次產生見「兌換碼管理」文件（管理 API：`/api/redeem_codes`）
• 使用者兌換入口：`/console/wallet`，介面 `POST /api/user/redeem`

管理端操作見 兌換碼管理。

首頁設定

行銷首頁與到達頁內容，公開介面唯讀回傳。

其他功能設定

OAuth、通知、頁尾等雜項；詳細 OAuth 提供者見「自訂 OAuth」文件（若已啟用）。