AIPUT 文档

常见问题与错误恢复

处理注册邮件、认证状态、调用报错、工具接入和结果未知的问题。

更新于

收不到注册验证码

先检查邮箱地址、垃圾邮件和收件规则;等待页面倒计时结束后再决定是否重新发送。不要连续点击或向不同地址反复试发。仍收不到时,请提供邮箱服务商、发送时间和页面提示给客服,不要发送收到的验证码。

邮箱验证完成后还要实名吗

邮箱验证用于完成注册;实名认证用于确认受限业务的使用资格。注册、登录和浏览不要求提前实名。充值、可用 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、身份证照片或人脸视频。