常见问题与错误恢复
处理注册邮件、认证状态、调用报错、工具接入和结果未知的问题。
收不到注册验证码
先检查邮箱地址、垃圾邮件和收件规则;等待页面倒计时结束后再决定是否重新发送。不要连续点击或向不同地址反复试发。仍收不到时,请提供邮箱服务商、发送时间和页面提示给客服,不要发送收到的验证码。
邮箱验证完成后还要实名吗
邮箱验证用于完成注册;实名认证用于确认受限业务的使用资格。注册、登录和浏览不要求提前实名。充值、可用 Key 创建和模型调用当前均未开放,即使认证通过也暂不能使用。
手机已完成核验,网页还在等待
手机完成后回到原认证页,点击“手机已完成,查询结果”。如果显示待确认,使用“查看认证结果”,不要重新填写资料发起新申请。刷新页面后可用“刷新认证状态”读取已有记录。
核验未通过、过期、取消或结果暂时无法确认时,按当前页面提示处理;平台不会自动重新申请。具体步骤见办理个人实名认证。
认证完成后没有回到原页面
在成功页点击“返回原操作”。通过受限操作进入时,会保留允许返回的位置;直接打开认证页时,可能没有原操作可返回,可自行进入控制台。
返回后需要你核对内容并主动继续,不会自动充值、创建 Key 或发送模型请求。企业认证与非人脸人工复核请在实名认证页选择对应方式。待审核时查看原申请;需补充时按原因补交,暂不要重复新建。
实名认证通过后要求重新登录
这是正常现象。认证状态变化时,平台会让这个账户已有的登录全部失效,以保护账户安全。重新登录后,控制台按新的认证状态显示。详见实名认证。
游乐场里没有可选的模型
还没有完成实名认证、或认证已失效的账户,游乐场的模型列表是空的;直接发送会提示“未指定模型名称,模型名称不能为空”。完成实名认证并重新登录后再试。目前模型调用尚未开放,所有账户暂时都看不到可用模型。
调用提示“无可用渠道”
用 Key 调用时提示“分组 default 下模型 … 无可用渠道”,通常是因为这把 Key 所属的账户还没有完成实名认证,或认证已失效。完成实名认证、重新登录后再调用;原来的 Key 不用重新创建。
账户已经实名、提示里的分组不是 default 时,通常是模型 ID 写错,或者这个模型当前不可用。从模型广场复制完整的模型 ID 再试。
在工具里配置后用不了
| 现象 | 常见原因 | 处理 |
|---|---|---|
404,提示 Invalid URL | 地址多写了 /v1 或其他路径 | 按工具接入里该工具的地址写法填写 |
| 提示无法解析返回内容,或返回一段网页 | 地址少写了 /v1,请求落到了网站页面上 | 按工具接入里该工具的地址写法填写 |
401、“无效的令牌” | Key 填错、带了空格,或已删除 | 重新复制 Key |
| “未提供令牌” | 工具没有读到 Key,常见于环境变量设置在了另一个终端窗口 | 在启动工具的同一个窗口设置,或写进工具的配置文件 |
| 提示模型不存在 | 模型 ID 与模型广场不一致 | 从模型广场复制完整的模型 ID,注意大小写 |
| Claude Code、Codex 报错,其他工具正常 | 可能是模型不支持它们需要的接口格式 | Claude Code 优先选「端点类型」为 Anthropic 的模型,Codex 选 Response |
已付款但余额没有更新
在钱包查看原充值订单,并刷新一次页面。支付结果返回与余额更新可能有短暂间隔;如果原订单仍未成功或金额不一致,保留订单号、支付时间和支付成功截图,联系客服核查。
请勿重复支付、再次充值补差额,或反复打开旧付款码。客服会核对原订单和到账记录;手机支付成功不能代替平台到账核对。
页面空白、报 500 或一直加载
先记录页面地址、发生时间及报错,再刷新一次。旧标签页在更新后可能需要重新加载;仍有问题时重新从主站入口登录并打开目标页面。请将现象和脱敏截图交给客服,不要连续刷新。
若发生在提交认证、充值或模型请求之后,先核对原申请或订单,不要重复提交。不要为排查问题关闭浏览器安全设置,也不要把密码或会话信息发给他人。
为什么提示请求过大(413)
模型接口的完整请求正文最多 64 MiB(67,108,864 字节),包含上传文件、表单字段及 multipart 开销;具体模型还可能有更低的限制。请缩减文件或输入后再提交,预留表单空间。不要重复发送相同的超限内容。
特别大的请求可能由网站入口直接拒绝,提示样式不一定与接口 JSON 相同。以大小限制和 HTTP 状态为准,不把不同错误页面当成上传成功。
其他常见提示
| 提示 | 下一步 |
|---|---|
| 未登录、登录已失效 | 回主站登录,再打开原页面;不要把密码当 API Key |
| “无效的令牌”“该令牌状态不可用” | 检查是否使用本人可用的 Key;Key 被停用或删除后需要换一把 |
| “该令牌无权访问模型 …” | 这把 Key 设置了可用模型范围,在「API 密钥」页面核对它的设置 |
| “用户额度不足” | 余额不足,按页面提示处理;不要为了重试连续提交 |
| “请先完成实名认证再充值。本次没有生成订单,也没有扣款。” | 先完成实名认证,重新登录后再充值 |
| “请先完成实名认证,再创建 Key。” | 先完成实名认证,重新登录后再创建 |
| “暂时无法确认实名状态,请稍后再试。” | 稍等片刻再试;持续出现请联系客服 |
| “充值暂未开放,本次没有生成订单,也没有扣款。”“创建 Key 暂未开放。” | 这些功能目前对所有账户暂未开放;更换 Key 或重复提交不会解除限制 |
| 调用过于频繁(429) | 按页面或接口提示等待,降低并发,不无限重试 |
| 模型或服务不可用 | 保留原错误和请求线索,先核对结果,再决定是否重新提交 |
先核对,再决定是否重试
超时、连接中断和未收到输出,都不能单独证明请求没有执行。保留时间、模型、响应状态及实际返回的请求或任务编号,先查看原记录;异步任务继续查询同一任务。
普通 SDK 不需要 AIPUT 专用请求头。SDK 的自动重试可能发送多次独立请求,接入前请检查设置。没有明确的接口约定时,相同内容或自行添加编号都不保证复用原结果。
没查到调用日志,是否说明没有调用
不能据此判断。先核对账户、时间范围、日志类型和原任务状态。历史记录可能缺少 IP,尚未进入渠道的请求也可能没有调用日志;异步结果需结合原任务查询。请保留已有时间和请求编号,不要为了补日志重新发送请求。
联系支持与申请信息更正
账户、认证状态、隐私和删除请求可发至 aiput666@163.com。我们会先核对申请人与账户的关系,再处理与请求有关的信息。工作日 9:00—21:00(北京时间)提供客服服务;收到请求后 7 个自然日内首次回复,复杂事项说明进度。
请只提供账户名、发生时间、页面提示和脱敏截图。不要通过普通邮件发送密码、验证码、完整 Key、身份证照片或人脸视频。