FAQ

Agentsflare平台常见错误。

{"statusCode":400,"message":"Model gpt-image-1.5 is not available, please check if the model is in the admin allowed range"}

该错误表示您使用的api key没有权限使用gpt-image-1.5模型，请参考配置模型

{"statusCode":404,"message":"Key not found"}

该错误表示您使用的api key不存在，请检查您的api key是否正确。

{"message":"Cannot POST /openai/v2/images/generations","error":"Not Found","statusCode":404}

该错误表示请求的URL错误，请检查您的请求URL是否正确。

429 错误是什么原因？

收到 429 Too Many Requests 表示请求触发了限流。可能的原因：

• 账户额度不足：余额已用尽，请前往平台充值后重试
• 并发/频率超限：短时间内请求量过高，超出当前渠道的速率限制，请适当降低请求频率或添加重试退避逻辑

收到 5xx 错误怎么办？

500、502、503、529 等 5xx 错误均为上游模型服务端错误，表示 Agentsflare 已将请求正确转发，但模型提供商返回了异常。常见原因包括：

• 上游模型服务暂时过载或不可用
• 上游服务正在维护或发生故障

遇到此类错误时建议稍后重试，或开启自动重试逻辑（指数退避）。如果错误持续出现，可通过官方渠道反馈。

是否有超时设置？

Agentsflare 本身没有超时设定，请求会一直等待直到模型返回结果。

但 Agentsflare 前置了 Cloudflare 作为网络层代理，Cloudflare 存在 300 秒（5 分钟） 的空闲超时限制：若连接双端在 300 秒内均无数据传输，连接将被 Cloudflare 自动断开。

对于可能耗时较长的任务，建议：

• 使用流式输出（stream: true），流式模式下模型持续输出 token，连接始终有数据传输，可有效规避 300 秒空闲断开
• 适当控制 max_tokens，避免生成过长的内容