错误参考

按规范错误码或稳定 RMX 编号查询 RouteMux API 与请求日志错误。

RouteMux 错误有三种标识，它们各自承担不同用途：

错误码，例如 BILLING_INSUFFICIENT_CREDITS，是供程序分支判断的机器可读值。
错误编号，例如 RMX-BILLING-5001，是用于搜索和联系客服的稳定查询号。
请求 ID，由 x-request-id 返回并显示在日志页，用于识别某一次具体错误。

程序应按规范 code 分支，不要按 message 分支。消息可能被本地化或改写。错误编号会链接到本页的永久锚点，例如 RMX-BILLING-5001。

错误出现在哪里

API 错误会保留所调用协议族的信封格式。OpenAI 兼容响应使用 error.code；Anthropic 兼容响应使用 error.code；Vertex 兼容响应使用 error.status。历史或供应商专属输入完成归一后，请求日志也会显示同一个规范错误码和稳定编号。

下面每一项都给出默认 HTTP 状态和计费结果。如果响应头已经发出后流才失败，HTTP 状态可能仍为 200；此时请以错误事件中的错误码和编号为准。

联系客服时请同时提供稳定错误编号和请求 ID。错误编号说明发生了什么，请求 ID 帮助客服定位具体请求。

返回示例

错误信封会保持与所调用端点的协议兼容；其中 RouteMux 描述对象在所有协议中都使用相同的 code、reference、documentation_url、request_id、retry 和 billing 语义。

OpenAI 兼容 HTTP 错误

{
  "error": {
    "code": "MODEL_BUSY",
    "message": "该模型当前没有可用于本次请求的容量。 请等几秒再重试；每失败一次就把等待时间加长。急的话换一个模型。",
    "reference": "RMX-MODEL-3006",
    "documentation_url": "https://routemux.com/zh/docs/errors#rmx-model-3006",
    "request_id": "req_01K0EXAMPLEBUSY",
    "retry": {
      "retryable": true,
      "strategy": "BACKOFF",
      "retry_after_seconds": 5
    },
    "billing": {
      "status": "NOT_BILLED"
    },
    "type": "overloaded_error",
    "param": null
  }
}

Anthropic 兼容 HTTP 错误

{
  "type": "error",
  "error": {
    "type": "billing_error",
    "code": "BILLING_INSUFFICIENT_CREDITS",
    "message": "预付费钱包没有足够的可用余额完成本次请求。 请充值钱包后重新提交请求。",
    "reference": "RMX-BILLING-5001",
    "documentation_url": "https://routemux.com/zh/docs/errors#rmx-billing-5001",
    "request_id": "req_01K0EXAMPLECREDIT",
    "retry": {
      "retryable": false,
      "strategy": "TOP_UP"
    },
    "billing": {
      "status": "NOT_BILLED"
    }
  },
  "request_id": "req_01K0EXAMPLECREDIT"
}

Vertex 兼容 HTTP 错误

{
  "error": {
    "code": 504,
    "status": "PROVIDER_TIMEOUT",
    "message": "模型服务未在允许时间内完成响应。 请等几秒再重试，每失败一次就把等待时间加长；或者换一个模型。",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "PROVIDER_TIMEOUT",
        "domain": "routemux.com",
        "metadata": {
          "reference": "RMX-PROVIDER-6001",
          "documentation_url": "https://routemux.com/zh/docs/errors#rmx-provider-6001",
          "request_id": "req_01K0EXAMPLETIMEOUT",
          "retryable": "true",
          "retry_strategy": "BACKOFF",
          "billing_status": "NOT_BILLED"
        }
      },
      {
        "@type": "type.googleapis.com/google.rpc.Help",
        "links": [
          {
            "description": "RouteMux error RMX-PROVIDER-6001",
            "url": "https://routemux.com/zh/docs/errors#rmx-provider-6001"
          }
        ]
      }
    ]
  }
}

流式传输开始后的 SSE 错误

event: error
data: {"error":{"code":"PROVIDER_STREAM_INTERRUPTED","message":"响应流因无法继续读取而中断。 请等几秒后重新发起这次请求；如果反复出现，请附上请求 ID 联系客服。","reference":"RMX-PROVIDER-6007","documentation_url":"https://routemux.com/zh/docs/errors#rmx-provider-6007","request_id":"req_01K0EXAMPLESTREAM","retry":{"retryable":true,"strategy":"BACKOFF"},"billing":{"status":"NOT_BILLED"}}}

对于 SSE，响应头发出后发生的错误会作为 event: error 帧返回。此时 HTTP 状态可能已经是 200；请按 error.code 分支，再查看 retry 和 billing。示例中的响应流中断为 NOT_BILLED；实际处理时应以返回的计费字段和最终请求日志为准。

