NezhaGate

OpenAI 兼容的 AI Gateway,一个端点统一接入 GPT-5.5、Gemini 系列对话与 gpt-image 生图等全部模型。面向人阅读,也面向 AI 编程助手一键复制。

快速接入

替换 Base URL 和 API Key 后,现有 OpenAI SDK 可直接使用。

Base URL
https://nezhagate.com/v1
curl · 对话 API:Chat Completions
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "写一段 AI API 产品介绍"}], "stream": false}'

每个模型的完整接口参数、示例与异步用法,见下方「模型与价格」表里对应模型的文档。

更多可运行示例(Python / Node / curl,含图片与视频的异步任务流程):github.com/gaoorange/nezhagate-api-examples

认证方式

所有 API 调用都需要 Bearer Token。

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

模型与价格

每个模型的完整接口参数、示例与异步用法,见下方「模型与价格」表里对应模型的文档。

模型能力端点价格
gpt-5.6-sol前沿推理、Agentic 编程、长链路任务、结构化输出/chat/completions 输入 $2.0/1M · 输出 $12.0/1M API 文档 →
gpt-5.6-terra日常对话、Agentic 编程、推理、结构化输出/chat/completions 输入 $1.2/1M · 输出 $7.0/1M API 文档 →
gpt-5.6-luna高速对话、Agentic 编程、大批量低延迟、结构化输出/chat/completions 输入 $0.8/1M · 输出 $4.8/1M API 文档 →
gpt-5.5对话、推理、Agent、结构化输出/chat/completions 输入 $0.7/1M · 输出 $4.2/1M API 文档 →
gpt-6-astra深度推理、Agentic 编程、超长上下文、图片输入、结构化输出/chat/completions 输入 $2.8/1M · 输出 $14.0/1M API 文档 →
gpt-image-2文生图、图生图、封面、海报、插画/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 文档 →
gpt-image-2.5-flare文生图、图生图、封面、海报、插画、文字排版/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 文档 →
gpt-image-2.5-sunburst文生图、图生图、封面、海报、插画、文字排版/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 文档 →
nano-banana-2文生图、图生图、封面、海报、插画/images/generations 1K $0.025 · 2K $0.0375 · 4K $0.0625 API 文档 →
nano-banana-pro文生图、图生图、封面、海报、插画、信息图/images/generations 1K $0.04 · 2K $0.06 · 4K $0.1 API 文档 →
claude-sonnet-4-6对话、代码、推理、长上下文/chat/completions 输入 $1.5/1M · 输出 $7.5/1M API 文档 →
claude-opus-5深度推理、代码、Agent、长上下文、图片理解/chat/completions 输入 $4.0/1M · 输出 $20.0/1M API 文档 →
claude-fable-5中文写作、叙事创作、长文生成、对话、代码、图片理解/chat/completions 输入 $8.0/1M · 输出 $40.0/1M API 文档 →
gemini-3.1-pro对话、推理、超长上下文、多模态/chat/completions 输入 $0.5/1M · 输出 $3.0/1M API 文档 →
gemini-3.8-flash对话、推理、自适应思考、图片输入、超长上下文/chat/completions 输入 $0.6/1M · 输出 $3.6/1M API 文档 →
gemini-3.7-flash对话、推理、自适应思考、图片输入、超长上下文/chat/completions 输入 $0.6/1M · 输出 $3.6/1M API 文档 →
gemini-3.6-flash对话、推理、思考、图片输入、超长上下文/chat/completions 输入 $0.6/1M · 输出 $3.6/1M API 文档 →
gemini-3.6-flash-high深度推理、复杂任务、思考、图片输入、超长上下文/chat/completions 输入 $0.6/1M · 输出 $3.6/1M API 文档 →
gemini-3.6-flash-low高速对话、大批量、低延迟、图片输入/chat/completions 输入 $0.6/1M · 输出 $3.6/1M API 文档 →
gemini-3.6-flash-tiered自适应思考、对话、推理、图片输入/chat/completions 输入 $0.6/1M · 输出 $3.6/1M API 文档 →
gemini-3-flash-preview对话、推理、高并发、低延迟/chat/completions 输入 $0.3/1M · 输出 $1.2/1M API 文档 →
gemini-3.5-flash对话、推理、高并发、低延迟、思考/chat/completions 输入 $0.45/1M · 输出 $2.7/1M API 文档 →
gemini-2.5-flash对话、高并发、低延迟、多模态/chat/completions 输入 $0.3/1M · 输出 $1.2/1M API 文档 →
veo-3.1文生视频、图生视频、短片、商业成片/videos/generations $0.075 /条起 API 文档 →
seedance-2.5长镜头短片、多参考素材、商业成片/videos/generations $0.158 /秒 API 文档 →
seedance-2.0短片、商业素材/videos/generations $0.15 /秒 API 文档 →
seedance-2.0-fast批量素材、快速验证创意/videos/generations $0.1 /秒 API 文档 →
seedance-2.0-mini海量草稿、低成本试错/videos/generations $0.066 /秒 API 文档 →
wan3.0-video长镜头叙事、多素材合成、视频改写/videos/generations $0.12 /秒 API 文档 →
wan3.0-video-prime赶工期的成片、批量试拍/videos/generations $0.16 /秒 API 文档 →
minimax-h3高清成片、带声短片/videos/generations $0.036 /秒 API 文档 →
grok-imagine-video-1.5批量短视频、创意快速验证/videos/generations $0.3 /条起 API 文档 →

