跳到內容

積分與用量

收費服務使用帳號積分結算。金額以毫積分(millicredits)表示,1000 毫積分等於 1 積分。請求中傳入的金額必須是整數;餘額和憑證中的金額可能帶有一位小數(0.1 毫積分)。響應中的 credit_precision 為 4,表示換算成積分後最多 4 位小數。

GET /api/v1/billing/credits/balance
Terminal window
curl 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_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4(推薦)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • 「多送」按 10,000 积分 29.90 元的單價計算,對應字段 bonus_percent;推薦檔帶 recommended: true。兩個字段未設定時不出現。
  • 價格以 price_fen(分)為準,積分數為 total_millicredits(毫積分)。購買的積分長期有效,可重複購買,每次一次性入帳。
  1. 開始前按門檻檢查餘額 :餘額(已扣除欠款)須高於任務的門檻,例如 PDF 文件翻譯為「頁數 × 2 积分」,其他文件按原文字數,最少 2 积分;音視頻與語音為按服務端測得的時長或字符數算出的本次費用(價格見 音視頻與音色 )。使用設有額度的 API Key 時,該 Key 的剩餘額度也須高於門檻。不滿足時返回 402(文件翻譯任務以 quota_exceeded=true 失敗結束,音視頻任務以 error_code=insufficient_credits 結束),不扣費。開始處理不會改變餘額。
  2. 完成後按實際用量扣費 :文件翻譯(含圖片)、富文本分批、文檔操作、音視頻與語音等在完成時按實際用量全額扣除;API Key 的額度只參與開始前的檢查,不會減少已完成任務的扣費。API Key 的已用額度因此超過其額度時,該 Key 不能再發起新任務,直到額度調高。任務失敗或取消不扣費。
  3. 餘額可能為負 :實際費用超過餘額的部分記為欠款,餘額顯示為負數;之後到账的積分先抵扣欠款。餘額為負時新任務無法開始,請充值。

用戶端不提交「實際應扣多少」;結算量由服務端根據交付結果計算。

GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

憑證包含操作 ID、狀態、計費依據、實扣和退款金額。使用 API Key 查詢操作列表時,只返回該 Key 發起的操作。

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

用量介面會傳回帳戶的檔案數、字元數、Token 數量及處理時長。

查詢餘額、任務狀態、用量、結算憑證、結果列表和下載地址都不扣積分。