組織、方案與配額
計費單位與配額口徑
01會員 → 組織 → 密鑰
密鑰不直接掛在會員身上,而是歸屬於組織。組織是計費與配額的單位:
- 同一組織下的全部密鑰共用該組織的每日配額與每分鐘速率上限。
- 一位會員可以持有多個組織,各自訂閱不同方案、各自出帳 —— 用於把不同產品線或客戶分開計費。
- 每位會員僅可持有一個免費組織(即系統自動建立的預設組織); 其後建立的組織必須完成訂閱才會啟用。
要分開計量,就要分開組織
live / test 只是標示用途,兩者吃同一份配額。 若要讓試驗流量不影響生產額度,請另建組織。02各方案上限
| 方案 | 月費 | 每日不重複詞條 | 每分鐘請求 | 每頁上限 | 深層分頁 |
|---|---|---|---|---|---|
| Free | HK$0 | 1,500 | 60 | 50 | ≤ 480 |
| Indie | HK$69 | 24,000 | 300 | 100 | 不限 |
| Studio | HK$198 | 60,000 | 1,200 | 200 | 不限 |
| Label | HK$488 | 135,000 | 2,400 | 200 | 不限 |
| Enterprise | 另議 | 按需求訂製 | 按需求訂製 | 200 | 不限 |
「每頁上限」是單次請求的 limit 上限;「深層分頁」是 offset 的上限。 Free 方案與匿名同級,只能翻約十頁 —— 這是反擷取設計,不是效能限制。
Enterprise 為按需求訂製:專屬配額與速率、AI 增強型語義分類、更高速的基礎設施、 服務水準協議、私有部署與資料授權安排。詳情請來信洽談。
03配額的計算口徑
配額計的是當日取得的不重複詞條數,不是請求次數。同一個詞條在同一日內 無論被取多少次,都只計一次。
這個口徑對正常使用非常寬鬆 —— 填詞是反覆在同一批字詞之間比較的過程, 重複查詢不會累加成本。但它對擷取整個詞庫的行為極為嚴格: 要拿走 N 個詞就必須付出 N 的額度,無法靠重複請求繞過。
每個成功回應都帶 X-Quota-Limit 與 X-Quota-Remaining, 可據此在客戶端自我節流,毋須額外呼叫。
降低 relations_limit 可直接省配額
/word/{text} 預設一次取回每種關係最多 150 個詞,全部計入配額。 介面只需要顯示十數條時,請明確傳 relations_limit=10。04配額週期與計費週期
兩者是不同的週期,經常被混淆:
| 週期 | 起算點 | |
|---|---|---|
| 配額 | 每日 | 每日 00:00 UTC 自動重設 |
| 計費 | 每月 | 該組織首次付款當日起算 |
因此不同組織各有自己的月結日,互不影響;但配額一律在同一個 UTC 日界重設。
05未開通的組織
第二個或之後建立的組織,在完成訂閱之前狀態為未開通:配額為 0, 且無法簽發密鑰 —— 嘗試建立會回應 409。先開通、再簽發, 密鑰始終跟隨組織的方案。
若組織是在開通後才失效(退訂、款項逾期後未清),既有密鑰的呼叫會回應:
402 Payment Required
{"detail": "此組織尚未開通。請於方案頁完成訂閱後再使用,或改用你的免費組織之密鑰。"}402 與 429(配額用盡)、403(scope 不符)是三件不同的事, 處理方式也不同 —— 詳見錯誤處理與重試。
線下付款
銀行轉帳、支票、開立發票或年繳合約等線下成交,毋須經 Stripe —— 請來信提供組織識別碼, 我們會直接為該組織開通,方案與到期日一併設定。 開通後的用法與自助訂閱完全相同。
06升降級與終止
- 變更方案即時生效,差額由 Stripe 按比例計算。既有密鑰毋須重新簽發 —— 層級由組織的訂閱決定,不寫死在密鑰上。
- 終止訂閱於本期結束時生效;其後該組織回落 Free 方案, 密鑰保留但配額與速率相應調整。
- 款項逾期時服務會保留數日供 Stripe 重試扣款(通常是卡片過期), 逾期未清才回落 Free —— 續期失敗不會即時斷服務。
方案與帳單於主控台自助管理; 付款資料由 Stripe 保管與處理,本平台不接觸任何卡片資料。