積分與用量
收費服務使用帳號積分結算。金額以毫積分(millicredits)表示,1000 毫積分等於 1 積分。請求中傳入的金額必須是整數;餘額和憑證中的金額可能帶有一位小數(0.1 毫積分)。響應中的 credit_precision 為 4,表示換算成積分後最多 4 位小數。
GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"關鍵欄位:
| 欄位 | 含義 |
|---|---|
available | 目前可用毫積分,已扣除欠款;欠費時為負數 |
debt | 欠款毫積分:已完成任務的實際費用超出餘額的部分。之後到账的積分(充值、每日贈送、兌換碼、退款等)先抵扣欠款 |
spent | 已結算的累計毫積分 |
expired | 已失效或被撤回的毫積分 |
today_charged | 當日已結算毫積分 |
lots | 目前有效的積分批次及到期時間 |
GET /api/v1/billing/credits/plans公開介面,無需登入,返回在售積分包(purchase_plans,鍵為套餐代碼)。目前在售:
| 套件代碼 | 積分 | 價格 | 多送 |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4(推薦) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- 「多送」按 10,000 积分 29.90 元的單價計算,對應字段
bonus_percent;推薦檔帶recommended: true。兩個字段未設定時不出現。 - 價格以
price_fen(分)為準,積分數為total_millicredits(毫積分)。購買的積分長期有效,可重複購買,每次一次性入帳。
收費生命週期
Section titled “收費生命週期”- 開始前按門檻檢查餘額 :餘額(已扣除欠款)須高於任務的門檻,例如 PDF 文件翻譯為「頁數 × 2 积分」,其他文件按原文字數,最少 2 积分;音視頻與語音為按服務端測得的時長或字符數算出的本次費用(價格見 音視頻與音色 )。使用設有額度的 API Key 時,該 Key 的剩餘額度也須高於門檻。不滿足時返回
402(文件翻譯任務以quota_exceeded=true失敗結束,音視頻任務以error_code=insufficient_credits結束),不扣費。開始處理不會改變餘額。 - 完成後按實際用量扣費 :文件翻譯(含圖片)、富文本分批、文檔操作、音視頻與語音等在完成時按實際用量全額扣除;API Key 的額度只參與開始前的檢查,不會減少已完成任務的扣費。API Key 的已用額度因此超過其額度時,該 Key 不能再發起新任務,直到額度調高。任務失敗或取消不扣費。
- 餘額可能為負 :實際費用超過餘額的部分記為欠款,餘額顯示為負數;之後到账的積分先抵扣欠款。餘額為負時新任務無法開始,請充值。
用戶端不提交「實際應扣多少」;結算量由服務端根據交付結果計算。
查詢操作與憑證
Section titled “查詢操作與憑證”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}憑證包含操作 ID、狀態、計費依據、實扣和退款金額。使用 API Key 查詢操作列表時,只返回該 Key 發起的操作。
GET /api/v1/usage?limit=50GET /api/v1/usage/summary用量介面會傳回帳戶的檔案數、字元數、Token 數量及處理時長。
查詢操作不收費
Section titled “查詢操作不收費”查詢餘額、任務狀態、用量、結算憑證、結果列表和下載地址都不扣積分。