點數與計費

API 使用的是和 popnow.ai 網站同一份點數。沒有另外的 API 方案、沒有訂閱，也沒有最低消費：需要時購買點數包即可，註冊時送的免費點數在這裡一樣能用。

• 1 點 = $0.01（基準價）。較大的點數包會加贈點數，等於每點更便宜一些。
• 價格依模型與選項而定：每張圖、影片或音訊的每秒、每次請求，或語音的每千字元。每個模型的頁面都列出價格。
• 回應中的每筆金額都會給兩份：整數點數（credits、maxCredits、availableCredits …）與美元字串（cost、maxCharge、available …）。請以點數欄位為準；美元字串供對帳使用。

一個任務怎麼扣點

1. 保留。 createTask 受理任務時，會先從餘額保留這個任務可能達到的最高價格（estimatedCredits）。保留的點數不會被重複使用，但此時還沒扣除。
2. 結算或釋放。 任務結束時：
   • succeeded → 依實際用量扣點，無條件進位到整數點，且絕不超過保留額。多保留的部分退回餘額。
   • failed 或 expired → 保留的點數全部釋放，不必付費。

任務紀錄會顯示目前狀況：settled 為 false 時，credits 是保留額；settled 變成 true 後，credits 就是最終扣點。

少數模型在原廠以內容為由拒絕請求時也會收費。遇到這種情況，模型頁面會註明；其他情況下失敗都不收費。

先問價格

POST /api/v1/jobs/quote 接收與 createTask 完全相同的請求內容，回傳價格，但不建立任何東西，也不保留點數：

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "alibaba/wan-3.0/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "resolution": "720p", "duration_seconds": 5}}'

{
  "code": 200,
  "msg": "success",
  "data": {
    "quoteId": "q_…",
    "model": "alibaba/wan-3.0/image-to-video",
    "maxCredits": 68,
    "expectedCredits": 68,
    "estimatedCost": "0.68",
    "maxCharge": "0.68",
    "currency": "USD",
    "quantity": "5",
    "unit": "per_second",
    "expiresAt": "2026-10-16T09:25:00Z"
  },
  "request_id": "req_…"
}

maxCredits 是這個請求最多會花多少，也就是會被保留的金額。expectedCredits 是它通常會花多少；只有在最終費用取決於產出（例如影片的實際長度）時兩者才會不同。

為了確保從「把價格顯示給使用者」到「實際執行」之間價格不變，請在五分鐘內把 quoteId 與 expectedCredits（你顯示的那個 maxCredits）一起傳給 createTask。若有任何變動，createTask 會回傳 40901，不保留任何點數；重新報價即可。

餘額

curl "https://api.popnow.ai/api/v1/chat/credit" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

availableCredits 是新任務可用的點數，heldCredits 是為執行中任務保留的點數，totalCredits 是兩者合計（available、held、total 是同樣金額的美元表示）。路徑名稱是歷史因素，和聊天無關。可用餘額不足以保留新任務時，createTask 會回傳 40201。

用量

GET /api/v1/usage?from=2026-10-01&to=2026-10-16 會回傳呼叫它的這把金鑰的任務數、成功與失敗各多少，以及花了多少點數——有總計（totalCredits）、按日與按模型三種維度。日期為 UTC，to 不包含在內，區間最多 92 天。只計算已結算的費用，所以仍有任務未完成時，某天的總額還可能變動。此介面每分鐘限 30 次；要看整個帳戶，請使用 API 控制台的用量頁。

消費上限

每把金鑰都可以在 API 控制台設定每日、每月與累計三種上限，以點數顯示。會超過上限的請求回傳 40202，不保留任何點數。每日上限在 UTC 00:00 重設，每月上限在每月 1 日 UTC 00:00 重設，累計上限永不重設。未設定時，金鑰沒有上限。

購買點數與退款

點數在網站上購買，無法透過 API 購買。點數包與價格請見價格頁；哪些可以退、何時可以退，請見退款政策。