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

API 餘額與退款

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

PopNow API 有獨立的美元餘額。API 金鑰呼叫、開發者 MCP 和 API 頁面上的 Playground 執行都會使用它。同一模型、同一設定下,API 與 popnow.ai 的價格相同。

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

一分鐘看懂 API 餘額

  • 初始為 $0。 執行付費請求前,先在 API 帳單儲值;Playground 測試同樣需要 API 資金。
  • 資金獨立。 只有在 API 帳單中儲值的 API 資金會進入這份餘額,並且只用於 API。
  • 執行前先報價。 jobs/quote 回傳美元十進位字串 expectedChargeUsd 和 maxChargeUsd,不啟動任務。
  • 以結算金額為準。 任務的 settled 為 true 時,costUsd 才是最終美元費用。失敗或到期任務會自動釋放保留金額。

API 儲值與付款紀錄

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

哪些呼叫使用 API 餘額

呼叫或入口付款來源
使用 sk-popnow- 金鑰的 REST 或相容 APIAPI 餘額
API 模型頁的 PlaygroundAPI 餘額
使用 API 金鑰的開發者 MCPAPI 餘額
透過 API 或開發者 MCP 執行已儲存的配方API 餘額

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 餘額扣費。

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

不必。失敗和到期任務會自動釋放保留金額。查看任務結算後的 costUsd,確認最終美元費用。

API 儲值付款能退款嗎?

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

本頁內容