公共响应头

所有 HTTP 错误都会通过相同的响应头提供查询信息。响应头名称不区分大小写。

响应头	含义
`X-Request-ID`	标识本次错误；可用它打开对应请求日志。
`X-RouteMux-Error-Code`	规范、机器可读的错误码。
`X-RouteMux-Error-Reference`	稳定的 `RMX-…` 查询编号。
`Link`	带 `rel="describedby"` 的规范错误文档链接。
`Content-Language`	公共错误消息及文档链接使用的语言。
`X-RouteMux-Billed`	取值为 `true`、`false`、`pending` 或 `unknown`。
`Retry-After`	错误定义了等待时间时，给出最少等待秒数。
`Cache-Control`	错误响应固定为 `no-store`。

在日志页定位请求

从响应中复制 X-Request-ID、规范错误码或 RMX-… 编号。
打开控制台 → 请求日志，粘贴到请求 ID / 错误编号 / 错误码查询框。错误码会自动归一成稳定编号。
点击日志行中的错误可直达本页对应编号；打开日志行本身可查看处理方法、重试策略、计费结果和请求上下文。
需要联系客服时，请同时提供稳定错误编号和请求 ID。不要发送 API 密钥或供应商原始响应。

错误目录

可按规范错误码、RMX-… 编号、标题或 HTTP 状态搜索。搜索不区分大小写，并把连字符与下划线视作等价分隔符。

搜索错误目录

115 个匹配错误

身份认证与访问

27 个错误

`AUTH_REQUIRED`

RMX-AUTH-1001 · 需要身份认证

HTTP 401

此操作需要已登录的 RouteMux 账号。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请先登录，再重新执行该操作。

`AUTH_API_KEY_REQUIRED`

RMX-AUTH-1002 · 缺少 API 密钥

HTTP 401

请求中没有携带受支持的 API 密钥请求头。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请按所用 SDK 的要求，在认证请求头中发送一个有效密钥。

`AUTH_INVALID_API_KEY`

RMX-AUTH-1003 · API 密钥无效

HTTP 401

系统无法验证所提供的 API 密钥。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请检查密钥值，或在控制台新建密钥。

`AUTH_AMBIGUOUS_API_KEY`

RMX-AUTH-1004 · API 密钥不明确

HTTP 400

多个 API 密钥请求头中携带了不同的凭据。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请只使用一个密钥请求头，或确保所有受支持请求头中的密钥完全一致。

`AUTH_API_KEY_INACTIVE`

RMX-AUTH-1005 · API 密钥未启用

HTTP 403

该 API 密钥存在，但当前已停用。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请启用该密钥，或改用其他有效密钥。

`AUTH_API_KEY_EXPIRED`

RMX-AUTH-1006 · API 密钥已过期

HTTP 403

该 API 密钥已超过配置的有效期。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请创建或使用仍在有效期内的密钥。

`AUTH_API_KEY_REVOKED`

RMX-AUTH-1007 · API 密钥已撤销

HTTP 400

已撤销的 API 密钥不能继续使用或恢复。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请创建替代密钥，并更新客户端配置。

`AUTH_ACCOUNT_SUSPENDED`

RMX-AUTH-1008 · 账号已暂停

HTTP 403

拥有该凭据的账号当前不能发起请求。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请联系 RouteMux 客服复核账号状态。

`AUTH_REQUEST_FAILED`

RMX-AUTH-1009 · 认证请求失败

HTTP 400

提交的认证信息无法被接受。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查提交的信息和账号状态后重试。

`AUTH_CREDENTIALS_INVALID`

RMX-AUTH-1024 · 邮箱或密码不正确

HTTP 401

邮箱与密码的组合没有匹配到任何账号。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请重新输入密码，或改用一次性验证码登录。

`AUTH_EMAIL_ALREADY_REGISTERED`

RMX-AUTH-1025 · 邮箱已注册

HTTP 409

该邮箱已经存在账号。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请直接用该邮箱登录，不必重新注册。

`AUTH_EMAIL_NOT_VERIFIED`

RMX-AUTH-1026 · 邮箱尚未验证

HTTP 403

账号已存在，但邮箱地址还没有完成验证。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请点开发送到该邮箱的验证链接；没收到的话看一下垃圾邮件。

`AUTH_EMAIL_INVALID`

RMX-AUTH-1027 · 邮箱地址不合法

HTTP 400

提交的邮箱地址不是有效地址。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请更正邮箱地址后重新提交。

`AUTH_FORBIDDEN`

RMX-AUTH-1010 · 认证操作被拒绝

HTTP 403

该账号不允许执行此认证操作。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请改用符合条件的账号；若限制不符合预期，请联系客服。

`AUTH_TURNSTILE_REQUIRED`

