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 或相容 API | API 餘額 |
| API 模型頁的 Playground | API 餘額 |
| 使用 API 金鑰的開發者 MCP | API 餘額 |
| 透過 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}}'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")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 帳單或聯絡客服。

