计费与错误处理
区分模型单价、充值额度与最终结算
三个不能混淆的数字
- 价格页的模型费率用 美元 标明每 100 万 Token 的输入/输出单价,或按次模型的基础调用单价。
- 正式充值套餐尚未公布;未来如以 人民币 购买 DGlink 额度,套餐金额也不等于某个模型的调用单价。
- 客户控制台的 实际额度扣减 由 Gateway 根据用量和当时生效的规则结算;预估不等于最终扣费。
图片、视频参数可能影响真实成本,不能把“按次基础价格”理解为所有时长、画质的封顶价。提交后应在客户任务详情中检查状态、消耗额度和结算状态。失败任务可能需要退款或人工核对,请以实际记录为准,不要根据页面预估推算余额。
Key 总额度与每日预算
在 API 密钥 创建或编辑单个 Key 时,可分别限制总额度和每日预算。两者都是消费上限,不会给账户增加余额;仍须满足账户余额、模型范围和平台安全限制。
- 表单使用 Gateway quota 单位,不是人民币或美元;以页面当前显示的积分换算比例为准。
- 每日预算
-1表示不额外限制,0表示阻止新的预扣,正整数表示当日预扣与消费的上限。平台另有限制时取更严格值。 - 第一版固定按 Asia/Shanghai(北京时间)自然日 统计。用量页的查询时区不会改变预算重置时间。
- 进行中的预扣也占预算;完成后转为消费,确认退款后释放对应占用。跨午夜的任务结算仍归入发起预扣当天。
- 改名、停用再启用、同步重试不清零当天使用量。功能升级前未记录的历史日预算不会自动回填;上线首日需结合已有消费记录检查。
用量统计口径
API 用量 按模型、Key 名称、请求 ID、日期和 IANA 时区查询全部留存的已结算记录,分页与汇总使用同一筛选条件。日期包括截止当天。消费分布展示前 10 个模型/Key 名称,以及范围末尾最多 30 天的日统计;同名 Key 在分布中合并。
实时钱包与留存日志不是同一口径:失败、进行中、退款和待核对记录不进入该已结算用量表,应在任务或账单页面查看。这里不提供成功率,也不保存全部文本输入输出正文。
常见问题
| 现象 | 优先检查 |
|---|---|
| 401 | API Key 是否复制完整、是否已同步成功、是否已撤销 |
| 403 或模型不可用 | 模型 ID、客户白名单、渠道和接口类型 |
| 余额不足 | 客户实时余额、测试额度发放状态与用量记录 |
| 429 | 限流或安全策略;按响应提示退避重试 |
| 异步请求返回 409 | 同一幂等键的首次提交仍在处理中;等待 Retry-After 后重试原请求 |
| 任务失败 | 到任务详情查看失败原因和最终结算,不要立即更换幂等键重复提交 |
切勿把 EvoLink 上游 Key、DGlink Gateway 内部签名密钥或客户 API Key 放入网页前端、公开仓库或日志。网页文本试用由 DGlink 服务端代表当前登录用户调用 Gateway,按该用户账户真实结算。