RMX-AUTH-1011 · 需要人机验证

HTTP 400

本次认证操作需要完成人机验证。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请完成人机验证后重新提交。

`AUTH_TURNSTILE_FAILED`

RMX-AUTH-1012 · 人机验证失败

HTTP 403

人机验证结果未通过校验。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请重新发起人机验证后再试。

`AUTH_SIGNUP_NOT_ALLOWED`

RMX-AUTH-1013 · 暂不允许注册

HTTP 403

该邮箱当前不符合创建账号的条件。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请改用符合条件的邮箱，或联系客服申请访问。

`AUTH_DISPOSABLE_EMAIL`

RMX-AUTH-1014 · 不接受临时邮箱

HTTP 403

临时邮箱不能用于创建账号。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请改用长期有效的个人或工作邮箱。

`AUTH_CSRF_TOKEN_MISSING`

RMX-AUTH-1015 · 缺少安全令牌

HTTP 403

控制台请求未携带所需的 CSRF 安全令牌。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请刷新控制台页面后重新提交操作。

`AUTH_ACCOUNT_PROVISIONING`

RMX-AUTH-1016 · 账号正在初始化

HTTP 401

账号仍在初始化，暂时无法处理此请求。

责任侧: RouteMux 平台侧
阶段: 身份认证
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请稍等后重试；若长时间未完成，请联系客服。

`AUTH_CSRF_TOKEN_INVALID`

RMX-AUTH-1017 · 安全令牌无效

HTTP 403

控制台安全令牌缺失、已过期，或与当前会话不匹配。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请刷新控制台页面后重新提交操作。

`AUTH_VERIFICATION_CODE_INVALID`

RMX-AUTH-1018 · 验证码无效

HTTP 422

验证码不正确、已过期或已经使用。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请重新获取验证码，并输入最新收到的验证码。

`AUTH_API_KEY_NOT_FOUND`

RMX-AUTH-1019 · API 密钥不存在

HTTP 404

请求的 API 密钥不存在，或不属于当前账号。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请刷新 API 密钥列表，并使用列表中显示的标识。

`AUTH_API_KEY_CONFIGURATION_INVALID`

RMX-AUTH-1020 · API 密钥配置无效

HTTP 400

API 密钥的名称、到期时间、模型、额度、标签或限速策略等一项或多项配置无效。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请修正提示的 API 密钥配置后重新提交。

`AUTH_API_KEY_NOT_REVEALABLE`

RMX-AUTH-1021 · 无法显示 API 密钥

HTTP 409

该旧版 API 密钥创建时尚不支持安全恢复明文。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请创建替代密钥、更新客户端配置，再撤销旧密钥。

`AUTH_SESSION_NOT_FOUND`

RMX-AUTH-1022 · 会话不存在

HTTP 404

请求的登录会话已不存在，或不属于当前账号。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修正请求后可重试。
计费: 不计费

处理方法

请刷新会话列表后再执行该操作。

`AUTH_CURRENT_SESSION_REVOKE_FORBIDDEN`

RMX-AUTH-1023 · 不能在此撤销当前会话

HTTP 422

会话管理操作不能撤销当前正在发起请求的会话。

责任侧: 请求或账号侧
阶段: 身份认证
重试: 修复认证问题后可重试。
计费: 不计费

处理方法

请使用“退出登录”结束当前会话。

请求校验

12 个错误

`REQUEST_INVALID`

RMX-REQUEST-2001 · 请求无效

HTTP 400

请求的字段或结构不符合这个接口的要求。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请按提示修正字段或请求体结构后再试。

`REQUEST_MODEL_REQUIRED`

RMX-REQUEST-2002 · 缺少模型

HTTP 400

请求未在预期位置提供模型标识。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请在请求体或 URL 路径中填写已发布的 RouteMux 模型 ID。

`REQUEST_TOO_LARGE`

RMX-REQUEST-2003 · 请求过大

HTTP 413

完整请求超过了网关允许的大小。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请缩小请求体或上传文件后重试。

`REQUEST_CONTENT_TOO_LARGE`

RMX-REQUEST-2004 · 内容过大

HTTP 413

请求里有一项内容超过了这个接口允许的大小。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请缩短或压缩超限内容后重试。

`REQUEST_MEDIA_TYPE_UNSUPPORTED`

RMX-REQUEST-2005 · 不支持的媒体类型

HTTP 415

这个接口无法处理你提交的 Content-Type 或文件格式。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请改用该接口文档里列出的格式。

`REQUEST_CLIENT_DISCONNECTED`

RMX-REQUEST-2006 · 客户端已断开

HTTP 499

客户端在响应完成前关闭了连接。

责任侧: 请求或账号侧
阶段: 流式传输
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请调大客户端超时，或避免提前取消长时间运行的流。

