status_code=500, not implemented
如果错误原文同时包含 status_code=500 和 not implemented，请先确认所选模型是否支持当前请求接口所用的协议。例如，/v1/responses 需要模型的 supported_endpoint_types 包含 openai-response；缺少该类型时，这是接口协议不兼容，不是等待即可恢复的上游故障。
处理方式：
- 自建程序请按
supported_endpoint_types选择接口；包含openai时使用 Chat Completions：/v1/chat/completions。 - Claude Code 请按Claude Code 教程配置，并确认模型支持
anthropic。 - 请切换到匹配的接口后再做一条简短测试；等待或切换网络通常无法解决。
400 Bad Request / 参数不兼容
通常是请求格式、参数或会话状态不符合当前接口要求。 依次检查：- 模型 ID 是否从模型广场准确复制。
- 接口是否与模型和客户端匹配；请先看接入方式总览。
- 是否使用了当前模型不支持的图片、工具调用、推理或会话续接参数。
- 客户端或 SDK 是否为较新版本。
- 新建会话、发送简短文本后是否仍出现。
401 Unauthorized
常见原因：API Key 缺失、填写错误、已禁用/过期，或鉴权头格式不正确。403 Forbidden
403 表示本次请求被拒绝。平台侧常见原因包括：当前 Key 无权使用所选分组、Key 启用了模型限制、IP 白名单不匹配，或账号状态不可用；也可能是上游模型服务返回的拒绝。 先核对 Key 的分组、模型限制和 IP 白名单，再用一条简短文本验证。若持续出现，请提供 Request ID、模型、时间和错误原文；反复更换 Key 或高频重试通常无法解决问题，还可能触发更多限制。404 Not Found / 请求地址错误
优先检查：- Base URL 是否重复拼接为
/v1/v1/...。 - 客户端是否自动补全了
/v1或具体接口路径。 - 请求路径是否是平台支持的接口，例如
/v1/chat/completions、/v1/responses、/v1/messages、/v1/images/generations。
503 / no available channel。
429 Too Many Requests
429 可能来自平台的模型请求频率限制，也可能是模型服务的短时限流。Concurrency limit exceeded for user 这类原文通常来自上游或客户端自身的并发限制，不应仅凭状态码认定为平台 Key 故障。
- 降低并发，按响应中的
Retry-After优先等待；没有该字段时再使用带随机抖动的指数退避。 - 不要让多个程序以同一 Key 同时高频重试。
- 低频调用仍持续出现时，请提供 Request ID；我们会核查服务侧可用性。
500、502、503、504 或 524
除本页开头的not implemented 外，这些状态通常表示处理失败、连接中断、服务繁忙或等待超时，不一定是您的 Key 或提示词有问题。
同一模型连续失败时，请保留现场并避免持续重复提交长任务；我们会根据 Request ID 协助核查。
no available channel / 当前模型暂无可用服务
这表示当前 Key 的分组下暂时没有可用于该模型的服务。模型 ID 拼写错误、模型不在该分组、模型暂时不可用或服务维护，都可能触发此错误。请稍后重试，或改用模型广场中当前分组可见的其他模型。
若持续出现，请提交模型名、Request ID 和时间。这类问题通常与余额无关，通常不需要重新充值或创建 Key。
Concurrency limit exceeded for user
当前账号的并发请求数已达到上限。请等待正在进行中的请求结束，降低客户端并发后再试；通常不必先禁用或重新创建 API Key。
长会话或工具调用错误
Invalid signature in thinking block
当前会话中保存的思考内容无法继续校验，常见于长会话恢复、客户端状态变化或兼容性变化。
请新建会话、更新客户端，并避免在多个设备继续同一会话；原会话通常无法通过反复重试恢复。
previous_response_id is only supported on Responses WebSocket v2
客户端在不支持的连接方式上续接了此前响应。请新建会话，关闭实验性的会话续接/响应复用功能，或更新客户端。
Content block not found
客户端没有收到预期的完整内容片段，常见于长会话、工具调用或流式响应中断。请先新建会话、缩短输入并发送简单测试；若仍然异常，再暂时关闭非必要的工具调用，并向支持提供 Request ID、发生时间、模型和错误原文。我们会据此核查服务状态。
图片生成超时或能力不支持
图片模型只能调用图片接口，文本模型不能调用图片生成接口。当前图片生成使用同步请求，可能需要较长等待时间；为避免重复生成和重复消费，请在确认结果前不要连续提交同一图片任务。Image generation is not enabled/model not supported：检查模型、接口和参数是否匹配。504/524/ 客户端超时：保留 Request ID 和发生时间，确认结果前避免立即重复生成。