API 余额与退款

Q: 任务冻结金额要自己申请释放吗？

不用。失败和过期任务会自动释放冻结金额。查看任务结算后的 costUsd ，确认最终美元费用。

Q: API 充值付款能退款吗？

想了解 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 或兼容 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}}'

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`	报价后价格发生变化	重新报价，展示新的美元价格