`REQUEST_ROUTE_NOT_FOUND`

RMX-REQUEST-2007 · 接口路径不存在

HTTP 404

请求的网关路径或方法不受支持。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请对照 API 参考检查基础 URL、路径和 HTTP 方法。

`REQUEST_TIMEOUT`

RMX-REQUEST-2008 · 请求超时

HTTP 408

操作完成前，客户端等待已经超时。

责任侧: 请求或账号侧
阶段: 转发
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请增加客户端超时时间，或重新发送请求。

`REQUEST_ABORTED`

RMX-REQUEST-2009 · 请求已取消

HTTP 499

客户端在操作完成前取消了请求。

责任侧: 请求或账号侧
阶段: 转发
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

仅在非预期取消时重新提交请求。

`REQUEST_IDEMPOTENCY_IN_PROGRESS`

RMX-REQUEST-2010 · 请求正在处理中

HTTP 409

用同一个 x-idempotency-key 发出的上一次请求还在处理中。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

原来那次请求还在处理中。请稍后查它的结果，或等一会儿用同一个 x-idempotency-key 重试。

`REQUEST_IDEMPOTENCY_CONFLICT`

RMX-REQUEST-2011 · 幂等键(x-idempotency-key)已被占用

HTTP 409

这个 x-idempotency-key 之前用在了内容不同的请求上。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

这个 x-idempotency-key 已经用在另一份请求内容上了。改了操作、模型或内容，就换一个新的 key。

`REQUEST_IDEMPOTENCY_REPLAY_UNAVAILABLE`

RMX-REQUEST-2012 · 无法重放上一次的结果

HTTP 409

原请求已经进入终态，但无法重放其响应。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请先在请求日志里确认原来那次的结果，再决定要不要换一个新 key 重新提交。

模型与能力

17 个错误

`MODEL_NOT_FOUND`

RMX-MODEL-3001 · 模型不存在

HTTP 404

请求的模型不在 RouteMux 已发布目录中。

责任侧: 请求或账号侧
阶段: 模型路由
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请选择模型列表接口返回的模型 ID。

`MODEL_ACCESS_DENIED`

RMX-MODEL-3002 · 无权访问模型

HTTP 403

该 API 密钥或账号无权使用此模型。

责任侧: 请求或账号侧
阶段: 模型路由
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请改用允许的模型，或更新密钥的模型限制。

`MODEL_PROTOCOL_UNSUPPORTED`

RMX-MODEL-3003 · 模型不支持该协议

HTTP 400

该模型未通过本次请求使用的协议族开放。

责任侧: 请求或账号侧
阶段: 模型路由
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请改用这个模型支持的接口，或换一个模型。

`MODEL_UNAVAILABLE`

RMX-MODEL-3004 · 模型暂不可用

HTTP 503

所选模型无法完成本次请求。

责任侧: 模型服务侧
阶段: 模型路由
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请换一个模型或稍后重试；若持续发生，请联系客服。

`MODEL_NOT_PROVISIONED`

RMX-MODEL-3005 · 模型尚未开通

HTTP 503

该模型存在于目录中，但当前尚未开通服务。

责任侧: RouteMux 平台侧
阶段: 模型路由
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请换一个模型或联系客服；原样重试不会解决问题。

`MODEL_BUSY`

RMX-MODEL-3006 · 模型负载已满

HTTP 503

该模型当前没有可用于本次请求的容量。

责任侧: 模型服务侧
阶段: 模型路由
重试: 可以——但要先等待，且每失败一次就把等待时间加长。建议至少等待 5 秒。
计费: 不计费

处理方法

请等几秒再重试；每失败一次就把等待时间加长。急的话换一个模型。

`MODEL_PARAMETER_UNSUPPORTED`

RMX-MODEL-3016 · 该模型不接受这个参数值

HTTP 400

请求里有一个参数，它的取值不被该模型接受，或超出了允许范围。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请在模型详情页查看该参数允许的取值和范围，调整后重试，或改用其他模型。

`MODEL_AUDIO_INPUT_UNSUPPORTED`

RMX-MODEL-3015 · 模型不接受音频输入

HTTP 400

所选模型无法处理音频输入。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请移除音频输入，或改用支持音频输入的模型。

`MODEL_VISION_UNSUPPORTED`

RMX-MODEL-3007 · 模型不支持视觉输入

HTTP 400

所选模型无法处理图片输入。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请移除图片输入，或选择支持视觉的模型。

`MODEL_IMAGE_TO_VIDEO_UNSUPPORTED`

RMX-MODEL-3008 · 模型不支持图生视频

HTTP 400

所选视频模型不接受起始图片。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请改用纯文本生成，或选择支持图生视频的模型。

`MODEL_TEXT_TO_VIDEO_UNSUPPORTED`