在 App 里直接使用(无需写代码)

在任意支持 OpenAI 接口的客户端里,填入下面三项即可使用,无需编程:

API 地址 / Base URLhttps://nezhagate.com/v1
API 密钥你在控制台创建的 Key(控制台 → API Keys → 复制)
模型名gpt-5.6-sol gpt-5.6-terra gpt-5.6-luna gpt-5.5 gpt-6-astra gpt-image-2 gpt-image-2.5-flare gpt-image-2.5-sunburst nano-banana-2 nano-banana-pro claude-sonnet-4-6 claude-opus-5 claude-fable-5 gemini-3.1-pro gemini-3.8-flash gemini-3.7-flash gemini-3.6-flash gemini-3.6-flash-high gemini-3.6-flash-low gemini-3.6-flash-tiered gemini-3-flash-preview gemini-3.5-flash gemini-2.5-flash veo-3.1 seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-mini wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

已验证可用:ChatBox、Cherry Studio、NextChat、LobeChat、沉浸式翻译、Open WebUI 等。

原生 Anthropic 接口(Claude Code 直连)

Claude 模型除 OpenAI 兼容口径外,还提供原生 Anthropic Messages API:把 Claude Code 等工具的 ANTHROPIC_BASE_URL 指到下面地址、用你的网关 Key 作 x-api-key 即可直连,thinking、工具调用、提示缓存等原生特性完整保留。

Claude Code · env
export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic
export ANTHROPIC_API_KEY=YOUR_API_KEY
# claude-sonnet-4-6 / claude-opus-5 / claude-fable-5
curl · /anthropic/v1/messages
curl https://nezhagate.com/anthropic/v1/messages -H "x-api-key: YOUR_API_KEY" -H "anthropic-version: 2023-06-01" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

可用模型:claude-opus-5、claude-fable-5、claude-sonnet-4-6。计费与 /v1 完全一致,按 token 计价。

提示缓存计费:缓存命中(缓存读)按输入价 1/10(0.1×)计、缓存写入按 1.25× 计(各模型单价见价格页)。命中需前缀稳定且足够长(Claude Opus ≥ 4096 tokens、Sonnet ≥ 2048)并在短时间内重复调用 —— Claude Code 带大 CLAUDE.md / 系统提示跑真实代码库时通常每轮命中,输入成本降至约 1/10;在线测试台的短问答前缀过短不会命中,属正常。

视频生成(异步任务)

