Chat 计费

API 使用预付积分。在控制台的 钱包 → 充值积分 中充值，也可以选择订阅，无需订阅也能调用 API。钱包中可查看 API 余额与流水。

价格

价格表 和 GET /v1/chat/catalog 与实际扣费使用同一份后台配置。 聊天按输入和输出 token 的每百万单价计费，语音按每千字符的单价折算，每个模型可单独改价。 请读取目录中的实时价格，不要写死。 聊天标准响应包含 usage，实际积分请在 Usage history 或 Credit transactions 中核对；只有语音响应额外包含 billing。

扣费与退款

• Chat 调用前预留积分，返回后按实际 token 用量结算，多余积分自动退回。
• 输入包括历史消息和人物设定。所有输入（包括缓存命中部分）统一使用输入单价；推理已包含在输出中，不重复收费。
• 合计费用向上保留 8 位小数。上游缺失或返回无效用量时释放预留积分并返回 503。
• 语音合成单独收费，朗读聊天回复也会产生语音费用。
• 上游调用失败时自动退款。
• 余额不足时返回 402 insufficient_balance。
• Chat 同步返回回复，不进入生成任务列表。

钱包流水中，hold 表示预留，refund 表示退回未使用部分，charge 表示从预留中结算的实际消耗。预留额不能与实际消耗相加。语音使用 consume 记录消耗。

文本聊天见 OpenAI 兼容聊天，语音与音色见语音与模型目录。

语音计费

语音按清理后的计费字符数计算，向上保留八位小数，不足千字符也按实际数量计算。Speech Light、Speech Pro 和 Speech Expressive 按 UTF-16 单位计数，与上游一致：普通中文、英文字母计 1，😀 等补充平面字符计 2；Speech Standard 按 Unicode 码点计数。目录的 speechModels[].characterCounting 和响应的 billing.character_counting 标明计数规则。例如每千单位 0.7 积分时，100 个计费单位消耗 0.07 积分，此数字仅为计算示例。合成失败退款；未知或不可用模型在扣费前拒绝。

本地测试余额

Stripe 测试支付增加独立的沙盒余额，不能用于真实 API 调用。本地联调时，管理员可在后台为测试用户的 API 余额充值。402 表示 API 余额不足，与沙盒支付余额无关。正式支付确认后会增加 API 余额。