API 错误码与排障说明

• 请求内容不完整或格式不符合要求。
• 所选模型、功能或设置不支持当前请求。
• 图片、音频或视频素材不符合要求。

1. 先不带附件发送一条简短消息，确认基础调用是否正常。
2. 如果简短消息成功，再逐项添加图片、文件或其他功能。
3. 仍然失败时，确认模型和接入配置，或联系我们。

• 密钥填写错误，或包含空格、换行。
• 密钥已删除、停用，或客户端仍在使用旧配置。
• Claude Code / CC Switch 没有按接入教程连接到 LanoX。

1. 重新核对 API Key、请求地址和当前供应商。
2. Claude Code / CC Switch 使用平台创建的 API Key；请求地址填写 https://api.lanox.ai，不加 /v1，也不要以 / 结尾。
3. 保存后完全退出并重新打开客户端，再发送一条简短消息。

仅当完整提示表明是 LanoX 密钥/接入配置问题时使用；上游鉴权失败请勿改密钥碰运气。

• 个人账户余额不足。
• 企业共享余额不足，或员工分配的预算已用尽。
• 共享密钥受到单独的额度限制。

1. 个人用户检查个人账户余额。
2. 企业员工检查企业余额、分配预算和密钥额度。
3. 补充对应账户余额，或联系企业管理员调整员工预算和密钥额度。

仅当完整提示表明是 LanoX 账户余额、企业预算或密钥额度不足时使用；上游 402/余额类提示不要直接充值。

• 账户、企业、员工或密钥状态异常。
• 当前账户没有所选模型的使用权限。

1. 检查账户及密钥状态。
2. 确认所选模型对当前账户可用。
3. 企业用户先联系管理员；无法解决时请联系我们。

• 接入地址填写错误。
• 所选模型当前不可用。
• 查询任务时使用了不同的账户或密钥，或任务编号已失效。

1. 按照接入教程核对请求地址。
2. 重新选择平台提供的可用模型。
3. 检查任务编号，以及创建任务时使用的账户或密钥。

• 网络或服务响应时间较长。
• 生成任务已经提交，但客户端没有及时收到响应。

1. 稍后重试。
2. 图片 / 视频任务先查看任务状态和已有结果，确认没有成功后再决定是否重新提交。

• 任务已经提交、完成或进入其他状态。
• 在上一个操作尚未结束时重复操作。

1. 先查看已有任务状态。
2. 确认当前任务是否已经产生结果，再决定下一步操作。
3. 不要直接重复提交相同任务。

• 请求条件、模型能力或当前任务状态不满足。
• 完整提示可能明确指出了内容、附件或其他条件问题。

1. 如果提示明确说明内容过大，先减少附件或历史消息。
2. 提示不清楚或调整后仍失败，保留完整提示并联系我们。

• 附件过多或单个文件过大。
• 对话历史过长，包含大量无关内容或工具输出。

1. 减少附件数量，压缩或拆分文件。
2. 删除不必要的历史消息和工具输出。
3. 总结已有对话或新建会话，减少无关上下文。

• 文件扩展名或编码格式不受支持。
• 提交的媒体格式与当前模型能力不匹配。

1. 查看接入教程或页面要求，确认支持的文件与媒体格式。
2. 转换文件格式后重新提交，必要时先用简短文本验证基础调用。

• 输入内容可能违反安全政策。
• 输入内容可能涉及版权限制。
• 参考图片或视频未通过审核。

1. 按照提示调整输入内容。
2. 更换允许使用的参考素材，避免提交受限制的版权内容。
3. 重新提交前先确认素材符合当前模型和平台规则。

• 短时间内调用失败次数过多。
• 同时进行的请求超过允许数量。
• 当前余额较低触发并发限制，或模型服务暂时繁忙。

1. 暂停连续重试。
2. 关闭多余会话，减少同时进行的任务。
3. 检查余额；如果之前一直调用失败，先解决原来的错误。

• 服务处理过程异常。
• 模型或任务处理链路出现临时问题。

1. 保留错误截图和完整提示，稍后重试。
2. 图片 / 视频任务或已开始输出内容的请求，先查看任务和已有结果。
3. 持续出现时请联系我们。

• 上游服务连接异常。
• 模型服务临时不可达。

1. 保留完整错误提示，稍后重试。
2. 如果是生成任务，先查看已有结果，避免重复提交。
3. 持续出现时请联系我们。

• 所选模型暂时不可用。
• 服务繁忙或运行异常。

1. 请联系我们，并提供发生时间、模型名称和完整错误提示。
2. 可短暂等待或选择其他可用模型。
3. 不要连续重试或反复更换密钥。

• 服务响应时间过长。
• 任务已经开始处理，但客户端未及时收到结果。

1. 保留错误提示，稍后重试。
2. 图片 / 视频任务先查看已有结果和任务状态。
3. 持续出现时请联系我们。