常见问题

报错信息

可能原因

解决方案

401 InvalidApiKey: No API-key provided.

请求头中未携带 API Key（Authorization: Bearer 或 x-api-key 均未传）。

在管理后台生成 API Key，并在工具中完成配置。

401 InvalidApiKey: Invalid API-key provided.

1. 误用了百炼通用 API Key（sk-xxx 格式）或 Coding Plan 的 API Key

2. Token Plan 团队版订阅过期

3. API Key 复制不完整或包含空格

1. 确认使用的是 Token Plan 专属 API Key，确保完整且无空格。

2. 确认订阅是否过期。

3. 如仍报错，重置 API Key，重置后使用新 Key 配置。

404 model 'xxx' not found or not supported

400 Model not exist.

1. 模型名称拼写错误或大小写错误

2. 模型 ID 不在套餐支持列表中

1. 确认模型名称区分大小写，与套餐支持的模型 ID 一致。

2. 检查所选套餐是否包含该模型。

401 invalid access token or token expired

误用了 Coding Plan 或其他套餐的 Base URL

Anthropic 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

OpenAI 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

401 Incorrect API key provided

误用了百炼通用 Base URL（dashscope.aliyuncs.com）

Anthropic 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

OpenAI 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

400 InvalidParameter: Range of input length should be [1, xxx]

输入内容（含对话历史、代码上下文等）超出模型的最大上下文长度

新建会话清空历史，或使用工具自带的上下文压缩命令（如 Claude Code 的 /compact、Qwen Code 的 /clear）。也可切换上下文窗口更大的模型。

400 InvalidParameter: url error, please check url！

Base URL 路径与协议不匹配。例如把 OpenAI 兼容路径配在 Anthropic 端点上，或反之。

按工具实际使用的协议选择对应的端点：

• Anthropic 兼容协议（Claude Code 等）：以 /apps/anthropic 结尾。

• OpenAI 兼容协议（Cursor、Qwen Code 等）：以 /compatible-mode/v1 结尾。

400 InvalidParameter: Range of max_tokens should be [1, xxxx]

请求中的 max_tokens（或工具配置中的最大输出长度）超出当前模型支持的最大输出 Token 数。

将 max_tokens 调整为不超过报错信息中提示的上限值。

400 invalid_parameter_error: The thinking_budget parameter must be a positive integer and not greater than xxxxx

工具配置中的思维链长度（如 thinking_budget、budgetTokens）超过当前模型支持的上限。各模型上限不同，以报错中的数值为准。

将思维链长度调整为不超过报错提示的上限值，或在不支持思考模式的模型上移除该配置项。

400 data_inspection_failed: Input text data may contain inappropriate content.

输入或输出命中平台内容安全策略。

修改输入内容后重新提交。如多次触发，调整提示词避免敏感话题。

429 API-Key Requests rate limit exceeded, please try again later.

短时间内请求过于密集，触发模型调用限流。

等待一分钟后重试；如频繁触发请降低请求频率，并确认 API Key 未被他人共享使用。

429 Throttling.AllocationQuota: Allocated quota exceeded, please increase your quota limit.

insufficient_quota: You exceeded your current quota, please check your plan and billing details.

套餐 Token 已用完，坐席额度和共享用量包均已耗尽。

可加购坐席（加购后需将新坐席分配给成员后再使用）、加购共享用量包，或等待下一计费周期额度自动重置。

Connection error

Base URL 域名拼写错误或网络连接异常

检查 Base URL 域名拼写及网络连接。