常见问题

先检查地址、Key、模型 ID 和分组，通常能缩小问题范围。

提示 Key 无效或没有权限

检查是否使用 EasyToken 创建的 Key，是否已过期，以及是否限制了 IP 或模型。Chat 示例使用 Authorization: Bearer YOUR_EASYTOKEN_KEY，不要重复添加 Bearer；Opus 的 Messages 示例使用 x-api-key: YOUR_EASYTOKEN_KEY，不加 Bearer。

提示没有可用渠道

确认模型 ID 与模型广场完全一致，并检查 Key 所选分组是否能访问该模型。渠道维护或上游不可用也可能产生这类错误，不一定是余额问题。

提示余额或额度不足

同时检查账户余额和 Key 的可用额度。Key 设置为无限额度，不代表账户余额无限。系统可能在请求开始前预扣额度，结束后按实际用量结算。

返回 429、5xx 或请求超时

429 通常与请求频率或额度限制有关；5xx 可能来自网关或上游服务。先降低请求频率、检查日志，再对适合重试的请求有限次重试，避免连续无间隔重发。

请求成功，但没有最终回答

检查 Chat 的 finish_reason 或 Messages 的 stop_reason，以及输出上限和返回消息。思考 Token 可能占用了输出预算，导致在最终回答前被截断。HTTP 200 不一定代表任务已经完整完成。

缓存命中为什么没有便宜

缓存命中由上游服务决定，重复发送内容不保证命中。本站需要收到有效的缓存用量，才能按已配置的缓存价格计费。请结合使用日志中的缓存记录和分组价格核对。

价格为什么会变化

模型、所选分组、缓存情况和时间规则可能影响实际价格。请以 模型广场 的当前价格和使用日志中的实际扣费为准。