Menu

積分與計費

任務建立成功會即時扣款,金額以「積分」(整數)計算,依 model × 操作類型(影片生成/圖片生成)決定。

定價查詢

目前沒有對外 API 可以查詢定價表。 積分成本會在任務建立成功後,反映在回應與後續查詢結果的 credits 欄位裡(見〈任務查詢與取件〉);目前唯一已知確定的組合是 YUYU_M1 影片生成,每次固定扣 10 點積分。若你的整合需要「送出前先知道確切扣款金額」,目前只能自行維護對照表或聯繫我們取得最新定價。

帳號的即時餘額(付費餘額/試用額度剩餘量)查詢是帳號後台功能(GET /api/credits/balance,JWT 登入態,非 X-Api-Key),不是對外任務 API 的一部分。

扣款時點

建單請求驗證通過後、任務實際派工前就會完成扣款。扣款失敗(餘額不足)時整個建單請求都會失敗、不會建立任務,不會有「扣了錢但沒有任務」或「有任務但沒扣到錢」的中間狀態。

  • credit_type = paid 的 Key:從帳號的付費積分餘額扣;餘額不足回 402。
  • credit_type = trial 的 Key:從其綁定的試用額度剩餘量(remaining)扣;額度已過期或剩餘額度不足皆回 402。

402 回應內容一律是:

{ "message": "Insufficient credits to complete this charge." }

失敗退款規則

任務轉為失敗(status = 30)或取消(status = 40)時,系統會自動把當初扣的積分全額退回同一個 credit_type/額度來源,不需要你額外請求。

  • 付費:退回帳號付費餘額。
  • 試用:退回原本扣款的那個試用額度的 remaining;但如果退款當下該額度已經過期,則不予退款(試用積分本就是限時使用,過期不追加補償)。

一筆任務只會被判斷/退款一次(即使收到重複通知,已是終態的任務不會重複扣款或退款)。

試用額度(Trial Grant)

試用額度是一組有到期日的積分額度,由平台核發(每筆額度有 amount 總量、remaining 剩餘量、expires_at 到期時間)。同一筆額度同時只能綁定一支未撤銷的試用 Key;額度到期後:

  • 已綁定的試用 Key 驗證會回 401(This trial API key has expired.,見〈驗證方式〉)。
  • 無法再對該額度建立新 Key 或重發 Key。
  • 該額度的 remaining 不再因任務失敗/取消而增加(見上方退款規則)。