RMX-MODEL-3009 · 模型不支持文生视频

HTTP 400

所选视频模型要求提供图片输入。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请添加所需图片，或选择支持文生视频的模型。

`MODEL_LAST_FRAME_UNSUPPORTED`

RMX-MODEL-3010 · 模型不支持尾帧

HTTP 400

所选视频模型不接受尾帧约束。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请移除尾帧，或选择支持尾帧的模型。

`MODEL_REFERENCE_IMAGE_UNSUPPORTED`

RMX-MODEL-3011 · 模型不支持参考图

HTTP 400

所选模型不接受参考图片。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 请更换模型，或只在明确建议时重试。
计费: 不计费

处理方法

请移除参考图，或选择支持参考图的模型。

`MODEL_FIRST_FRAME_REQUIRED`

RMX-MODEL-3012 · 必须提供首帧

HTTP 400

提供尾帧时必须同时提供首帧。

责任侧: 请求或账号侧
阶段: 请求校验
重试: 修正请求后可重试。
计费: 不计费

处理方法

请添加首帧，或移除尾帧输入。

`MODEL_SERVICE_TIER_UNAVAILABLE`

RMX-MODEL-3013 · 服务等级不可用

HTTP 400

所请求的服务等级不适用于该模型或账号。

责任侧: 请求或账号侧
阶段: 模型路由
重试: 修正请求后可重试。
计费: 不计费

处理方法

请移除服务等级覆盖，或选择可用等级。

`MODEL_PUBLISH_PRICING_REQUIRED`

RMX-MODEL-3014 · 模型缺少定价

HTTP 422

模型必须完成定价配置后才能发布。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 修正请求后可重试。
计费: 不计费

处理方法

请补全所有必填定价字段后重新发布。

`MODEL_CONTEXT_EXCEEDED`

RMX-MODEL-3017 · 超出模型上下文窗口

HTTP 400

本次请求的输入超过了该模型单次可接受的上下文长度。

责任侧: 请求或账号侧
阶段: 转发
重试: 修正请求后可重试。
计费: 不计费

处理方法

请压缩或截断会话历史，或换用上下文窗口更大的模型。原样重试必然再次失败。

限流与额度

3 个错误

`LIMIT_RATE_EXCEEDED`

RMX-LIMIT-4001 · 请求受到限流

HTTP 429

请求触发了 RouteMux 的频率、并发或策略限制。

责任侧: 请求或账号侧
阶段: 限流
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请按响应里 Retry-After 给的秒数等待后再重试；没有该头就先等几秒，每失败一次把等待时间加倍，并额外加一点随机延迟，避免所有客户端同时重试。

`LIMIT_API_KEY_QUOTA_EXHAUSTED`

RMX-LIMIT-4002 · API 密钥额度已用尽

HTTP 429

该 API 密钥已达到配置的消费或用量额度。

责任侧: 请求或账号侧
阶段: 限流
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请提高密钥额度、等待额度重置，或改用其他密钥。

`LIMIT_API_KEY_POLICY_NOT_ALLOWED`

RMX-LIMIT-4003 · 不允许使用该 API 密钥限速策略

HTTP 403

API 密钥不能绑定高于账号等级的限速策略。

责任侧: 请求或账号侧
阶段: 限流
重试: 修正请求后可重试。
计费: 不计费

处理方法

请选择继承账号策略，或选择不高于账号等级的限速档。

计费与钱包

25 个错误

`BILLING_INSUFFICIENT_CREDITS`

RMX-BILLING-5001 · 余额不足

HTTP 422

预付费钱包没有足够的可用余额完成本次请求。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 充值钱包后可重试。
计费: 不计费

处理方法

请充值钱包后重新提交请求。

去充值

`BILLING_BALANCE_LIMIT_REACHED`

RMX-BILLING-5002 · 余额已达下限

HTTP 422

接受本次请求会使钱包余额超过信用下限。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 充值钱包后可重试。
计费: 不计费

处理方法

请先充值钱包，再发送新的计费请求。

去充值

`BILLING_COUPON_INVALID`

RMX-BILLING-5003 · 优惠码无效

HTTP 422

该优惠码无法用于本次购买。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查优惠码及适用条件，或不使用优惠码继续。

`BILLING_COUPON_EXPIRED`

RMX-BILLING-5004 · 优惠码已过期

HTTP 422

该优惠码已超过有效兑换期。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请使用其他有效优惠码，或不使用优惠码继续。

`BILLING_COUPON_EXHAUSTED`

RMX-BILLING-5005 · 优惠码已领完

HTTP 422

该优惠码已达到兑换上限。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请改用其他优惠码，或不使用优惠码继续。

`BILLING_COUPON_UNAVAILABLE`

