---
title: 错误码
---

| 错误码 | 含义 | 推荐解决方法 |
| :--- | :--- | :--- |
| **参数错误** | | |
| 40000 | 请求参数错误 | 检查参数名、类型及格式是否符合要求 |
| 40001 | 请求数据不存在 | 检查资源 ID（如 memory_id）是否正确 |
| 40002 | 必填参数不能为空 | 补充缺失的必填字段 |
| 40003 | 参数为空 | 检查传入的列表或对象是否为空 |
| 40006 | 不支持的类型 | 检查 type 字段取值 |
| 40007 | 不支持的文件类型 | 仅上传允许的格式（.pdf, .docx, .doc, .txt） |
| 40008 | Base64 内容非法 | 检查 Base64 字符串是否包含非法字符 |
| 40009 | Base64 格式非法 | 检查 Base64 编码格式是否正确 |
| 40010 | 用户 ID 过长 | user_id 长度不能超过 100 字符 |
| 40011 | 会话 ID 过长 | conversation_id 长度不能超过 100 字符 |
| 40020 | 项目 ID 非法 | 确认 Project ID 格式正确 |
| **认证与权限错误** | | |
| 40100 | 需要 API Key 认证 | 在 Header 中添加有效 API Key |
| 40130 | 需要 API Key 认证 | 在 Header 中添加有效 API Key |
| 40132 | API Key 无效或已过期 | 检查 API Key 状态或重新生成 |
| **配额与限流错误** | | |
| 40300 | 超过接口调用次数上限 | <a href="/memos_cloud/limit#_4-领取更多额度" target="_blank">获取更多额度</a> |
| 40301 | 超过请求 Token 调用上限 | 减少输入内容或获取更多额度 |
| 40302 | 超过响应 Token 调用上限 | 缩短预期输出或获取更多额度 |
| 40303 | 单次对话长度超过限制 | 缩减单次输入/输出长度 |
| 40304 | 账户总 API 调用次数耗尽 | <a href="/memos_cloud/limit#_4-领取更多额度" target="_blank">获取更多额度</a> |
| 40305 | 输入超过单次 Token 上限 | 缩减输入内容 |
| 40306 | 删除记忆鉴权失败 | 确认是否有权删除该记忆 |
| 40307 | 删除记忆不存在 | 检查 memory_id 是否有效 |
| 40308 | 删除记忆对应的用户不存在 | 检查 user_id 是否正确 |
| **系统与服务错误** | | |
| 50000 | 系统内部异常 | 服务器繁忙或出现异常，请联系支持 |
| 50002 | 操作失败 | 检查操作逻辑或稍后重试 |
| 50004 | 记忆服务暂时不可用 | 稍后重试记忆写入/获取操作 |
| 50005 | 搜索服务暂时不可用 | 稍后重试记忆搜索操作 |
| **知识库与操作错误** | | |
| 50103 | 文件数量超过限制 | 单次上传文件数量不超过20个 |
| 50104 | 单个文件大小超过限制 | 确保单个文件不超过 100MB |
| 50105 | 所有文件总大小超过限制 | 确保单次上传总大小不超过 300MB |
| 50107 | 文件上传格式不符合要求 | 检查并更换文件格式 |
| 50120 | 知识库不存在 | 确认知识库 ID 是否正确 |
| 50123 | 知识库不关联此项目 | 确认知识库是否已授权给当前项目 |
| 50131 | 任务不存在 | 检查 task_id 是否正确（常见于查询处理状态） |
| 50143 | 添加记忆失败 | 算法服务处理异常，请稍后重试 |
| 50144 | 添加消息失败 | 保存聊天历史记录失败 |
| 50145 | 保存反馈并写入记忆失败 | 反馈处理过程中出现异常 |
