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 或兼容 API | API 美元余额 |
| API 模型页的 Playground | API 美元余额 |
| 通过 API 密钥认证的 MCP | API 美元余额 |
| 网站生成或通过 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}}'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 余额扣美元;网站生成和 OAuth MCP 调用使用网站积分,两份余额独立。
任务冻结金额要自己申请释放吗?
不用。失败和过期任务会自动释放冻结金额,模型明确收取内容拒绝费用的情况除外。查看任务结算后的 costUsd,确认最终美元金额。
API 充值付款能退款吗?
想了解 API 付款的退款资格或寻求帮助,请打开 API 账单或联系客服。
API 资金沿用网站积分的有效期规则吗?
网站积分包和奖励的有效期规则不是 API 条款。请查看 API 账单,或向客服咨询你的 API 资金。
可以用网站积分给 API 充值吗?
不可以。请通过 API 账单充值 API 余额。网站积分不能支付 API,API 资金不能用于网站生成,两份余额不能互转。

