错误与解决方案目录

问题: 请求体不是合法 JSON。

解决方案: 检查 JSON 语法（引号、逗号、括号）并确认 Content-Type 为 application/json。

问题: 需要包含字段的 JSON 对象。

解决方案: 请传入包含 model、prompt 及可选参数的对象。

问题: API 需要 JSON 对象，但收到的是其他类型。

解决方案: 请以 JSON 对象形式发送 body。

问题: 当前 endpoint 不支持该模型。

解决方案: 请使用：nanobanano-2、nanobanano-2-2k、nanobanano-2-4k。

问题: prompt 缺失或为空。

解决方案: 请在 prompt 字段传入非空字符串。

问题: urls 必须是字符串数组。

解决方案: 示例格式：["https://...", "data:image/png;base64,..."]。

问题: 传入的 aspectRatio 不受支持。

解决方案: 可用值：auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9。

问题: webHook 必须是字符串。

解决方案: 传入回调 URL 字符串，或传 '-1' 使用轮询模式。

问题: shutProgress 必须是布尔值。

解决方案: 请使用 true 或 false。

问题: 结果请求中的 id 缺失或为空。

解决方案: 请传入 generate 接口返回的 id。

问题: 请求未携带 API Key 凭证。

解决方案: 请通过 Authorization: Bearer <APISTOR_API_KEY> 或 x-api-key 传递密钥。

问题: 提供的 API Key 不存在、已失效或格式错误。

解决方案: 请检查密钥，或在控制台重新签发新的 API Key。

问题: 账户余额低于当前请求所需费用。

解决方案: 请先充值余额，或切换到更便宜的模型。

问题: 服务器未设置 Grsai API key。

解决方案: 配置 GRSAI_API_KEY 环境变量并重启应用。

问题: 提供商拒绝了凭证。

解决方案: 检查上游 API Key 是否有效以及 Grsai 权限配置。

问题: 提供商临时限制请求频率。

解决方案: 加入退避重试并降低突发流量。

问题: 提供商认为请求参数不合法。

解决方案: 检查 model、prompt、aspectRatio 及必填字段。

问题: 传入的任务 id 在上游不存在。

解决方案: 确认 id 正确并属于对应项目/环境。

问题: prompt 或输入内容被上游审核拦截。

解决方案: 弱化敏感描述并移除受限内容。

问题: 生成结果被上游审核拦截。

解决方案: 调整 prompt 并在更安全上下文中重试。

问题: 提供商在处理过程中发生内部错误。

解决方案: 稍后重试，关键流程建议启用重试策略。

问题: 上游在服务器超时内未响应。

解决方案: 增大 GRSAI_TIMEOUT_MS，或改用 webhook/轮询。

问题: 无法连接到上游提供商。

解决方案: 检查网络、DNS 和 GRSAI_BASE_URL 可用性。

问题: 上游返回了意外状态码或错误格式。

解决方案: 检查响应 details 与上游日志，必要时重试。