每个 AiHummer API 错误都带有一个 稳定的机器代码 以……的形式 AIH-<DOMAIN>-<NNNN>导线形状为:
{ "error": { "code": "AIH-AUTH-0001",
"message": "invalid login or password",
"message_key": "err.auth.invalid_credentials",
"details": { } } }
code 是稳定的(从不重复使用或重新编号); message 是一个人类的英语字符串; message_key 是客户用来本地化的 i18n 键; details 是可选的结构化上下文。
计费/计划权限错误(显示 402 “需要升级”)是 不 列在这里 — 见 许可与计费.
常见
每个服务都共有的跨切面错误(请求格式、方法、认证、内部故障)。当有合适的情况时,优先使用特定领域的代码。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-COMMON-0001 |
405 |
方法不被允许 |
err.common.method_not_allowed |
此路由不允许使用该 HTTP 方法。 |
AIH-COMMON-0002 |
400 |
请求体无效 |
err.common.invalid_body |
请求输入格式错误、不完整或无效。 |
AIH-COMMON-0003 |
400 |
必填字段缺失 |
err.common.missing_field |
请求输入格式错误、不完整或无效。 |
AIH-COMMON-0004 |
500 |
内部错误 |
err.common.internal |
意外的内部故障。 |
AIH-COMMON-0005 |
404 |
未找到 |
err.common.not_found |
引用的对象不存在或超出范围。 |
AIH-COMMON-0006 |
403 |
禁止 |
err.common.forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-COMMON-0007 |
501 |
功能未启用 |
err.common.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-COMMON-0008 |
401 |
未经授权 |
err.common.unauthorized |
缺失或无效的凭证。 |
AIH-COMMON-0009 |
400 |
验证失败 |
err.common.validation |
请求输入格式错误、不完整或无效。 |
AIH-COMMON-0010 |
409 |
冲突 |
err.common.conflict |
与当前状态冲突。 |
AIH-COMMON-0011 |
429 |
超出速率限制 |
err.common.rate_limited |
请求过多 / 超过配置的预算。 |
AIH-COMMON-0012 |
502 |
上游错误 |
err.common.upstream |
上游/提供方调用失败。 |
认证
管理员本地认证:登录、会话、密码更改、用户管理、双因素认证。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-AUTH-0001 |
401 |
无效的登录名或密码 |
err.auth.invalid_credentials |
缺失或无效的凭证。 |
AIH-AUTH-0002 |
429 |
尝试次数过多,请稍后再试 |
err.auth.too_many_attempts |
请求过多 / 超过配置的预算。 |
AIH-AUTH-0003 |
401 |
未认证 |
err.auth.not_authenticated |
缺失或无效的凭证。 |
AIH-AUTH-0004 |
501 |
未启用本地身份验证 |
err.auth.local_disabled |
该功能/集成已关闭或未配置。 |
AIH-AUTH-0005 |
403 |
当前密码错误 |
err.auth.wrong_current_password |
该资源属于另一个租户/所有者/会话。 |
AIH-AUTH-0006 |
409 |
你无法删除你自己的账户 |
err.auth.cannot_delete_self |
与当前状态冲突。 |
AIH-AUTH-0007 |
500 |
无法创建会话 |
err.auth.session_failed |
意外的内部故障。 |
AIH-AUTH-0008 |
501 |
未启用两步验证 |
err.auth.twofa_disabled |
该功能/集成已关闭或未配置。 |
AIH-AUTH-0009 |
401 |
挑战已过期 — 请重新登录 |
err.auth.twofa_challenge_expired |
缺失或无效的凭证。 |
AIH-AUTH-0010 |
401 |
无效代码 |
err.auth.twofa_invalid_code |
缺失或无效的凭证。 |
AIH-AUTH-0011 |
401 |
无效的恢复码 |
err.auth.twofa_invalid_recovery |
缺失或无效的凭证。 |
AIH-AUTH-0012 |
401 |
二次验证失败 |
err.auth.twofa_verify_failed |
缺失或无效的凭证。 |
AIH-AUTH-0013 |
400 |
未注册匹配的第二因素 |
err.auth.twofa_not_enrolled |
请求输入格式错误、不完整或无效。 |
AIH-AUTH-0014 |
400 |
无效或已过期的重置令牌 |
err.auth.reset_token_invalid |
请求输入格式错误、不完整或无效。 |
AIH-AUTH-0015 |
403 |
请先设置您自己的密码 |
err.auth.password_change_required |
— |
AIH-AUTH-0016 |
400 |
新密码必须与当前密码不同 |
err.auth.password_unchanged |
— |
代理
AI 员工(代理)CRUD、版本、克隆以及每个代理的系统提示配置文件。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-AGENT-0001 |
501 |
代理未启用 |
err.agent.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-AGENT-0002 |
404 |
未找到代理 |
err.agent.not_found |
引用的对象不存在或超出范围。 |
AIH-AGENT-0003 |
403 |
不是你的代理 |
err.agent.forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-AGENT-0004 |
501 |
未启用代理配置文件 |
err.agent.profile_not_enabled |
该功能/集成已关闭或未配置。 |
AIH-AGENT-0005 |
404 |
未找到共享部分 |
err.agent.section_not_found |
引用的对象不存在或超出范围。 |
AIH-AGENT-0006 |
403 |
不是你共享的部分 |
err.agent.section_forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-AGENT-0007 |
400 |
未知的部分类型 |
err.agent.unknown_section_kind |
请求输入格式错误、不完整或无效。 |
AIH-AGENT-0008 |
403 |
该代理不允许使用此工具 |
err.agent.tool_not_permitted |
该资源属于另一个租户/所有者/会话。 |
AIH-AGENT-0009 |
403 |
子代理深度限制已到 |
err.agent.subagent_depth_exceeded |
该资源属于另一个租户/所有者/会话。 |
AIH-AGENT-0010 |
403 |
此处无法交接 |
err.agent.handoff_unavailable |
该资源属于另一个租户/所有者/会话。 |
AIH-AGENT-0011 |
500 |
工具调用失败 |
err.agent.tool_failed |
意外的内部故障。 |
AIH-AGENT-0012 |
400 |
交接需要“代理”和“任务” |
err.agent.handoff_invalid_args |
请求输入格式错误、不完整或无效。 |
AIH-AGENT-0013 |
404 |
没有那个名字的代理 |
err.agent.handoff_target_not_found |
引用的对象不存在或超出范围。 |
AIH-AGENT-0014 |
400 |
未提供任务 |
err.agent.subagent_no_tasks |
请求输入格式错误、不完整或无效。 |
AIH-AGENT-0015 |
403 |
工具在此托管 AiHummer Cloud 实例上不可用 |
err.agent.tool_cloud_restricted |
— |
AIH-AGENT-0016 |
409 |
打开卡片后,此 AI 员工已在其他地方被修改。请重新打开卡片后再次保存。 |
err.agent.revision_conflict |
— |
AIH-AGENT-0017 |
400 |
没有已启用的模型提供方提供此模型。请从列表中选择,或在“模型”页面启用其提供方。 |
err.agent.model_not_served |
— |
AIH-AGENT-0018 |
400 |
访问规则指定了此工作区中不存在的人员或智能体。 |
err.agent.interaction_unknown_grant |
— |
AIH-AGENT-0019 |
400 |
子智能体的禁令指定了此实例上不存在的工具。 |
err.agent.interaction_unknown_tool |
— |
AIH-AGENT-0020 |
400 |
所选提供方已停用、已删除或不提供此模型。请选择其他提供方或“任意提供方”。 |
err.agent.model_provider_invalid |
— |
AIH-AGENT-0021 |
400 |
一个代理最多可有 8 个自己的备用模型。请先移除一个再添加。 |
err.agent.too_many_spares |
— |
API密钥
用于编程网关访问的 API 密钥:密钥子系统未配置。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-APIKEY-0001 |
501 |
未配置 API 密钥 |
err.apikey.not_configured |
该功能/集成已关闭或未配置。 |
批准
人工干预审批队列:审批功能已关闭。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-APPROVAL-0001 |
501 |
未启用审批 |
err.approval.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-APPROVAL-0002 |
409 |
请求已过期:没有人及时作出决定,因此该调用已被拒绝。如果仍然需要,代理会再次请求。 |
err.approval.expired |
— |
人工制品
对话产物(文档 + 可运行代码):代码执行关闭、缺少产物/版本、类型错误或运行器输出错误。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-ARTIFACT-0001 |
501 |
未启用代码执行 |
err.artifact.exec_disabled |
该功能/集成已关闭或未配置。 |
AIH-ARTIFACT-0002 |
404 |
未找到工件 |
err.artifact.not_found |
引用的对象不存在或超出范围。 |
AIH-ARTIFACT-0003 |
404 |
未找到工件版本 |
err.artifact.version_not_found |
引用的对象不存在或超出范围。 |
AIH-ARTIFACT-0004 |
400 |
工件不是代码 |
err.artifact.not_code |
请求输入格式错误、不完整或无效。 |
AIH-ARTIFACT-0005 |
500 |
运行器输出错误 |
err.artifact.bad_runner_output |
意外的内部故障。 |
AIH-ARTIFACT-0006 |
400 |
类型必须是文档或代码 |
err.artifact.invalid_kind |
请求输入格式错误、不完整或无效。 |
备份
来自管理界面的数据库备份。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-BACKUP-0001 |
501 |
数据库 URL 未为备份配置 |
err.backup.not_configured |
该功能/集成已关闭或未配置。 |
AIH-BACKUP-0002 |
500 |
备份失败 |
err.backup.failed |
意外的内部故障。 |
批次
批量请求处理。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-BATCH-0001 |
501 |
未启用批处理 |
err.batch.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-BATCH-0002 |
404 |
未找到批次 |
err.batch.not_found |
引用的对象不存在或超出范围。 |
预算
使用计量和模型支出预算。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-BUDGET-0001 |
501 |
未启用使用量计量 |
err.budget.usage_not_enabled |
该功能/集成已关闭或未配置。 |
AIH-BUDGET-0002 |
501 |
未启用预算 |
err.budget.not_enabled |
该功能/集成已关闭或未配置。 |
自带密钥
自带密钥:租户提供的模型供应商密钥。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-BYOK-0001 |
501 |
未配置 BYOK |
err.byok.not_configured |
该功能/集成已关闭或未配置。 |
改变
变更记录和变更审批工作流程。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-CHANGE-0001 |
404 |
未找到更改 |
err.change.not_found |
引用的对象不存在或超出范围。 |
AIH-CHANGE-0002 |
403 |
不允许自我审批:需要不同的审批人 |
err.change.self_approval_forbidden |
该资源属于另一个租户/所有者/会话。 |
聊天
OpenAI兼容的聊天完成端点。线形保持OpenAI兼容,同时添加了一个稳定的代码。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-CHAT-0001 |
501 |
OpenAI 兼容端点已禁用 |
err.chat.disabled |
该功能/集成已关闭或未配置。 |
AIH-CHAT-0002 |
401 |
无效的 API 密钥 |
err.chat.invalid_key |
缺失或无效的凭证。 |
AIH-CHAT-0003 |
400 |
无效的聊天请求 |
err.chat.invalid_request |
请求输入格式错误、不完整或无效。 |
AIH-CHAT-0004 |
429 |
费率或预算限制已超出 |
err.chat.rate_limited |
请求过多 / 超过配置的预算。 |
AIH-CHAT-0005 |
502 |
聊天轮次失败 |
err.chat.turn_failed |
上游/提供方调用失败。 |
AIH-CHAT-0006 |
500 |
聊天完成失败 |
err.chat.internal |
意外的内部故障。 |
AIH-CHAT-0007 |
503 |
尚未配置 AI 模型提供程序 - 在模型部分添加一个 |
err.chat.no_llm_provider |
— |
连接
集成 OAuth 连接:连接票据、授权步骤和令牌交换。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-CONNECTION-0001 |
400 |
无效或已过期的连接票 |
err.connection.ticket_invalid |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0002 |
400 |
插件未声明 OAuth 流程 |
err.connection.no_oauth_flow |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0003 |
400 |
此插件未配置 OAuth 客户端 |
err.connection.oauth_client_not_configured |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0004 |
400 |
授权被拒 |
err.connection.auth_denied |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0005 |
400 |
缺少代码或状态 |
err.connection.missing_code_or_state |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0006 |
400 |
无效或已过期的状态 |
err.connection.state_invalid |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0007 |
400 |
插件 OAuth 配置不可用 |
err.connection.oauth_config_unavailable |
请求输入格式错误、不完整或无效。 |
AIH-CONNECTION-0008 |
502 |
令牌交换失败 |
err.connection.token_exchange_failed |
上游/提供方调用失败。 |
AIH-CONNECTION-0009 |
500 |
无法存储令牌 |
err.connection.store_token_failed |
意外的内部故障。 |
凭证
每用户凭证库操作。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-CREDENTIAL-0001 |
501 |
未启用凭据库 |
err.credential.vault_not_enabled |
该功能/集成已关闭或未配置。 |
AIH-CREDENTIAL-0002 |
400 |
凭证操作失败 |
err.credential.vault_error |
请求输入格式错误、不完整或无效。 |
设备
该设备桥接到设备上的配套应用程序。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-DEVICE-0001 |
503 |
设备服务不可用 |
err.device.service_unavailable |
一个依赖的服务暂时不可用。 |
事件
用于管理员 UI 和客户端的服务器事件流 (SSE)。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-EVENTS-0001 |
500 |
不支持流式传输 |
err.events.streaming_unsupported |
意外的内部故障。 |
事实
关于用户的长期记忆事实。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-FACT-0001 |
404 |
未找到事实 |
err.fact.not_found |
引用的对象不存在或超出范围。 |
AIH-FACT-0002 |
403 |
不是用户事实 |
err.fact.not_user_fact |
该资源属于另一个租户/所有者/会话。 |
AIH-FACT-0003 |
409 |
该事实的状态不允许此操作:只能批准候选事实,只能拒绝候选事实或已批准的事实。请刷新列表。 |
err.fact.status_conflict |
— |
图表
代理图:声明式多代理编排。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-GRAPH-0001 |
501 |
未启用代理图 |
err.graph.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-GRAPH-0002 |
404 |
未找到图表 |
err.graph.not_found |
引用的对象不存在或超出范围。 |
AIH-GRAPH-0003 |
403 |
不是你的图表 |
err.graph.forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-GRAPH-0004 |
501 |
在此部署中无法使用图形执行 |
err.graph.exec_unavailable |
该功能/集成已关闭或未配置。 |
护栏
代理的内容/行为边界规则。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-GUARDRAIL-0001 |
501 |
未配置护栏 |
err.guardrail.not_configured |
该功能/集成已关闭或未配置。 |
入站
通用入站 webhook/摄取端点:通道→网关消息摄取。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-INBOUND-0001 |
401 |
未经授权 |
err.inbound.unauthorized |
缺失或无效的凭证。 |
AIH-INBOUND-0002 |
400 |
无效的入站负载 |
err.inbound.invalid_payload |
请求输入格式错误、不完整或无效。 |
AIH-INBOUND-0003 |
500 |
入站调度失败 |
err.inbound.dispatch_failed |
意外的内部故障。 |
AIH-INBOUND-0004 |
503 |
服务器繁忙:消息已保存,但尚未处理。请使用相同的消息 ID 重试。 |
err.inbound.server_busy |
— |
爱枕
管理员访问 IP 允许列表。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-IPALLOW-0001 |
501 |
未配置 IP 白名单 |
err.ipallow.not_configured |
该功能/集成已关闭或未配置。 |
千字节
知识库连接器:RAG 功能关闭、存储的连接器配置损坏,或上传的归档文件有问题。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-KB-0001 |
501 |
未启用知识库 |
err.kb.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-KB-0002 |
500 |
存储的配置损坏 |
err.kb.config_corrupt |
意外的内部故障。 |
AIH-KB-0003 |
400 |
无效的知识档案 |
err.kb.invalid_archive |
请求输入格式错误、不完整或无效。 |
AIH-KB-0004 |
413 |
附件超出允许的最大值大小 |
err.session.attachment_too_large |
— |
AIH-KB-0005 |
413 |
附件超出允许的最大值大小 |
err.session.attachment_too_large |
— |
许可证
实例许可:应用已签署的许可证。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-LICENSE-0001 |
501 |
未启用许可 |
err.license.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-LICENSE-0002 |
400 |
无效的许可证 |
err.license.invalid |
请求输入格式错误、不完整或无效。 |
AIH-LICENSE-0003 |
409 |
此许可证需要已签名的安装实例授权。请向供应商索取最新的许可证包。 |
err.license.grant_required |
— |
大型语言模型
在产品内“连接 Codex(ChatGPT 订阅)”设备授权流程中。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-LLM-0001 |
501 |
Codex 连接不可用:秘密库 (AIHUMMER_MASTER_KEY) 未配置 |
err.llm.codex_connect_disabled |
该功能/集成已关闭或未配置。 |
AIH-LLM-0002 |
502 |
无法启动 Codex 设备授权流程 |
err.llm.codex_connect_start_failed |
上游/提供方调用失败。 |
AIH-LLM-0003 |
500 |
无法清除已存储的 Codex 连接 |
err.llm.codex_disconnect_failed |
意外的内部故障。 |
AIH-LLM-0004 |
501 |
未配置模型提供程序 |
err.llm.providers_not_configured |
— |
AIH-LLM-0005 |
404 |
未找到模型提供程序 |
err.llm.provider_not_found |
— |
AIH-LLM-0006 |
400 |
模型提供程序配置无效 |
err.llm.provider_invalid |
— |
AIH-LLM-0007 |
502 |
提供商测试失败 |
err.llm.provider_test_failed |
— |
AIH-LLM-0008 |
501 |
提供商测试不可用 |
err.llm.provider_test_unavailable |
— |
AIH-LLM-0009 |
502 |
OpenAI 无法从服务器区域使用 - 需要在允许区域中的出站代理。联系支持人员。 |
err.llm.region_blocked |
— |
AIH-LLM-0010 |
501 |
此实例不支持连接 Claude 订阅 |
err.llm.claude_connect_disabled |
— |
AIH-LLM-0011 |
502 |
无法连接 Claude 订阅 |
err.llm.claude_connect_failed |
— |
AIH-LLM-0012 |
500 |
无法清除存储的 Claude 订阅连接 |
err.llm.claude_disconnect_failed |
— |
AIH-LLM-0013 |
400 |
此账户不提供该模型:请从账户的模型列表中选择。 |
err.llm.provider_model_not_in_catalog |
— |
市场
插件市场安装路径:在异步部署之前,将根据目录验证 slug。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-MARKETPLACE-0001 |
404 |
未知模块:不在目录中 |
err.marketplace.unknown_module |
引用的对象不存在或超出范围。 |
媒体
媒体 blob 获取/流端点:签名令牌媒体访问。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-MEDIA-0001 |
404 |
未找到媒体 |
err.media.not_found |
引用的对象不存在或超出范围。 |
AIH-MEDIA-0002 |
403 |
无效或已过期的媒体令牌 |
err.media.token_invalid |
该资源属于另一个租户/所有者/会话。 |
AIH-MEDIA-0003 |
503 |
未配置视频理解 |
err.media.video_not_configured |
一个依赖的服务暂时不可用。 |
记忆
长期记忆(爱因斯坦)管理界面:内存后端未连接。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-MEMORY-0001 |
501 |
内存未配置 |
err.memory.not_configured |
该功能/集成已关闭或未配置。 |
AIH-MEMORY-0002 |
404 |
未找到该矛盾,请刷新列表。 |
err.memory.contradiction_not_found |
— |
AIH-MEMORY-0003 |
409 |
该矛盾已被解决或重新打开,请刷新列表。 |
err.memory.contradiction_conflict |
— |
AIH-MEMORY-0004 |
409 |
记忆检查已在进行中。请等待其完成。 |
err.memory.quality_busy |
— |
AIH-MEMORY-0005 |
404 |
该修复已不存在,请刷新页面。 |
err.memory.quality_fix_not_found |
— |
AIH-MEMORY-0006 |
409 |
无法撤销该修复:它已被撤销,或事实在其后已更改。 |
err.memory.quality_fix_conflict |
— |
模型访问
模型访问规则(哪些模型对哪些用户/代理可用)。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-MODELACCESS-0001 |
501 |
未配置模型访问 |
err.modelaccess.not_configured |
该功能/集成已关闭或未配置。 |
模块
插件/模块市场控制界面:功能关闭、缺少来源/安装、所有权问题或加载的侧载文件格式错误。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-MODULE-0001 |
501 |
市场未启用 |
err.module.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-MODULE-0002 |
404 |
未找到源 |
err.module.source_not_found |
引用的对象不存在或超出范围。 |
AIH-MODULE-0003 |
404 |
未找到安装 |
err.module.installation_not_found |
引用的对象不存在或超出范围。 |
AIH-MODULE-0004 |
403 |
不是你的安装 |
err.module.installation_forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-MODULE-0005 |
501 |
插件上传已禁用(没有 Blob 存储) |
err.module.upload_disabled |
该功能/集成已关闭或未配置。 |
AIH-MODULE-0006 |
400 |
无效的插件上传包 |
err.module.invalid_bundle |
请求输入格式错误、不完整或无效。 |
AIH-MODULE-0007 |
403 |
官方目录源不能是禁用或删除 |
err.module.source_protected |
— |
AIH-MODULE-0008 |
403 |
此模块是产品的内置部分,无法删除或停止 |
err.module.builtin_protected |
— |
AIH-MODULE-0009 |
409 |
此插件请求您在安装之前需要审核和批准的权限 |
err.module.consent_required |
— |
AIH-MODULE-0010 |
400 |
该插件请求访问它未在其功能清单中声明的权限 |
err.module.capability_violation |
— |
AIH-MODULE-0011 |
410 |
此模块已停用:其功能已内置于产品核心,因此无法再安装 |
err.module.retired |
— |
配对
设备配对(二维码兑换)、设备会话验证、绑定状态。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-PAIRING-0001 |
400 |
需要配对码 |
err.pairing.code_required |
请求输入格式错误、不完整或无效。 |
AIH-PAIRING-0002 |
401 |
无效或已过期的配对码 |
err.pairing.invalid_code |
缺失或无效的凭证。 |
AIH-PAIRING-0003 |
401 |
不良入站秘密 |
err.pairing.bad_inbound_secret |
缺失或无效的凭证。 |
AIH-PAIRING-0004 |
400 |
必填字段缺失 |
err.pairing.field_required |
请求输入格式错误、不完整或无效。 |
AIH-PAIRING-0005 |
401 |
无效或已过期的会话 |
err.pairing.session_invalid |
缺失或无效的凭证。 |
AIH-PAIRING-0006 |
400 |
需要令牌 |
err.pairing.token_required |
请求输入格式错误、不完整或无效。 |
AIH-PAIRING-0007 |
401 |
配对码已过期 - 生成新的二维码并重新扫描。 |
err.pairing.code_expired |
— |
AIH-PAIRING-0008 |
401 |
此配对码已被使用 - 生成新的二维码。 |
err.pairing.code_used |
— |
AIH-PAIRING-0009 |
403 |
此设备绑定已停用 - 在 AiHummer 管理 UI 中重新启用它,然后重试。 |
err.pairing.binding_inactive |
— |
操场
提示/模型游乐场。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-PLAYGROUND-0001 |
501 |
未启用 Playground |
err.playground.not_enabled |
该功能/集成已关闭或未配置。 |
提示
提示/模板库。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-PROMPT-0001 |
501 |
未配置提示库 |
err.prompt.not_configured |
该功能/集成已关闭或未配置。 |
AIH-PROMPT-0002 |
404 |
未找到模板 |
err.prompt.template_not_found |
引用的对象不存在或超出范围。 |
推
通过供应商推送中继的移动推送通知(实例不持有供应商凭证)。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-PUSH-0001 |
503 |
推送中继不可用(供应商推送服务不可用 / 实例未注册) |
err.push.relay_unavailable |
一个依赖的服务暂时不可用。 |
AIH-PUSH-0002 |
502 |
推送中继传递失败 |
err.push.relay_failed |
上游/提供方调用失败。 |
再生
响应再生(再生)。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-REGEN-0001 |
501 |
未启用再生 |
err.regen.not_enabled |
该功能/集成已关闭或未配置。 |
安全断言标记语言
SAML 单点登录
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SAML-0001 |
501 |
SAML不可用 |
err.saml.not_available |
该功能/集成已关闭或未配置。 |
AIH-SAML-0002 |
400 |
断言缺少主语 |
err.saml.assertion_invalid |
请求输入格式错误、不完整或无效。 |
时间表
定时/延迟消息发送。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SCHEDULE-0001 |
404 |
未找到时间表 |
err.schedule.not_found |
引用的对象不存在或超出范围。 |
AIH-SCHEDULE-0002 |
409 |
计划暂时无法启用:部分条件尚未满足 |
err.schedule.blocked |
— |
AIH-SCHEDULE-0003 |
409 |
阻止需通过“解除阻止”操作移除,而不是编辑数据 |
err.schedule.unblock_required |
— |
AIH-SCHEDULE-0004 |
400 |
请选择接收方:该计划有投递渠道,但未指定聊天 |
err.schedule.recipient_required |
— |
AIH-SCHEDULE-0006 |
409 |
计划任务中的服务器命令已关闭。所有者或管理员可以在「系统和设置 → 计划任务」中开启。 |
err.schedule.commands_off |
— |
AIH-SCHEDULE-0007 |
409 |
这条确切的命令不在允许的命令中。所有者或管理员可以在「系统和设置 → 计划任务」中添加。 |
err.schedule.command_not_allowed |
— |
AIH-SCHEDULE-0008 |
400 |
此聊天无法接收计划消息:网页聊天和 API 会话没有外发投递。请选择即时通讯聊天。 |
err.schedule.recipient_undeliverable |
— |
系统跨域身份管理
SCIM 用户配置。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SCIM-0001 |
501 |
未启用 SCIM |
err.scim.not_enabled |
该功能/集成已关闭或未配置。 |
秘密
每租户秘密库:主密钥不存在,或指定的秘密不存在。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SECRET-0001 |
501 |
未配置秘密 |
err.secret.not_configured |
该功能/集成已关闭或未配置。 |
AIH-SECRET-0002 |
404 |
未找到秘密 |
err.secret.not_found |
引用的对象不存在或超出范围。 |
情感
对话分析:情绪和质量。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SENTIMENT-0001 |
501 |
未启用会话分析 |
err.sentiment.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-SENTIMENT-0002 |
404 |
尚未分析 |
err.sentiment.not_analyzed |
引用的对象不存在或超出范围。 |
AIH-SENTIMENT-0003 |
422 |
无法分析对话 |
err.sentiment.unprocessable |
请求有效,但内容无法处理。 |
会话
会话/消息管理界面:功能关闭,或会话/消息不是调用者的。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SESSION-0001 |
501 |
未启用对话 |
err.session.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-SESSION-0002 |
403 |
不是你的谈话 |
err.session.conversation_forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-SESSION-0003 |
403 |
不是你的消息 |
err.session.message_forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-SESSION-0004 |
413 |
附件超出允许的最大值大小 |
err.session.attachment_too_large |
— |
AIH-SESSION-0005 |
404 |
找不到附件 |
err.session.attachment_not_found |
— |
AIH-SESSION-0006 |
502 |
消息未送达渠道 |
err.session.operator_reply_undelivered |
— |
AIH-SESSION-0007 |
409 |
此消息不是应用聊天中的智能体回复 |
err.session.not_app_reply |
— |
AIH-SESSION-0008 |
503 |
此实例不支持向应用投递 |
err.session.app_delivery_unavailable |
— |
AIH-SESSION-0009 |
503 |
「AiHummer 应用」模块未运行 — 请在「插件」页面启动它,然后重新投递 |
err.session.app_module_not_running |
— |
技能
代理技能:图书馆和所有权。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SKILL-0001 |
501 |
技能未启用 |
err.skill.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-SKILL-0002 |
404 |
未找到技能 |
err.skill.not_found |
引用的对象不存在或超出范围。 |
AIH-SKILL-0003 |
403 |
不是你的技能 |
err.skill.forbidden |
该资源属于另一个租户/所有者/会话。 |
技能提升
技能优化器:技能提升建议。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SKILLOPT-0001 |
501 |
未启用技能优化器 |
err.skillopt.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-SKILLOPT-0002 |
404 |
未找到提案 |
err.skillopt.proposal_not_found |
引用的对象不存在或超出范围。 |
AIH-SKILLOPT-0003 |
403 |
不是你的提议 |
err.skillopt.proposal_forbidden |
该资源属于另一个租户/所有者/会话。 |
系统
主机系统操作:日志和自我更新。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SYSTEM-0001 |
501 |
此主机上不可用日志 |
err.system.logs_unavailable |
该功能/集成已关闭或未配置。 |
AIH-SYSTEM-0002 |
501 |
未配置自我更新;请运行 sudo aihummer update 在主机上 |
err.system.update_not_configured |
该功能/集成已关闭或未配置。 |
AIH-SYSTEM-0003 |
501 |
此主机不支持安装边车服务,请在主机上使用 --sidecar <名称> 运行已签名的安装程序。 |
err.system.sidecar_not_configured |
— |
AIH-SYSTEM-0004 |
501 |
此服务器无法从面板重启自己。保存的值将在服务器下次重启时生效 — 请让负责这台服务器的人重启,或者在你的主机服务商的控制面板里重启它。 |
err.system.restart_not_configured |
— |
用户
工作区用户和角色管理。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-USER-0001 |
409 |
你无法更改自己的角色 |
err.user.cannot_change_own_roles |
与当前状态冲突。 |
AIH-USER-0002 |
409 |
无法移除最后一个所有者 |
err.user.cannot_remove_last_owner |
与当前状态冲突。 |
声音
语音回合端点 (/v1/voice/turn):SIP 桥 → 网关音频转发界面。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-VOICE-0001 |
502 |
无法解析对话 |
err.voice.resolve_failed |
上游/提供方调用失败。 |
AIH-VOICE-0002 |
502 |
语音切换失败 |
err.voice.turn_failed |
上游/提供方调用失败。 |
WEBCONN
Admin Sessions 后端:浏览器会话和 SSE 聊天。SSE 流中的错误事件不属于此错误格式。
| 代码 |
HTTP |
含义 |
i18n 键 |
常见原因 |
AIH-WEBCONN-0001 |
403 |
对话不属于你的会话 |
err.webconn.forbidden |
该资源属于另一个租户、所有者或会话。 |
AIH-WEBCONN-0002 |
500 |
不支持流式传输 |
err.webconn.streaming_unsupported |
发生了意外故障。 |
AIH-WEBCONN-0003 |
409 |
此 AI 员工的应用设置已损坏。所有者可以在代理资料中修复:「上下文与行为」→「AiHummer 应用」。 |
err.webconn.app_policy_invalid |
— |
AIH-WEBCONN-0004 |
404 |
未找到 |
err.common.not_found |
— |
网络钩子
实例事件的出站 Webhook。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-WEBHOOK-0001 |
501 |
未启用 Webhook |
err.webhook.not_enabled |
该功能/集成已关闭或未配置。 |
AIH-WEBHOOK-0002 |
404 |
未找到 Webhook |
err.webhook.not_found |
引用的对象不存在或超出范围。 |
工作区
工作区所有权/范围:代理租户在其不拥有的工作区上操作。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-WORKSPACE-0001 |
403 |
不是你的工作区 |
err.workspace.forbidden |
该资源属于另一个租户/所有者/会话。 |
AIH-WORKSPACE-0002 |
404 |
找不到工作区 |
err.workspace.not_found |
— |
AIH-WORKSPACE-0003 |
409 |
无法删除最后一个工作区 |
err.workspace.cannot_delete_last |
— |
ZAPIER
Zapier 连接器的入站触发器。
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-ZAPIER-0001 |
501 |
未配置入站触发器 |
err.zapier.not_configured |
该功能/集成已关闭或未配置。 |
AIH-ZAPIER-0002 |
401 |
无效的触发器签名或令牌 |
err.zapier.invalid_signature |
缺失或无效的凭证。 |
ANALYSIS
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-ANALYSIS-0001 |
503 |
当前无法访问源。对记录的一般分析或链接并不提供对原始数据的权利。 |
businessResults.sourceUnavailable |
— |
BINDING
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-BINDING-0001 |
400 |
绑定规则无效:选择一个通道、范围和一个目标 - 代理或“不回复”。 |
err.binding.invalid_rule |
— |
AIH-BINDING-0002 |
409 |
此目标的绑定已存在 - 删除或编辑现有绑定。 |
err.binding.overlap |
— |
AIH-BINDING-0003 |
404 |
找不到绑定。 |
err.binding.not_found |
— |
AIH-BINDING-0004 |
400 |
@handle 不是该渠道发送的账号标识,请用渠道的数字 id 添加此人。 |
err.binding.handle_not_identity |
— |
AIH-BINDING-0005 |
409 |
该群组或频道已连接到此服务器上的另一个组织,无法在此绑定到代理。 |
err.binding.chat_taken |
— |
BROWSER
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-BROWSER-0001 |
503 |
浏览器配置文件服务未运行。该服务随浏览器一同启动。 |
err.browserprofile.service_unavailable |
— |
AIH-BROWSER-0002 |
409 |
该智能体已有浏览器配置文件。请先解除该智能体与其的关联。 |
err.browserprofile.agent_taken |
— |
AIH-BROWSER-0003 |
409 |
配置文件当前被占用:有人正在登录。请几分钟后再试。 |
err.browserprofile.busy |
— |
AIH-BROWSER-0004 |
409 |
该配置文件仍在浏览器中打开:某个智能体正在其中完成操作。请一分钟后重试。 |
err.browserprofile.in_use |
— |
CLAIM
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-CLAIM-0001 |
409 |
识别窗口已关闭,请重新打开。 |
err.claim.window_closed |
— |
AIH-CLAIM-0002 |
404 |
该发送者在窗口开启期间没有发送消息。 |
err.claim.candidate_unknown |
— |
DATA
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-DATA-0001 |
503 |
无法检查当前源处理规则。 |
dataPolicy.errorUnavailable |
— |
AIH-DATA-0002 |
409 |
该源不允许选择的处理路径。选择已允许的兼容路由或检查源规则。 |
dataPolicy.errorIncompatible |
— |
AIH-DATA-0003 |
503 |
没有为此操作配置经过验证的兼容路由。指定处理位置和数据存储配置文件。 |
dataPolicy.errorUnconfigured |
— |
AIH-DATA-0004 |
409 |
本次操作期间,数据处理路径发生了变化。发出新的明确请求前,请检查当前路径。 |
dataPolicy.errorChanged |
— |
AIH-DATA-0005 |
409 |
以前的数据没有经过验证的来源分类。处理位置不会自动假定。使用新的上下文或检查源材料的分类。 |
dataPolicy.errorProvenanceUnknown |
— |
AIH-DATA-0006 |
409 |
无法验证此请求的附件源字节。请先打开现有附件,然后重试。 |
dataPolicy.errorFingerprintUnavailable |
— |
AIH-DATA-0007 |
409 |
处理设置已更改。保存前重新读取当前版本。 |
dataPolicy.errorConfigurationChanged |
— |
DELEGATION
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-DELEGATION-0001 |
403 |
该外部连接当前未分配给该用户和代理。 |
enterpriseConnections.errorDenied |
— |
AIH-DELEGATION-0002 |
409 |
外部身份、联系或权限发生了变化。重新启动当前的连接。 |
enterpriseConnections.errorChanged |
— |
AIH-DELEGATION-0003 |
503 |
配置的颁发者、提供商版本或委托配置文件不可用或不兼容。 |
enterpriseConnections.errorUnavailable |
— |
AIH-DELEGATION-0004 |
409 |
此前发行外部代币尚无确认结果。再次尝试之前,请与供应商检查实际输出。 |
enterpriseConnections.errorReconcile |
— |
AIH-DELEGATION-0005 |
409 |
公司连接的配置已更改。请在保存之前下载当前版本。 |
enterpriseConnections.errorConfigurationChanged |
— |
DEMO
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-DEMO-0001 |
403 |
此操作在公开演示站点上已禁用 |
err.demo.restricted |
— |
AIH-DEMO-0002 |
403 |
这是演示站点自身的组成部分,无法删除或停止 |
err.demo.protected |
— |
AIH-DEMO-0003 |
403 |
公开演示站点已关闭邮件通知,无法开启 |
err.demo.email_disabled |
— |
IMPORT
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-IMPORT-0001 |
409 |
该分块不能接续上传;上传将从服务器已收到的位置继续 |
err.import.upload_offset |
— |
AIH-IMPORT-0002 |
422 |
上传的文件与您电脑上的文件不同。请重新上传 |
err.import.upload_checksum |
— |
AIH-IMPORT-0003 |
413 |
导出超出了导入允许的大小 |
err.import.too_large |
— |
AIH-IMPORT-0004 |
507 |
服务器磁盘空间不足,无法存放导出并解压 |
err.import.no_space |
— |
AIH-IMPORT-0005 |
422 |
压缩包包含指向其外部的路径,未解压 |
err.import.unsafe_archive |
— |
AIH-IMPORT-0006 |
422 |
没有导入来源能识别此导出 |
err.import.not_recognized |
— |
AIH-IMPORT-0007 |
409 |
上传尚未完成 |
err.import.upload_incomplete |
— |
AIH-IMPORT-0008 |
424 |
导入前的数据库备份失败,因此未应用任何内容。请检查服务器上是否已安装 pg_dump |
err.import.backup_failed |
— |
NOTIFY
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-NOTIFY-0001 |
501 |
通知未启用 |
err.notify.not_enabled |
— |
AIH-NOTIFY-0002 |
400 |
通知首选项无效 |
err.notify.invalid_pref |
— |
AIH-NOTIFY-0003 |
503 |
Telegram 链接不可用 |
err.notify.telegram_unavailable |
— |
AIH-NOTIFY-0004 |
502 |
检查 Telegram 状态失败 - 请重试 |
err.notify.telegram_transient |
— |
ONBOARDING
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-ONBOARDING-0001 |
503 |
无法连接到 aihummer.ru 服务器。请检查本服务器的网络连接,以便完成实例注册。 |
err.onboarding.awaiting_fleet |
— |
AIH-ONBOARDING-0002 |
400 |
所有者标识必须是 UUID 格式 |
err.onboarding.invalid_owner |
— |
PLAN
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-PLAN-0001 |
402 |
该 AI 员工超出当前套餐的名额。请续订以恢复其工作。 |
err.plan.agent_over_limit |
— |
ROLE
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-ROLE-0001 |
400 |
角色定义无效 |
err.role.invalid |
— |
AIH-ROLE-0002 |
409 |
具有此名称的角色已存在 |
err.role.exists |
— |
AIH-ROLE-0003 |
404 |
找不到角色 |
err.role.not_found |
— |
AIH-ROLE-0004 |
400 |
内置角色是只读的 |
err.role.builtin_readonly |
— |
AIH-ROLE-0005 |
409 |
该角色仍分配给用户 - 首先撤销它 |
err.role.in_use |
— |
SETTINGS
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SETTINGS-0001 |
403 |
此设置是由 AiHummer Cloud 管理,无法更改 |
err.settings.cloud_locked |
— |
AIH-SETTINGS-0002 |
400 |
代码执行未能设为“仅在沙箱中”:操作系统沙箱(bubblewrap)无法在本服务器上启动,且未设置容器镜像。请安装 bubblewrap,或选择“在本服务器上”。 |
err.settings.code_exec_sandbox_unavailable |
— |
SUPPORT
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-SUPPORT-0001 |
503 |
没有与供应商的连接 - 车队巴士已离线。稍后重试。 |
err.support.unavailable |
— |
AIH-SUPPORT-0002 |
400 |
支持服务拒绝了请求 |
err.support.rejected |
— |
TURN
| 代码 |
HTTP |
意义 |
i18n 键 |
典型原因 |
AIH-TURN-0001 |
502 |
模型提供者拒绝了其凭证 |
err.turn.provider_auth |
— |
AIH-TURN-0002 |
429 |
请求被提供者或预算政策限制 |
err.turn.rate_limited |
— |
AIH-TURN-0003 |
502 |
所需的服务暂时不可用 |
err.turn.upstream_unavailable |
— |
AIH-TURN-0004 |
502 |
此步骤所需的工具失败了 |
err.turn.tool_failed |
— |
AIH-TURN-0005 |
502 |
任务未能在单轮的步骤上限内完成 |
err.turn.step_limit |
— |
AIH-TURN-0006 |
502 |
对话已超出模型的上下文窗口 |
err.turn.context_overflow |
— |
AIH-TURN-0007 |
503 |
计划任务的本轮因服务器重启而中断 |
err.turn.interrupted_restart |
— |
AIH-TURN-0008 |
503 |
服务器正忙于其他回复,消息未被处理。请重新发送。 |
err.turn.server_busy |
— |
AIH-TURN-0009 |
409 |
任务阶段已停止。请检查任务的当前状态。 |
err.turn.task_stopped |
— |