文生视频 / 图生视频统一为异步任务:提交后立刻返回 HTTP 202 与任务号({"id":"img_...","object":"video.generation.job","status":"queued"}),再轮询 GET /v1/videos/jobs/{id} 直到 status=succeeded,结果在 data[0].url(重托管的 mp4 稳定直链)。单条约 1-12 分钟。计费分两种:Veo 3.1 按条计费;Seedance 2.x 与 MiniMax H3 按秒计费(每秒单价 × 时长)。两种都是预扣与结算完全一致、失败全额退。方向用 size 传画幅(16:9 横屏为默认);图生视频在 image 里传参考图作为首帧。

curl · 提交任务
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "veo-3.1", "prompt": "一只猫在日落时冲浪", "tier": "quality", "resolution": "1080p", "size": "16:9", "duration": "8s"}'
curl · 轮询结果
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

可用视频模型:veo-3.1 seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-mini wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

复制给 AI 的接入说明

把下面整段发给 Codex / Claude Code / Cursor,它就知道怎么接。也可以用右上角「复制页面」复制整篇文档。

AI Integration Prompt
请使用 OpenAI-compatible API 接入 NezhaGate。
Base URL: https://nezhagate.com/v1
API Key: 从环境变量 NEZHAAPI_KEY 读取。
Claude 模型可选原生 Anthropic 口径(适合 Claude Code / Anthropic SDK 直连):ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic,请求头 x-api-key=API Key + anthropic-version: 2023-06-01,POST /anthropic/v1/messages(必填 max_tokens),模型 claude-sonnet-4-6 / claude-opus-5 / claude-fable-5。
对话模型(/chat/completions):gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna / gpt-5.5 / gpt-6-astra / claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / gemini-3.1-pro / gemini-3.8-flash / gemini-3.7-flash / gemini-3.6-flash / gemini-3.6-flash-high / gemini-3.6-flash-low / gemini-3.6-flash-tiered / gemini-3-flash-preview / gemini-3.5-flash / gemini-2.5-flash
生图模型(文生图 /images/generations,图生图 /images/edits 或加 image 参数):gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / nano-banana-2 / nano-banana-pro
生视频模型(文生视频 /videos/generations,异步任务;图生视频加 image 参数传首帧):veo-3.1 / seedance-2.5 / seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini / wan3.0-video / wan3.0-video-prime / minimax-h3 / grok-imagine-video-1.5
认证:Authorization: Bearer YOUR_API_KEY
要求(对话):返回 choices[0].message.content;401 检查 Key,402 余额不足,429/5xx 可重试。
要求(图片,异步任务):提交 /images/generations 或 /images/edits 立刻返回 HTTP 202 与任务号({"id":"img_...","object":"image.generation.job","status":"queued"});随后轮询 GET /v1/images/jobs/{id} 直到 status=succeeded,再读取 data[0].url(img.nezhagate.com 稳定直链)。不要在提交后直接读取 data。
要求(视频,异步任务):提交 /videos/generations 立刻返回 HTTP 202 与任务号(object=video.generation.job);随后轮询 GET /v1/videos/jobs/{id} 直到 status=succeeded,再读取 data[0].url(重托管 mp4 稳定直链)。单条约 1-2 分钟,失败全额退。

查询余额 / 用量

用任意一个 API Key 就能查本账户的剩余额度和消费,无需登录后台。最简单是 GET /v1/usage;也兼容 OpenAI 风格的 /v1/dashboard/billing/credit_grants(余额 = total_available)。

curl · /v1/usage
curl https://nezhagate.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"
curl · /v1/dashboard/billing/credit_grants
curl https://nezhagate.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"

错误码

状态码含义处理方式
401API Key 缺失或无效检查 Authorization Header
402余额不足或 Key 超出限额联系管理员充值
400模型或参数不支持只用 gpt-5.5 / gpt-image-2
429上游限流稍后重试
502所有上游线路失败等待恢复或联系管理员