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 资金不能用于网站生成,两份余额不能互转。

本页内容