同一个模型名能用于所有接口吗？

不能这样假定。OpenAI 兼容格式和 Gemini 原生格式的路径、认证方式与消息结构不同，选择模型时同时查看端点说明。

404、认证失败或请求体不识别？

检查 SDK 是否自动拼接模型路径、地址是否重复包含版本段，以及密钥是否按该协议要求传递。不要把完整 Chat 端点填给原生 SDK。

文本成功，图片或工具失败？

检查模型是否支持该输入类型、文件格式和对应能力；先去掉图片、搜索及工具，验证纯文本，再逐项添加。界面有按钮不代表当前模型支持它。

输出为空或者被截断？

查看对应协议的完成原因、返回内容块、过滤提示和输出限制。不要只寻找普通文本字段，也不要把所有非文本结果当作网络失败。

下一步如何定位？

记录模型 ID、协议、SDK 或客户端版本、脱敏错误和请求 ID。参照兼容性说明与调用 FAQ检查；使用 Gemini CLI 时，从客户端入门进入相应工具教程。