RMX-BILLING-5006 · 优惠码暂不可用

HTTP 422

该优惠码当前被暂时占用或无法使用。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请稍后重试，或改用其他优惠码。

`BILLING_PROMOTION_LIMIT_REACHED`

RMX-BILLING-5007 · 已达到活动上限

HTTP 422

该账号或促销活动已达到权益使用上限。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请不使用该活动继续，或查看其适用规则。

`BILLING_COUPON_BELOW_MINIMUM`

RMX-BILLING-5008 · 未达到优惠码最低金额

HTTP 422

应付金额未达到优惠码规定的最低金额。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请提高充值金额，或移除该优惠码。

`BILLING_REDEEM_CODE_REQUIRED`

RMX-BILLING-5009 · 缺少兑换码

HTTP 422

本次兑换没有提供兑换码。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请输入兑换码后重新提交。

`BILLING_REDEEM_CODE_INVALID`

RMX-BILLING-5010 · 兑换码无效

HTTP 422

该兑换码已停用、存在风险或无效。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查兑换码，或使用其他有效兑换码。

`BILLING_REDEEM_CODE_EXPIRED`

RMX-BILLING-5011 · 兑换码已过期

HTTP 422

该兑换码已超过有效兑换期。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请使用其他有效兑换码。

`BILLING_REDEEM_ALREADY_USED`

RMX-BILLING-5012 · 兑换码已使用

HTTP 409

该兑换码已经被兑换。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请使用其他兑换码。

`BILLING_REDEEM_LIMIT_REACHED`

RMX-BILLING-5013 · 已达到兑换上限

HTTP 422

该账号已达到此兑换码的用户兑换上限。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请使用其他符合条件的兑换码。

`BILLING_REDEEM_NOT_REVERSIBLE`

RMX-BILLING-5014 · 兑换记录无法撤销

HTTP 422

该兑换记录当前不处于可撤销状态。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请刷新记录并确认当前状态后再试。

`BILLING_REDEEM_RESOURCE_NOT_FOUND`

RMX-BILLING-5015 · 兑换资源不存在

HTTP 404

请求的兑换码或兑换批次不存在。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查标识并刷新列表。

`BILLING_PRICING_STALE`

RMX-BILLING-5016 · 定价已发生变化

HTTP 409

生成预览后，定价已经发生变化。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请重新加载并确认最新定价后提交。

`BILLING_REFUND_TRANSACTION_NOT_FOUND`

RMX-BILLING-5017 · 退款交易不存在

HTTP 404

没有可退款交易与所提供的标识匹配。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查交易或支付意图标识，并刷新交易记录。

`BILLING_COUPON_CODE_CONFLICT`

RMX-BILLING-5018 · 优惠码已存在

HTTP 409

已有其他优惠券使用该优惠码。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请更换优惠码后重新提交。

`BILLING_COUPON_NOT_FOUND`

RMX-BILLING-5019 · 优惠码不存在

HTTP 404

找不到请求的优惠码记录。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查标识并刷新优惠码列表。

`BILLING_CONFIGURATION_INVALID`

RMX-BILLING-5020 · 计费配置无效

HTTP 422

充值金额、套餐、支付选项、提醒、自动充值或 Webhook 配置无效或不完整。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查计费表单中的值和必填配置后重新提交。

`BILLING_PAYMENT_METHOD_REQUIRED`

RMX-BILLING-5021 · 需要支付方式

HTTP 422

此计费功能需要已保存的支付方式。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请先添加支付卡，再启用此功能。

`BILLING_PAYMENT_PENDING`

RMX-BILLING-5022 · 支付仍在处理中

HTTP 409

尚未完成的支付使当前账号操作无法安全继续。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请先完成或取消待处理支付，再重新执行账号操作。

`BILLING_PAYMENT_RESOURCE_NOT_FOUND`

RMX-BILLING-5023 · 支付资源不存在

HTTP 404

当前账号下找不到请求的结账回执或账单客户记录。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查回执链接并刷新账单记录；若从未支付，请先完成一次充值。

`BILLING_REFUND_AMOUNT_INVALID`

RMX-BILLING-5024 · 退款金额无效

HTTP 422

退款金额缺失、超出允许范围，或超过剩余可退款金额。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 修正请求后可重试。
计费: 不计费

处理方法

请输入大于零且不超过账单记录所示可退余额的金额。

`BILLING_REFUND_NOT_AVAILABLE`

RMX-BILLING-5025 · 当前无法退款

HTTP 422

该支付或其剩余余额当前不处于可退款状态。

责任侧: 请求或账号侧
阶段: 计费准入
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请刷新账单记录并确认支付状态；若仍应可退，请联系客服。

模型服务与网络

8 个错误

`PROVIDER_TIMEOUT`

