API Key 权限与积分计费规则
同一账户余额(固定 $1 = 100 积分)支持创建不限数量的服务端 API Key,可按项目单独设置每日限额、重置时区与模型白名单,并仅在结果交付后按实际用量扣费。
$1 USD = 100 Credits · Min Top-Up $10
服务端 Bearer 密钥与独立限额控制
请在服务端环境变量中配置并通过 Authorization: Bearer cm_live_... 调用接口,切勿将密钥放入前端网页或移动端代码。同一账户下所有密钥共享余额,同时支持独立配置以下权限与额度上限:
| 控制项 | 配置方式 | 生效规则 |
|---|---|---|
| 每日积分上限 | 可选上限 + IANA 时区(如 Asia/Shanghai、UTC) | 统计该时区当日已结算积分 + 运行中预扣额度,超限直接返回 402 key_quota_exceeded。 |
| 总积分上限 | 可选单 Key 累计消费上限 | 限制该密钥的累计消费总额,适合单项目或测试环境预算封顶。 |
| 公开模型白名单 | 所有可用模型,或勾选指定 model ID | 调用未勾选模型时直接返回 403 model_not_allowed(0 扣费)。 |
| 到期时间与一键撤销 | 可选到期时间,或随时停用 / 撤销 | 修改后对新请求立即生效,不影响同账户下的其他密钥。 |
固定积分汇率与三类模型计费方式
平台采用固定充值汇率 $1.00 USD = 100 积分(线上 $10.00 起充即 1,000 积分)。每次请求在受理时锁定当时的公开单价、临时预扣规格上限,并在生成文件就绪后按实际用量结算并退回差额:
失败零扣费保障:任何因内容限制、生成报错或执行超时而进入
failed 状态的任务,预扣积分均 100% 自动退回你的账户余额与 API Key 配额。| 计费方式 | 适用模型 | 提交时预扣上限(HTTP 202) | 完成后最终实扣 |
|---|---|---|---|
| 按实际 Token | gpt-image-2.6-flaregpt-image-2.6-sunburst | 所选画幅/分辨率/画质标准上限 + 输入缓冲 | 按任务实际消耗的 Token 数乘以公开单价结算,未用完的预扣额度立即退回。 |
| 固定按张计费 | seedream-5.5 | 固定单价(1.88 或 3.29 + 0.752 × 参考图数) | 与预扣金额一致,不受画幅比例与提示词长度影响。 |
| 按 0.1 秒时长 | Seedance 2.5 / Flash Seedance 2.0 / Mini | 请求 duration × 对应清晰度每秒单价 | 按实际输出视频时长向上取整至 0.1 秒 结算(最低 4.0 秒 起算且不超过请求秒数),差额立即退回。 |