Skip to content

Commit 4f8fb5b

Browse files
committed
docs: add SiliconFlow model disabled evidence (#1208)
1 parent bfe08d1 commit 4f8fb5b

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

docs/llm-providers.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,13 @@ Ollama 默认 Base URL `http://127.0.0.1:11434` 主要面向本地、Docker 或
142142

143143
完整分类逻辑以 `src/services/system_config_service.py` 中的错误分类实现为准。
144144

145-
`model_access_denied` 不是跨 provider 的官方错误码映射。本项目目前没有 SiliconFlow / OpenAI-compatible / LiteLLM 对 `Model disabled` 语义的官方错误码文档来源;该分类依据来自 Issue #1208 中真实脱敏样例:SiliconFlow / OpenAI Compatible 渠道测试经 LiteLLM 返回 `litellm.APIError: APIError: OpenAIException - Model disabled.`。实现仅在错误文本同时包含 `model` 和明确权限、禁用或不可用信号时进入该诊断;未覆盖或语义不同的 provider 文案会继续走既有兜底诊断。
145+
`model_access_denied` 不是跨 provider 的官方错误码映射。该分类的可复核依据包括:
146+
147+
- SiliconFlow 官方错误处理文档要求接口错误排查时记录 HTTP 错误码和 `message`,说明 403 表示余额不足或权限不够,其他情况参考报错 `message`,并建议换一个模型确认问题是否仍存在(中文:<https://docs.siliconflow.cn/cn/faqs/error-code>;英文:<https://docs.siliconflow.cn/en/faqs/error-code>)。
148+
- Issue #1208 中真实脱敏样例来自 SiliconFlow / OpenAI Compatible 渠道测试,经 LiteLLM 返回 `litellm.APIError: APIError: OpenAIException - Model disabled.`
149+
- 线上复核记录(2026-05-06T16:21:21Z):在 `litellm>=1.80.10,!=1.82.7,!=1.82.8,<2.0.0` 约束下,本地验证环境为 Python `3.13.12`、LiteLLM `1.82.3`、Base URL `https://api.siliconflow.cn/v1`、模型 `Qwen/Qwen3-235B-A22B-Thinking-2507`。直连 SiliconFlow Chat Completions 返回 HTTP `403`,响应体为 `{"code":30003,"message":"Model disabled.","data":null}`;同一模型通过 LiteLLM `completion(model="openai/Qwen/Qwen3-235B-A22B-Thinking-2507")` 返回 `APIError: OpenAIException - Model disabled.`
150+
151+
因此当前运行时把该已观测 provider `message` 作为 best-effort 模型可用性诊断,而不是把它声明为官方跨 provider 错误码。实现仅在错误文本同时包含 `model` 和明确权限、禁用或不可用信号时进入该诊断;未覆盖或语义不同的 provider 文案会继续走既有兜底诊断。
146152

147153
## 运行时能力检测边界
148154

0 commit comments

Comments
 (0)