RMX-PROVIDER-6001 · 模型服务超时

HTTP 504

模型服务未在允许时间内完成响应。

责任侧: 模型服务侧
阶段: 转发
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请等几秒再重试，每失败一次就把等待时间加长；或者换一个模型。

`PROVIDER_UNREACHABLE`

RMX-PROVIDER-6002 · 无法连接模型服务

HTTP 502

RouteMux 无法与模型服务建立连接。

责任侧: 模型服务侧
阶段: 转发
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请等几秒再重试，每失败一次就把等待时间加长；或者换一个模型。

`PROVIDER_RATE_LIMITED`

RMX-PROVIDER-6003 · 模型服务受到限流

HTTP 429

模型服务因当前额度或容量限制拒绝了请求。

责任侧: 模型服务侧
阶段: 转发
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请等一会儿再重试，每失败一次就把等待时间加长；或者换一个模型。

`PROVIDER_REQUEST_REJECTED`

RMX-PROVIDER-6004 · 模型服务拒绝请求

HTTP 400

模型服务认为转发后的请求无效。

责任侧: 模型服务侧
阶段: 转发
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查模型专属参数并修正请求后再试。

`PROVIDER_UNAVAILABLE`

RMX-PROVIDER-6005 · 模型服务不可用

HTTP 502

模型服务无法处理本次请求。

责任侧: 模型服务侧
阶段: 转发
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请等几秒再重试，或换一个模型；联系客服时请附上请求 ID。

`PROVIDER_HTTP_ERROR`

RMX-PROVIDER-6006 · 模型服务 HTTP 错误

HTTP 502

模型服务返回了错误状态，但没有可安全公开的更具体分类。

责任侧: 模型服务侧
阶段: 转发
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

如果状态码是 5xx，等几秒再重试；如果是 4xx，说明请求本身要改，重试没有用。

`PROVIDER_STREAM_INTERRUPTED`

RMX-PROVIDER-6007 · 模型响应流中断

HTTP 502

响应流因无法继续读取而中断。

责任侧: 模型服务侧
阶段: 流式传输
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请等几秒后重新发起这次请求；如果反复出现，请附上请求 ID 联系客服。

`PROVIDER_OVERLOADED`

RMX-PROVIDER-6008 · 模型服务过载

HTTP 503

模型服务暂时过载，拒绝了本次请求。

责任侧: 模型服务侧
阶段: 转发
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

这是暂时的。请等 30-60 秒再重试，每失败一次就把等待时间加长；或者换一个模型。

任务与生成媒体

11 个错误

`JOB_NOT_FOUND`

RMX-JOB-7001 · 任务不存在

HTTP 404

请求的异步任务不存在或已不可用。

责任侧: 异步任务侧
阶段: 任务处理
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查任务 ID 和所属账号；必要时重新提交任务。

`JOB_VIDEO_NOT_READY`

RMX-JOB-7002 · 视频尚未就绪

HTTP 409

视频任务仍在运行，暂时没有可下载的结果。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——但要先等待，且每失败一次就把等待时间加长。
计费: 不计费

处理方法

请等待一段时间后再次查询任务。

`JOB_WORKER_STOPPED`

RMX-JOB-7003 · 任务执行进程已停止

HTTP 500

处理异步任务的执行进程已停止响应。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重新提交任务；若重复发生，请联系客服。

`JOB_RESULT_LOST`

RMX-JOB-7004 · 任务结果不可用

HTTP 500

异步任务处理后无法恢复其结果。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重新提交任务；必要时带请求 ID 联系客服。

`JOB_ARTIFACT_NOT_FOUND`

RMX-JOB-7005 · 生成产物不存在

HTTP 404

请求的生成文件不存在、已过期或不可用。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请检查产物 URL，或重新发起生成。

`JOB_VIDEO_GENERATION_FAILED`

RMX-JOB-7006 · 视频生成失败

HTTP 502

视频任务结束时没有产生可用结果。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试任务，或选择其他模型。

`JOB_IMAGE_GENERATION_FAILED`

RMX-JOB-7007 · 图片生成失败

HTTP 502

图片生成结束时没有产生可用结果。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试请求，或选择其他模型。

`JOB_MUSIC_GENERATION_FAILED`

RMX-JOB-7008 · 音乐生成失败

HTTP 502

音乐生成结束时没有产生可用结果。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试任务，或选择其他模型。

`JOB_SERVICE_DISABLED`

RMX-JOB-7009 · 异步任务服务不可用

HTTP 503

当前环境未启用异步网关任务。

责任侧: RouteMux 平台侧
阶段: 任务处理
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请改用同步接口，或联系客服。

`JOB_NOT_CANCELLABLE`

RMX-JOB-7011 · 任务已无法取消

HTTP 409

