積分與計費
建立任務成功時會立即扣除積分。扣多少依模型和任務類型(圖生影片、全能參考影片、文生影片、圖片生成)而定,影片任務還會依影片長度計算,見下方〈影片依長度計費〉。同一個模型在不同任務類型的價格可能不同,例如 YUYU_N1 的圖生影片和全能參考影片是分開計價的。
部分選用功能會額外加收積分,例如 YUYU_M1、YUYU_M6 的提示詞優化 prompt_enhance(見各模型頁的參數表)。加收的部分會和基本費用一起扣除,回應中的 credits 就是合計金額;任務失敗或取消時,也會一起全額退回。
影片依長度計費
影片任務(圖生影片、全能參考影片、文生影片)每 5 秒為一個計費單位,不足 5 秒以 5 秒計。
扣除積分 = 模型單價 × 計費單位數。計費單位數 = duration ÷ 5,無條件進位。沒帶 duration 時,以模型的預設長度計算(例如 YUYU_N1 預設 5 秒)。
duration |
計費單位 | 扣除積分(以單價 500 為例) |
|---|---|---|
| 2–5 秒 | 1 | 500 |
| 6–10 秒 | 2 | 1000 |
| 11–15 秒 | 3 | 1500 |
| 16–20 秒 | 4 | 2000 |
- 目前解析度不影響價格,例如
720p和1080p同價。 - 提示詞優化等加收項目,每個任務只收一次,不會乘上計費單位。
- 圖片生成、人臉年齡偵測等非影片任務,每次固定扣除積分。
查詢價格
各模型、各功能的價格請登入後台〈定價〉頁查看。
剩餘積分可以用 API 金鑰查詢:付費金鑰會回傳帳號的付費餘額,試用金鑰會回傳綁定額度的剩餘量和到期日。詳見〈查詢剩餘積分〉。
什麼時候扣款
請求通過驗證後、任務開始處理前就會扣款。積分不足時,整個請求會失敗,不會建立任務。不會出現「扣了積分卻沒有任務」或「有任務卻沒扣積分」的情況。
- 付費金鑰:從帳號的付費積分扣除,不足時回傳
402。 - 試用金鑰:從綁定的試用額度扣除,額度到期或不足時回傳
402。
402 的 message 固定是 Insufficient credits to complete this charge.。用付費金鑰時會多一個 hint 欄位,提醒付費金鑰只扣付費積分;帳號裡的試用積分要用試用金鑰才能使用:
{
"message": "Insufficient credits to complete this charge.",
"hint": "This is a paid key and only spends paid credits. Top up on the Billing page, or use a trial key to spend trial credits."
}
退款規則
任務失敗(status = 30)或取消(status = 40)時,系統會自動把扣除的積分全額退回原本的來源,不需要另外申請。
- 付費:退回帳號的付費餘額。
- 試用:退回原本的試用額度。如果退款時這筆額度已經到期,則不會退回。
每筆任務只會退款一次,不會重複退款。
試用額度
試用額度是由平台發放、有到期日的積分,每筆都有總量(amount)、剩餘量(remaining)和到期時間(expires_at)。每筆試用額度同時只能有一把使用中的試用金鑰。
額度到期後:
- 綁定的試用金鑰無法再使用,呼叫時會回傳
401(This trial API key has expired.,見〈驗證方式〉)。 - 不能再用這筆額度建立或重新發放金鑰。
- 任務失敗或取消時,積分不會再退回這筆額度。