PopNowAPI 文件
API 餘額與帳單
主要內容

API 餘額與退款

獨立 API 美元餘額、模型價格、任務保留金額的釋放,以及 API 付款退款的諮詢入口。

PopNow API 有獨立的美元餘額,與網站點數分開。API 金鑰呼叫、API-key MCP 連線和 Playground 執行都使用 API 美元餘額。透過 OAuth 連線的 MCP 仍使用網站點數。同一模型、同一設定下 API 與網站價格相同;兩份餘額不能互轉,也不能相互抵用。

本頁說明 API 儲值、價格與保留金額釋放。單一任務的保留金額、報價和上限機制,請見 API 計費。

一分鐘看懂 API 餘額

  • 初始為 $0。 執行付費請求前,先在 API 帳單儲值;Playground 測試同樣需要 API 資金。
  • 資金獨立。 網站點數包、加贈點數和獎勵不能支付 API 呼叫;API 資金也不能支付網站生成或 OAuth MCP 呼叫。
  • 執行前先報價。 jobs/quote 回傳美元十進位字串 expectedChargeUsd 和 maxChargeUsd,不啟動任務。
  • 以結算金額為準。 任務的 settled 為 true 時,costUsd 才是最終美元費用。失敗或到期任務會自動釋放保留金額,模型明確收取內容拒絕費用的情況除外。

API 資金從哪裡來

在 API 帳單管理 API 儲值和付款紀錄,使用頁面目前啟用的付款方式。金鑰的建立與管理另在 API 金鑰頁面。

網站點數包的加贈點數、邀請獎勵和其他網站點數發放不會增加 API 餘額。網站點數包的額度、退款期限和有效期限規則不是 API 的儲值條款。

使用哪份餘額

由使用的憑證和入口決定扣哪份餘額:

呼叫或入口使用的餘額
使用 sk-popnow- 金鑰的 REST 或相容 APIAPI 美元餘額
API 模型頁的 PlaygroundAPI 美元餘額
透過 API 金鑰驗證的 MCPAPI 美元餘額
網站生成或透過 OAuth 連線的 MCP網站點數

為一份餘額儲值不會補充另一份。API 請求的餘額不足以支付保留金額時,應儲值 API 餘額,而不是購買網站點數。

一次生成如何計價

每個模型都有自己的價格表,依選項設定:每張圖、每秒影片或音訊、每首歌,或每 1,000 字元的語音。解析度、長度、品質和參考檔案都可能影響價格。

幾個 API 美元價格範例:

模型你得到的USD
Z-Image Turbo一張圖$0.01
Nano Banana 2.1一張圖,1K / 2K / 4K$0.048 / $0.072 / $0.162
Seedream 5.0 Pro一張圖,1K / 2K$0.036 / $0.072
MiniMax H3圖生影片,768p,5 秒$0.185
Suno v6一首歌$0.072
Background Remover一張透明 PNG$0.0048
Image Upscaler一張照片,放大後$0.012

模型頁連結到各模型的參考頁。請依你的設定取得即時報價,保留美元小數精度(最多 9 位小數),不要把 API 費用以整數點數進位。API 頁面裡的 Playground 也使用同一份 API 美元餘額。

在執行任何東西之前,先查出確切金額:

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'
Python
import os, requests

quote = requests.post(
    "https://api.popnow.ai/api/v1/jobs/quote",
    headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
    json={
        "model": "minimax/h3/image-to-video",
        "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
    },
    timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")
JavaScript
const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'minimax/h3/image-to-video',
    input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
  }),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);

任務失敗時會怎樣

任務被受理時,會從 API 餘額中保留它可能達到的最高美元價格。任務結束後:

結果費用
succeeded實際美元費用,絕不超過保留金額;未使用的部分釋放
failed 或 expired不收費,釋放保留金額;模型明確收取內容拒絕費用的情況除外
因內容被拒絕不收費,模型頁面註明拒絕也收費的情況除外
開始前被拒絕(400、402、403、429 …)不收費;沒有任務,也沒有保留金額

釋放任務保留金額會恢復 API 可用資金,並不是把一筆付款退到銀行帳戶或信用卡。查看任務紀錄裡的 costUsd 和 settled,確認最終美元金額。請見 API 計費。

API 付款退款

若有 API 儲值付款或退款問題,請開啟 API 帳單或聯絡客服。請附上相關付款參考編號或任務 ID,但不要提供 API 金鑰。

你可能遇到的錯誤

錯誤碼意思怎麼辦
40201可用 API 美元餘額不足以保留這個任務所需的金額在 API 帳單儲值,或降低解析度、長度或輸出數量
40202任務會超出金鑰的某個消費上限在 API 金鑰頁面提高或移除上限,或等它重設
40901報價後價格發生變動重新報價,顯示新的美元價格

所有錯誤碼都列在錯誤碼頁。

透過 API 呼叫會比在網站上生成更貴嗎?

不會。同一模型、同一設定下價格相同。API 呼叫從 API 餘額扣美元;網站生成和 OAuth MCP 呼叫使用網站點數,兩份餘額獨立。

任務保留金額要自己申請釋放嗎?

不必。失敗和到期任務會自動釋放保留金額,模型明確收取內容拒絕費用的情況除外。查看任務結算後的 costUsd,確認最終美元金額。

API 儲值付款能退款嗎?

想瞭解 API 付款的退款資格或尋求協助,請開啟 API 帳單或聯絡客服。

API 資金沿用網站點數的有效期限規則嗎?

網站點數包和獎勵的有效期限規則不是 API 條款。請查看 API 帳單,或向客服詢問你的 API 資金。

可以用網站點數為 API 儲值嗎?

不可以。請透過 API 帳單儲值 API 餘額。網站點數不能支付 API,API 資金不能用於網站生成,兩份餘額不能互轉。

本頁內容