一句话定义
该术语指代FastGPT使用中出现的三类报错场景：一是拉取镜像时出现的连接等待超时，报错信息为net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)；二是API调用频率超出配额导致的429错误，报错信息包含openai error: 生成向量错误、429 Too Many Requests，提示内容为Requests to the Get a vector representation of a given input that can be easily consumed by machine learning models and algorithms. Operation under Azure OpenAI API version 2023-03-15-preview have exceeded call rate limit of your current OpenAI S0 pricing tier. Please retry after 1 second.；三是特定模型调用时的URL报错，如qwen-vl-max模型调用时会提示url error, please check url！。
在 FastGPT 里怎么用
遇到连接超时报错时，可尝试调整网络配置，参考已尝试的网络调试方案，确认目标地址可通过curl正常访问。遇到API调用超限报错时，可减少内容分段数量，或等待配额恢复后重试。当前暂无官方内置的自动延迟重试或并发数限制功能，相关功能诉求可关注官方更新。在4.8.22版本的Docker部署环境中，qwen-plus模型可正常调用，qwen-vl-max模型调用时会提示url error, please check url！，需检查对应调用配置。
容易搞错的地方
容易搞错的地方包括：误将ping通目标地址等同于接口可正常访问，实际curl请求可能失败；未注意到API调用超限与内容分段数量相关，过多分段会触发频率限制；误以为配置DNS即可解决镜像拉取超时问题；未明确区分ping与curl的访问差异，ping仅验证网络连通性，无法确认接口服务是否正常；易混淆不同模型的调用兼容性，例如误将qwen-plus的配置直接用于qwen-vl-max；遇到429报错时，易误认为是FastGPT自身问题，实则源于当前OpenAI定价层级的调用频率超限；遇到url error报错时，易忽略检查模型调用的URL配置，而优先调整其他参数。
来源： FastGPT 官方来源
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 术语表 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。