失敗的生成不扣費

Makernice 不對失敗的 AI 影片或圖片生成扣費。唯一的例外：若完成的輸出因違反政策而被輸出審核攔截，仍會扣費。你可以聯絡客服申請人工審核。建立生成任務時，會從你的預付餘額中凍結報價金額；任務完成時，凍結金額轉為扣款。若任務失敗或逾時，凍結金額全額釋放。生成前被輸入審核拒絕，或在排隊期間取消，同樣全額釋放。

適用於同一個 API 金鑰下的全部 17 個模型。來源：退款政策 §2 · API 文件：價格與計費。最近核對：2026 年 10 月 21 日。

價格截至 2026 年 11 月 4 日（價目表 v12）。

運作方式：報價 → 凍結 → 扣款或釋放

1. 報價。 POST /v1/generations/quote 會依模型、模式、解析度與時長傳回確切金額（影片按秒計價，圖片按張計價）。價格鎖定 12 分鐘（expires_at）。取得報價不收費，也不會凍結任何金額。
2. 凍結。 帶上 quote_id 呼叫 POST /v1/generations，才會凍結該金額；只有在這時才會凍結餘額，並在生成進入最終狀態時結算。生成任務以 status: "queued" 與 billing: "held" 開始。錢仍在你的餘額裡，只是被預留。
3. 任務完成時扣款。 任務完成時，凍結金額會被扣款（billing: "charged"）。檢查輸出期間狀態為 moderating，檔案可以下載後變為 succeeded。
4. 失敗時釋放。 若以 failed 或 canceled 結束，凍結金額全額釋放（billing: "released"）。不需要申請，也不需要提出要求：一切自動完成。

釋放凍結金額不是退款。這筆錢從未離開你的餘額，所以不需要申請退款、沒有等待期，也不必經過支付服務商往返處理。

什麼算是失敗的生成？

依據我們的退款政策（§2）與 API 文件：

品質不算失敗條件：影片或圖片只要已經交付就會扣費，無論你是否滿意。因此每個模型頁都會先列出一段短時長、低解析度試跑的費用。

範例（價目表 v12，2026 年 11 月 4 日）

API 中的金額是以 micro-USD 為單位的字串（1,000,000 = $1.00）。

{
  "id": "gen_…",
  "model": "seedance-2.5",
  "status": "failed",
  "amount": "2592000",
  "billing": "released",
  "outputs": [],
  "error": { "code": "timeout", "message": "…" }
}

在程式碼中處理（Python）

import time, requests

def wait_for(gen_id, headers, api="https://api.makernice.com/v1"):
    while True:
        gen = requests.get(f"{api}/generations/{gen_id}", headers=headers, timeout=15).json()
        if gen["status"] == "succeeded":
            return gen                       # billing == "charged"
        if gen["status"] in ("failed", "canceled"):
            # billing == "released": the full hold is already back in your balance
            raise RuntimeError(f"{gen['status']}: {gen.get('error')}")
        time.sleep(5)                        # queued / generating / moderating / checking

偏好使用 webhook？generation.failed 與 generation.canceled 會在凍結金額釋放後發送；generation.succeeded 會在扣款後發送。請見 Webhooks。

如何避免重複扣款，並為每個 API 金鑰設定花費上限？

• 重試不會重複扣款。 POST /v1/generations 必須帶 Idempotency-Key。以相同的 key、報價與輸入重複發送請求，會傳回原本的那次生成，不會再次扣款。（冪等性）
• 每個金鑰的花費上限。 每個 API 金鑰都可以設定花費上限與到期日。會使金鑰超過上限的請求，會在凍結任何金額之前以 402 key_spend_limit_reached 拒絕。失敗與已取消的生成不計入金鑰的花費。（身分驗證）

開發前，任何 AI 影片 API 都該確認的事

在任何 AI 影片 API 上開發之前，可以先問這幾個問題：

1. 失敗或逾時的執行會扣費、部分扣費，還是不收費？
2. 錢是在提交時扣，還是在執行完成時扣？
3. 被內容審核拒絕要不要付費？生成前與生成後分別如何？
4. 能否取消排隊中的任務？錢會回到你的餘額嗎？
5. 價格是在執行前鎖定，還是事後計算？
6. 重試是否具冪等性，確保網路錯誤不會讓你被扣兩次？

在 Makernice 上，答案是：不收費 · 執行完成時 · 生成前不收費（被攔截的完成輸出會扣費） · 可以，全額釋放 · 以報價鎖定 12 分鐘 · 是。

常見問題

相關內容

• 價格 — 即時單價，最低儲值 $15（最高 $1,000），無訂閱
• AI 影片 API 如何計價（英文） — 價格 = 單價 × 秒數，報價鎖定 12 分鐘
• API 文件：價格與計費 · 查詢狀態 · 取消 · 冪等性
• 影片 API 最佳實務：冪等性、429 與輪詢（英文）
• 退款政策
• 全部 17 個模型