任务已经离开排队状态，取消不再适用。这不代表任务本身失败。

责任侧: 异步任务侧
阶段: 任务处理
重试: 不可重试——原样重试不会解决问题。
计费: 不计费

处理方法

请查询任务的当前状态：运行中的任务会跑完，已结束的任务无需取消。

`JOB_FAILED`

RMX-JOB-7010 · 任务失败

HTTP 500

异步任务失败，且没有可安全公开的更具体分类。

责任侧: 异步任务侧
阶段: 任务处理
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试任务；联系客服时请附上请求 ID。

控制台操作

7 个错误

`CONSOLE_REQUEST_FAILED`

RMX-CONSOLE-8001 · 控制台请求失败

HTTP 400

控制台操作失败，且没有公开的具体分类。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请重试一次；若持续发生，请附请求 ID 联系客服。

`CONSOLE_PLAYGROUND_DISABLED`

RMX-CONSOLE-8002 · Playground 不可用

HTTP 503

当前环境未启用 Playground。

责任侧: RouteMux 平台侧
阶段: 控制台操作
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请直接使用 API，或联系客服确认可用性。

`CONSOLE_CONFIRMATION_REQUIRED`

RMX-CONSOLE-8003 · 需要确认操作

HTTP 409

此高影响操作需要明确确认。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 修正请求后可重试。
计费: 不计费

处理方法

请查看警告；确认无误后再明确提交。

`CONSOLE_STALE_UPDATE`

RMX-CONSOLE-8004 · 记录已发生变化

HTTP 409

开始编辑后，该记录已被其他操作修改。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 修正请求后可重试。
计费: 不计费

处理方法

请加载最新记录、核对变化后重新提交。

`CONSOLE_RESOURCE_NOT_FOUND`

RMX-CONSOLE-8005 · 控制台资源不存在

HTTP 404

请求的控制台资源已不存在，或不属于当前账号。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 修正请求后可重试。
计费: 不计费

处理方法

请刷新相关列表，并打开列表中显示的资源。

`CONSOLE_LOG_RECORD_NOT_FOUND`

RMX-CONSOLE-8006 · 日志记录不存在

HTTP 404

当前账号下没有与该标识匹配且仍在保留期内的日志记录。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 修正请求后可重试。
计费: 不计费

处理方法

请检查请求 ID 或错误编号，并重新在日志页面搜索。

`CONSOLE_LOG_RECORD_EXPIRED`

RMX-CONSOLE-8007 · 日志记录已过期

HTTP 410

该日志记录曾经存在，但已在保留期结束后删除。

责任侧: 请求或账号侧
阶段: 控制台操作
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请改用仍在保留期内的记录，或将现有请求信息提供给客服。

平台与结算

5 个错误

`PLATFORM_USAGE_UNSETTLED`

RMX-PLATFORM-9001 · 用量未完成结算

HTTP 500

请求在对账关闭前没有进入最终结算状态。

责任侧: RouteMux 平台侧
阶段: 结算
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试请求；若重复发生，请联系客服。

`PLATFORM_USAGE_UNPARSED`

RMX-PLATFORM-9002 · 无法读取用量

HTTP 500

RouteMux 无法读取结算所需的用量数据。

责任侧: RouteMux 平台侧
阶段: 结算
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试，或附模型名和请求 ID 联系客服。

`PLATFORM_USAGE_INTERRUPTED`

RMX-PLATFORM-9003 · 用量处理被中断

HTTP 500

请求仍在进行时，平台处理进程已经停止。

责任侧: RouteMux 平台侧
阶段: 结算
重试: 可以——重新提交是安全的。
计费: 不计费

处理方法

请重试请求；若集中出现多次中断，请联系客服。

`PLATFORM_PRICING_INCOMPLETE`

RMX-PLATFORM-9004 · 定价配置不完整

HTTP 500

请求已经完成，但缺少结算所需的定价数据。

责任侧: RouteMux 平台侧
阶段: 结算
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请附模型名和请求 ID 联系客服；原样重试不会解决问题。

`PLATFORM_INTERNAL_ERROR`

RMX-PLATFORM-9005 · 平台错误

HTTP 500

RouteMux 无法完成该操作，且没有可安全公开的更具体错误码。

责任侧: RouteMux 平台侧
阶段: 结算
重试: 若持续发生，请联系客服。
计费: 不计费

处理方法

请重试一次；若持续发生，请附请求 ID 联系客服。

错误参考

OpenAI 兼容 HTTP 错误

Anthropic 兼容 HTTP 错误

Vertex 兼容 HTTP 错误

流式传输开始后的 SSE 错误

身份认证与访问

请求校验

模型与能力

限流与额度

计费与钱包

模型服务与网络

任务与生成媒体

控制台操作

平台与结算

On this page