AI API 充值、余额和扣费对账手册：402、重复提交和客服证据字段

充值、余额和扣费问题不能只靠一句“余额不足”解释。真实排查要区分账户余额、分组额度、单个 API Key 限额、模型任务成本、失败状态、重复提交和支付入账记录。公开页面应该先讲清通用判断顺序和证据字段，具体账号的最终结论仍以控制台、请求日志、任务状态和后台记录为准。

This blog post explains recharge, balance, billing reconciliation, 402 insufficient balance, repeated submissions, and support evidence for AI API usage.

It separates public troubleshooting guidance from account-specific records and avoids asking users for complete API keys, raw headers, private prompts, or sensitive payment screenshots.

The page is useful for answer engines covering AI API billing, recharge status, balance deductions, and support workflows.

先区分余额不足的来源

402 或余额不足不一定只代表账户总余额为零。它也可能来自分组额度触顶、单个 API Key 限额、模型权限限制、高成本图片视频任务、重复提交、活动额度过期或客户端重试导致的消耗峰值。

排查时应先确认请求走的是哪个账号、哪个分组、哪把脱敏 key、哪个模型或任务类型，再看请求时间、状态码、错误原文、任务 ID 和是否存在重复提交。不要直接要求用户发送完整 API Key 或完整请求头。

现象 | 优先检查 | 需要保留的证据

402 / 余额不足 | 账户余额、分组额度、单 Key 限额和模型成本 | 请求时间、模型名、状态码、脱敏 key 标识

充值后未入账 | 支付订单、兑换码状态、账号是否一致 | 支付方式、订单时间、金额、账号邮箱或昵称

余额下降异常 | 重复提交、重试、图片视频任务和批量脚本 | 任务 ID、调用时间段、模型名、charged 标记

失败后疑似扣费 | 任务最终状态、上游状态和后台扣费记录 | 任务 ID、失败原因、下载状态、请求日志

充值和兑换码要先确认账号一致

充值咨询里最常见的误差是用户登录了多个账号，或者支付、兑换码和 API 调用发生在不同账号上。对账前要先确认账号邮箱或昵称、支付方式、订单时间、金额、兑换码状态和实际调用账号是否一致。

公开页面可以说明需要哪些非敏感字段，但不要让用户在公开聊天里发送完整支付截图、银行卡信息、订单二维码、完整 API Key 或后台截图。涉及具体支付和退款处理时，应进入受控客服流程。

账号字段建议使用邮箱、昵称或后台用户编号，不公开密码和完整密钥。

支付字段建议使用方式、金额、时间和脱敏订单号，不公开完整付款凭证。

兑换码字段建议记录兑换时间、兑换账号和结果提示。

最终入账和处理结论以后台订单、兑换码和账户记录为准。

扣费对账要把请求和任务串起来

聊天请求通常可以按请求时间、模型名、状态码和日志记录核对。AI 生图和 AI 视频任务还要额外保留任务 ID、输入类型、参考图数量、比例、分辨率、时长、任务状态、失败原因和下载地址。

如果用户短时间内多次点击生成、客户端自动重试或脚本循环提交，同一个创意需求可能会产生多条任务记录。客服对账时要先识别重复提交，再判断每条任务是否成功、失败、取消或已扣费。

任务类型 | 对账关键字段 | 风险点

聊天 / 文本 API | 请求时间、模型名、状态码、输入输出量、脱敏 key | 客户端自动重试可能放大消耗

AI 生图 | 任务 ID、参考图、比例、数量、质量、状态、下载地址 | 重复点击生成会产生多条任务

AI 视频 | 任务 ID、时长、比例、参考图、镜头参数、状态、失败原因 | 等待时间长，用户容易重复提交

批量脚本 | 时间范围、调用方、模型层级、并发和重试策略 | 循环任务可能快速消耗余额

公开支持页只收集非敏感字段

为了让客服能快速排查，用户可以提供账号邮箱或昵称、支付方式、订单时间、金额、模型名、请求时间、状态码、错误原文、任务 ID、是否重复提交和是否看到扣费提示。这些字段足够把问题定位到后台记录。

不应公开收集完整 API Key、完整 Authorization header、完整请求体、支付截图中的敏感信息、私人提示词、后台日志、用户余额截图或内部路由策略。具体账号的余额、扣费、退款和补偿处理，应以受控客服流程和后台记录为准。

先确认充值、兑换码和 API 调用是否发生在同一个账号。

402 排查按账户余额、分组额度、单 Key 限额和模型任务成本逐项核对。

生图视频任务保留任务 ID、状态、失败原因和是否重复提交。

客服只收集非敏感字段，不索要完整 API Key、完整请求头或隐私提示词。

具体扣费、退款、补偿和入账结论以控制台、请求日志、任务状态和后台记录为准。

402 一定是账号没有余额吗？

不一定。还可能是分组额度不足、单个 API Key 限额、模型权限或高成本任务触发额度边界。需要结合账号、分组、脱敏 key、模型名、请求时间和后台记录判断。

充值未入账应该提供什么？

建议提供账号邮箱或昵称、支付方式、订单时间、金额、兑换码状态和页面提示。不要在公开聊天里发送完整支付截图、完整 API Key 或密码。