NezhaGate 常见问题
关于接入、计费、模型与安全的常见疑问。
基础认知
NezhaGate 是什么？
NezhaGate 是一个 OpenAI 兼容的 AI 模型网关，通过一个接口、一个 API Key 统一接入 GPT、Claude、Gemini 与图像生成模型。开发者无需为每家厂商单独对接，只要把 Base URL 指向 NezhaGate，就能用熟悉的 OpenAI SDK 调用多家旗舰模型。平台内置 API Key 管理、余额与用量、模型市场和开发者文档，按量计费、失败不计费。
"对话、生图、生视频，一个接口"具体指什么？
指同一个 Base URL、同一个 API Key 覆盖三类任务：对话走 /v1/chat/completions，生图走 /v1/images/generations（图生图用 /v1/images/edits），生视频走 /v1/videos/generations。上游包括 OpenAI（GPT）、Anthropic（Claude）、Google（Gemini）、字节（Seedance）、阿里（Wan）、xAI（Grok）与 MiniMax，你不必为每一家单独对接 SDK、开账号和对账。切换或对比模型时，改一个 model 参数即可。
模型支持
支持哪些模型？
NezhaGate 目前接入 GPT-5.6 家族（Sol / Terra / Luna）、GPT-5.5 与 GPT Image 2，Claude Sonnet 4.6，Gemini 3.1 Pro 与 Gemini 3.6 / 3.5 / 3 / 2.5 Flash，以及 Nano Banana 生图与 Veo 3.1 视频等模型，并持续新增。完整、实时的模型列表与能力说明以「模型市场」页面为准。每个模型都用同一个接口和 Key 调用。
支持 GPT、Claude、Gemini 吗？
支持。GPT（OpenAI）、Claude（Anthropic）、Gemini（Google）三家的主力模型都已接入，可通过同一个 OpenAI 兼容接口调用。切换模型只需修改请求里的 model 字段，不需要更换 SDK 或重新对接。
支持图像生成模型吗？
支持。平台提供 gpt-image-2 等图像生成模型，可通过 /v1/images/generations 接口调用，支持文生图与图生图。生成结果以直链返回，便于在应用中直接引用。具体可用的生图模型与参数以模型市场和文档为准。
模型市场里的价格和能力说明多久更新？
模型市场的价格与能力说明实时跟随后台配置，价格调整后页面会同步显示。我们会在上架新模型或调整计费时更新对应条目。请以模型市场和定价页的实时展示为准。
价格与计费
NezhaGate 如何计费？
NezhaGate 采用预付费积分、按量计费：对话模型按输入 / 输出 token 计费，图像模型按张数与分辨率计费，单价以定价页和模型市场为准。没有套餐月费，用多少扣多少，余额按实际用量消耗。每一次调用的用量与花费都可在控制台查看。
为什么价格更有优势？
NezhaGate 通过统一网关、按量透明计费和成本优化机制，提供更有竞争力的模型接入价格。实际价格以定价页面和模型市场展示为准。
积分会过期吗？
当前充值积分暂无短期有效期限制，具体规则以平台最新说明为准。失败请求不扣费，余额按实际用量消耗。
请求失败会扣费吗？
请求失败不扣费。只有成功返回的调用才会按实际用量结算，上游报错或超时不会消耗你的余额。如果你在控制台看到失败记录，对应的费用不会从余额扣除。
如何查看余额和用量？
登录后在控制台即可查看实时余额、每个 API Key 的用量和每一次调用记录。调用日志包含模型、时间、token / 张数和花费，便于核对与排查。你也可以通过余额查询接口在程序中读取当前余额。
接入与开发
如何快速接入 NezhaGate？
接入分三步：注册账户 → 在控制台创建 API Key → 把 Base URL 指向 NezhaGate 并填入 Key。因为完全兼容 OpenAI 接口，已有的 OpenAI SDK 代码几乎不用改动，换掉 base_url 和 api_key 即可调用。详见开发者文档。
Base URL 应该怎么配置？
Base URL 配置为 https://nezhagate.com/v1。在 OpenAI SDK 中把 base_url（或环境变量 OPENAI_BASE_URL）设为该地址，api_key 填入你在控制台创建的 Key 即可。对话用 /v1/chat/completions，生图用 /v1/images/generations，路径与 OpenAI 一致。
是否兼容 OpenAI SDK？
兼容。NezhaGate 实现了 OpenAI 兼容的接口规范，官方 openai SDK 只需修改 base_url 与 api_key 即可直接使用。请求和响应结构与 OpenAI 保持一致，包括流式输出与多模态输入。
是否支持 Python、Node.js、curl？
支持。任何能发起 HTTP 请求或使用 OpenAI SDK 的语言都可以接入，包括 Python、Node.js、Go、Java 以及直接用 curl。文档里提供了 Python、Node.js 和 curl 的可直接运行示例。
是否支持 n8n、Dify、LangChain、Open WebUI、LobeChat、Cherry Studio、ChatBox？
支持。这些工具大多允许自定义 OpenAI 兼容的 Base URL 与 API Key，把它们指向 NezhaGate 即可使用平台上的模型。只要某个工具支持 OpenAI 兼容或自定义接口，就可以接入 NezhaGate，无需额外插件。
API Key 泄露了怎么办？
如果怀疑 API Key 泄露，请立即在控制台删除或轮换该 Key，旧 Key 失效后将无法继续调用。建议为不同项目分别创建 Key，不要把 Key 写进前端或公开仓库。你可以随时在控制台查看每个 Key 的用量以发现异常。
平台区别
NezhaGate 和官方 OpenAI / Claude / Gemini API 有什么区别？
官方 API 由模型厂商直接提供，适合有官方账号和独立账单能力的团队。NezhaGate 更像统一模型网关，重点解决多模型统一接入、OpenAI 兼容调用、计费管理和开发效率问题。
NezhaGate 的模型能力和官方一样吗？
NezhaGate 提供对主流模型能力的统一接入方式，具体模型能力、上下文、速度和可用功能以模型市场与文档说明为准。
哪些场景更适合使用 NezhaGate？
NezhaGate 适合需要在一个项目里调用多家模型、希望统一计费与用量管理、或想快速验证不同模型效果的场景。常见用法包括 AI 工具站、SaaS 产品、自动化工作流、Agent 与多模型对比。需要在多模型之间灵活切换时尤其方便。
是否适合商业项目或 AI 工具站使用？
适合。NezhaGate 提供 OpenAI 兼容接口、API Key 管理、按量计费和调用日志，便于集成到商业产品与工具站中。使用时请遵守平台条款与上游模型厂商的使用政策。建议在正式商用前结合自身需求评估线路与额度。
安全与规则
我的账号和 API Key 安全吗？
API Key 只在创建时完整显示一次，之后控制台只展示前缀，可随时停用或删除；每个 Key 都能单独设限额、每分钟请求数、模型白名单和 IP 白名单，所以一个 Key 泄露不会波及其它项目。调用记录、余额变动逐条可查，账单与用量随时对得上。请求内容只用于完成这次调用与计费，不会拿去训练模型。
使用 NezhaGate 有哪些注意事项？
请妥善保管 API Key、按需充值，并遵守平台《服务条款》与上游模型厂商的使用政策。调用前可参考定价页了解计费方式，避免无意中产生大额用量。具体功能、价格与可用模型以站内最新展示为准。
有哪些禁止使用场景？
禁止利用 NezhaGate 从事违反法律法规或上游厂商政策的行为，包括生成或传播违法、侵权、欺诈、恶意软件等内容，以及自动化滥用、绕过额度或安全限制。违反相关规定可能导致账号被限制或终止。完整规则见《服务条款》。
是否支持企业合作或批量调用？
支持。NezhaGate 可用于较大规模的批量调用，也欢迎企业洽谈合作。如有更高并发、专属额度或对接需求，请发邮件到 strandbergwickstrom@gmail.com，或通过站内「联系我们」与我们沟通。具体方案会结合你的用量与场景确定。
