常見問題

報錯資訊

可能原因

解決方案

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.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

OpenAI 相容端點：https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

401 Incorrect API key provided

誤用了百鍊通用 Base URL（dashscope.aliyuncs.com）

Anthropic 相容端點：https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

OpenAI 相容端點：https://token-plan.ap-southeast-1.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.

輸入或輸出命中平台Alibaba Content Security Service策略。

修改輸入內容後重新提交。如多次觸發，調整提示詞避免敏感話題。

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 數（TPS/TPM）超過模型限流閾值也會觸發。限流按主帳號維度計算，帳號下所有 RAM 子帳號、業務空間和 API Key 的調用量合并計算；即使每分鐘總調用量未超限，短時間內的請求激增也可能觸發。

額度已用盡：可加購坐席（加購後需將新坐席分配給成員後再使用）、加購共用用量包，或等待下一計費周期額度自動重設。

觸發限流：等待約一分鐘後重試，並採用平滑請求策略（如勻速調度、指數退避或請求隊列緩衝）避免瞬時高峰；如預設限流額度無法滿足業務需求，可前往百鍊控制台的限流提額提升模型的臨時 TPM 額度。更多限流條件與規避方法，請參見限流。

Connection error

Base URL 網域名稱拼字錯誤或網路連接異常

檢查 Base URL 網域名稱拼字及網路連接。