客户后台错误

本页覆盖客户后台源码声明的业务错误。模型调用和体验中心转发的网关错误见 网关错误码。源码声明不等于每个业务分支都已逐项验收, 上线行为以所使用的发布版本为准。

返回通常为 {"error":{"code":"...","message":"...","type":"..."}}。 错误码用于判断,文案用于阅读。失败时保留请求 ID,不发送密码或完整 API Key。

登录与身份

CodeHTTPmessage 原文含义与处理
customer_login_failed401Customer login failed.检查账号、密码和账号状态,不区分账号是否存在
customer_session_required401Customer session is required.会话缺失或失效,重新登录
customer_mfa_required401/403A valid MFA code is required.登录时(401)或开启、更换、关闭双重验证时(403)提供当前有效的 MFA 验证码
customer_mfa_unavailable503Customer MFA is not configured.MFA 服务未配置,联系支持
customer_mfa_verification_failed400Customer MFA verification failed.MFA 校验失败,检查验证码或恢复码
customer_login_rate_limited429Too many customer login attempts. Please retry later.登录尝试过多,等待 retryAfterSeconds / Retry-After
customer_auth_rate_limited429Too many authentication attempts. Please retry later.注册、身份或 MFA 尝试过多,等待重试提示
customer_registration_unavailable403/503Customer registration is not available.注册被关闭,或必要存储不可用
invalid_customer_registration400Customer registration payload is invalid.注册字段不合法
customer_registration_invite_required403A valid registration invite is required.当前要求有效邀请,检查邀请凭证
customer_email_delivery_unavailable503The account was created, but email delivery is temporarily unavailable.邮件交付不可用;该固定文案也用于邮件操作,不据此判断是否刚创建账号
customer_password_reset_invalid400Password reset token is invalid or expired.密码重置凭证无效或过期,重新申请
customer_csrf_required403CSRF token is required for browser write requests.浏览器写操作缺少 CSRF,刷新登录状态后重试
customer_permission_denied403Customer account does not have permission for this operation.当前身份无操作权限,联系组织管理员

输入与组织管理

以下错误当前共用英文 Customer API key request payload is invalid.。 这是一条通用旧文案,并不表示操作都与 API Key 有关。实际原因以 code 和下表为准。 所有以下条目的 HTTP 状态均为 400,type 为 invalid_request_error。

Code含义与处理
invalid_customer_profile_update个人资料更新字段不合法
invalid_customer_kyc_submission实名资料字段不合法
invalid_customer_organization_switch组织切换请求不合法
invalid_customer_organization_create新建组织字段不合法
invalid_customer_organization_update更新组织字段不合法
invalid_customer_member_create新增成员字段不合法
invalid_customer_member_scope成员组织或项目范围不合法
invalid_customer_member_update更新成员字段不合法
customer_member_cannot_disable_self不能通过成员管理禁用自己的账号
customer_member_last_owner_protected不能禁用或降级租户最后一个 owner;请先指定另一个 owner
customer_member_project_rate_limit_invalid成员项目限额配置不合法
customer_member_project_rate_limit_exceeds_parent成员项目限额超出父级限制
invalid_customer_project_upsert新建或更新项目字段不合法
customer_project_id_mismatch路径和请求体的项目 ID 不一致
customer_project_model_not_allowed项目请求的模型不在可授权范围
customer_project_model_rate_limit_invalid项目模型限额不合法
customer_project_model_rate_limit_exceeds_parent项目模型限额超出父级限制
invalid_customer_api_key_create创建 API Key 字段不合法
invalid_customer_api_key_update更新 API Key 字段不合法
customer_api_key_rate_limit_exceeds_parentAPI Key 总限额超出父级限制
customer_api_key_model_rate_limit_exceeds_parentAPI Key 模型限额超出父级限制
invalid_customer_model_detail模型详情请求缺少有效模型标识
invalid_customer_playground_chat体验中心聊天请求字段不合法
invalid_customer_request_log_detail请求日志详情标识不合法
invalid_customer_history_query历史查询的游标、日期范围或页大小不合法;保留筛选条件并从第一页重新查询
invalid_customer_invoice_profile发票抬头字段不合法
invalid_customer_invoice_request开票请求字段不合法
invalid_customer_notification_read通知已读请求标识不合法

资源与模型

CodeHTTPmessage 原文含义与处理
customer_member_not_found404Customer member was not found.该成员在当前可访问范围内不存在
customer_project_not_found404Customer project was not found.该项目在当前可访问范围内不存在
customer_api_key_not_found404Customer API key was not found.Key 不存在或不在当前管理范围
customer_api_key_model_not_allowed403Requested models are not enabled for this project.Key 请求的模型超出项目授权
customer_model_not_found404Customer model was not found or is not enabled for this account.模型不存在或当前账户未开通
customer_playground_model_not_llm400Customer playground only supports LLM chat models.当前体验中心入口仅接受聊天模型
customer_request_log_not_found404Customer request log was not found.请求记录在当前可访问范围内不存在
customer_notification_not_found404Customer notification was not found.,部分分支可带通知操作异常说明通知不存在或不在当前范围

发票

CodeHTTPmessage 原文含义与处理
customer_invoice_issuance_unavailable503Electronic invoice issuance is not configured.电子开票未配置,联系支持
customer_invoice_queue_failed503Invoice issuance could not be queued. Retry is available.开票未成功进入队列,可重试
customer_invoice_request_not_found404Invoice request was not found.开票申请在当前范围内不存在
customer_invoice_retry_unavailable409Only failed invoice issuance or delivery can be retried.仅失败且未被拒绝或作废的开票或交付允许重试
customer_invoice_source_unavailable409Some selected balance transactions are not invoiceable.所选流水不可用于开票,或已被同时提交的另一张申请占用
customer_invoice_profile_approval_required409An approved invoice profile is required.需先通过发票抬头审核

共享错误

实名拒绝复用 customer_kyc_not_submitted、customer_kyc_pending、 customer_kyc_rejected、customer_kyc_expired,以及兜底 customer_kyc_required,均为 403。 兜底文案可为 Customer real-name verification is required before managing API keys.。 其他实名文案与 网关错误 相同。

框架解析失败和内部异常复用网关参考中的安全兜底码;体验中心还可能返回选定模型调用的网关错误。 公共静态资源找不到时另有 404 / asset_not_found,或者纯文本 Not found;没有业务错误对象时, 不要尝试按 error.code 解析。

注册或密码重置的受理成功不用于证明邮箱存在,以避免泄露账号状态。 账单、充值或开票的成功与否应读取对应业务状态,不能仅按某条错误文案推断。