常见问题与错误排查
本页整理 Gemini 生图的注意事项，具体请查看 Gemini 错误处理。
速度很慢怎么办？
调用速度很慢时，大概率与网络链路有关。主节点位于北美，建议优先使用北美服务器，或在访问北美节点速度较快的网络环境中调用。
如果暂时没有合适的网络环境，可以将接入端点从 https://api.llmnex.com 切换为香港加速节点 https://hk.llmnex.com。只替换域名，保留原有接口路径。
香港加速节点的并发限制
香港加速节点无法承接大并发，不建议将大并发业务直接切换至该节点。如需大并发支持或进一步协助，请联系客服：[email protected]。
请求一直等待，或客户端超时
生图是长耗时操作。现有文档建议：
| 场景 | 客户端超时 |
|---|---|
| Gemini 生图 | 300 秒 |
| Gemini 4K 弱网 | 建议 600 秒 |
服务端出图耗时不包含图片下载。旧文档中的 Gemini 4K base64 响应样例约 25–28 MB，实际大小随模型与图片内容变化，还需要检查客户端和代理的响应体上限。
是否应该自动重试
服务内部已有自动重试与账号轮换，不要在客户端叠加激进的循环重试。
401：检查 Key 是否有效，以及鉴权请求头是否正确。429：退避 2–5 秒后重试一次，避免循环重试。500：稍后重试一次，持续出现时联系服务方。503：先看错误消息；模型名或权限问题需要先处理，其他上游连接问题可退避后重试一次。400：检查 Gemini 请求体是否合法，不要原样重试。451：内容安全拦截，修改提示词或参考图，不要原样重试。
为什么流式没有更早返回图片
旧文档记录的 IMAGE 生图流式行为是完成后才发送最终图片，没有中间图片，且不返回非流式响应中的用量统计；尚未逐模型复测。这一说明不适用于 TEXT 首字快速响应，也不能据此推断 Nano Banana 2.1 的行为。
建议使用非流式，详见 Gemini 流式说明。
为什么 Pro 模型返回文字而不是图片
为兼容首字快速响应，后端已兼容 TEXT 模式。生图时必须在 generationConfig.responseModalities 中明确包含 "IMAGE"，建议设置为 ["IMAGE"]。省略该参数或仅指定 TEXT 时，Pro 模型可能生成文字；只在提示词里要求画图不能代替此参数。详见 Gemini 快速开始。
为什么参数没有生效
旧文档记录了接受但不生效的官方参数；尚未逐模型重新验证，请保守处理，不依赖其效果或无效参数的自动回落。模型的 -c 后缀区分计费方式，不表示固定分辨率。不要只依据官方 SDK 的参数列表判断本站能力。
模型名称与计费为什么变了
当前仅支持 Gemini 模型，旧版固定分辨率后缀模型已下线。带 -c 后缀按次计费，不带 -c 后缀按 token 计费；请先 查询可用模型，再更新调用时的完整模型名，不要自动切换计费方式。
报障需要提供什么
保留响应头 X-Oneapi-Request-Id；如果响应中包含上游任务号，也一起提供。
- Gemini：
responseId和upstreamJobId。
不要在报障信息中公开 API Key。