NezhaGateNezhaGate

OpenAI 兼容接口:一个端点、一把 Key 调用 GPT、Claude、Gemini、DeepSeek 等对话模型,以及图片和视频生成。下面的示例都能直接复制运行。

快速接入

替换 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 输入 $1.2/1M · 输出 $6.0/1M API 文档 →
gpt-5.6-luna高速对话、Agentic 编程、大批量低延迟、结构化输出/chat/completions 输入 $0.07/1M · 输出 $0.4/1M API 文档 →
gpt-6-astra深度推理、Agentic 编程、超长上下文、图片输入、结构化输出/chat/completions 输入 $3.0/1M · 输出 $15.0/1M API 文档 →
gpt-6.1-solAgentic 编程、复杂编码、专业文档与分析工作、推理、超长上下文、图片输入、结构化输出/chat/completions 输入 $0.6/1M · 输出 $3.0/1M API 文档 →
gpt-6-sol复杂编码、Agentic 工作流、推理、超长上下文、图片输入、结构化输出/chat/completions 输入 $0.6/1M · 输出 $3.0/1M API 文档 →
gpt-6-luna大批量对话、低延迟 Agent 步骤、分类与抽取、超长上下文、结构化输出/chat/completions 输入 $0.07/1M · 输出 $0.4/1M API 文档 →
gpt-image-2文生图、图生图、封面、海报、插画/images/generations 1K $0.005 · 2K $0.025 · 4K $0.04 API 文档 →
gpt-image-2.5-flare文生图、图生图、封面、海报、插画、文字排版/images/generations 1K $0.005 · 2K $0.03 · 4K $0.05 API 文档 →
gpt-image-2.5-sunburst文生图、图生图、封面、海报、插画、文字排版/images/generations 1K $0.005 · 2K $0.03 · 4K $0.05 API 文档 →
nano-banana-2文生图、图生图、封面、海报、插画/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 文档 →
nano-banana-pro文生图、图生图、封面、海报、插画、信息图/images/generations 1K $0.02 · 2K $0.03 · 4K $0.05 API 文档 →
nano-banana-2.1文生图、改图、多图合成、海报与信息图、商品图、宽幅横幅/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 文档 →
grok-imagine-image文生图、改图、海报、产品图、社交配图、中英文文字/images/generations 1K $0.005 · 2K $0.005 · 4K $0.0 API 文档 →
grok-imagine-image-quality封面、海报、商品图、插画、文生图与改图/images/generations 1K $0.01 · 2K $0.01 · 4K $0.0 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 文档 →
claude-opus-5-5复杂推理、长程 Agent 编码、代码工程、工具调用、图片与 PDF 理解/chat/completions 输入 $2.5/1M · 输出 $12.5/1M API 文档 →
claude-sonnet-5-5日常编码与 Agent、长上下文、工具调用、图片与 PDF 理解、规模化生产流量/chat/completions 输入 $1.5/1M · 输出 $7.5/1M API 文档 →
gemini-4-argonBeta · 推理 · 长上下文/chat/completions 输入 $0.5/1M · 输出 $3.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 文档 →
deepseek-v4.1-flash对话、推理、代码、工具调用、思考模式可开关/chat/completions 输入 $0.075/1M · 输出 $0.3/1M API 文档 →
deepseek-v4-flash-0731对话、推理、代码、工具调用、思考模式可开关、版本固定/chat/completions 输入 $0.13/1M · 输出 $0.51/1M API 文档 →
glm-5.3对话、代码、Agent 工作流、推理、中英文写作、工具调用/chat/completions 输入 $1.12/1M · 输出 $3.52/1M API 文档 →
qwen3.8-max推理、代码、Agent 与工具调用、中英文写作、图片理解/chat/completions 输入 $1.4/1M · 输出 $4.2/1M API 文档 →
qwen3.8-flash大批量对话、分类与抽取、摘要改写、图片理解与 OCR、工具调用/chat/completions 输入 $0.1/1M · 输出 $0.33/1M API 文档 →
grok-4.7复杂推理、代码、长文档分析、工具调用、结构化输出、图片理解/chat/completions 输入 $0.3/1M · 输出 $0.9/1M API 文档 →
veo-3.1短片、产品动效、首尾帧过渡、商业成片/videos/generations $0.2 /条起 API 文档 →
gemini-omni-flash多镜头短片、分镜叙事、首尾帧过渡/videos/generations $0.05 /秒 API 文档 →
kling-4.0人物动作、产品短片、参考视频动作复刻/videos/generations $0.09 /秒 API 文档 →
seedance-2.5-token文字、图片、视频与音频参考/videos/generations $7.50–13.75 /1M video tokens API 文档 →
seedance-2.5-token-draft文字、图片、视频与音频参考/videos/generations $7.50–12.50 /1M video tokens API 文档 →
seedance-2.5长镜头短片、多参考素材、商业成片/videos/generations $0.158 /秒 API 文档 →
seedance-2.0短片、商业素材/videos/generations $0.15 /秒 API 文档 →
seedance-2.0-fast批量素材、快速验证创意/videos/generations $0.075 /秒 API 文档 →
seedance-2.0-clip真人出镜短片、带货视频、批量成片/videos/generations $1.0 /条起 API 文档 →
seedance-2.5-30s长镜头叙事、带货长片/videos/generations $2.0 /条起 API 文档 →
wan3.0-video长镜头叙事、多素材合成、视频改写/videos/generations $0.065 /秒 API 文档 →
wan3.0-video-prime赶工期的成片、批量试拍/videos/generations $0.112 /秒 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-luna gpt-6-astra gpt-6.1-sol gpt-6-sol gpt-6-luna gpt-image-2 gpt-image-2.5-flare gpt-image-2.5-sunburst nano-banana-2 nano-banana-pro nano-banana-2.1 grok-imagine-image grok-imagine-image-quality claude-sonnet-4-6 claude-opus-5 claude-fable-5 claude-opus-5-5 claude-sonnet-5-5 gemini-4-argon gemini-3.1-pro gemini-3.8-flash deepseek-v4.1-flash deepseek-v4-flash-0731 glm-5.3 qwen3.8-max qwen3.8-flash grok-4.7 veo-3.1 gemini-omni-flash kling-4.0 seedance-2.5-token seedance-2.5-token-draft seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-clip seedance-2.5-30s wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

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

一步步的客户端接入教程:SillyTavern · Cherry Studio · Cline

原生 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 / claude-opus-5-5 / claude-sonnet-5-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-5、claude-sonnet-5-5、claude-opus-5、claude-sonnet-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 直链,保留 15 天)。单条约 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": "fast", "resolution": "1080p", "size": "16:9"}'
curl · 轮询结果
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

可用视频模型:veo-3.1 gemini-omni-flash kling-4.0 seedance-2.5-token seedance-2.5-token-draft seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-clip seedance-2.5-30s wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

Webhook:任务结束自动通知

视频和图片都是异步任务:提交后拿到任务 ID,过一会儿才出结果。不想反复查询的话,可以让我们在任务结束时把结果推送到你的服务器,余额不足时也可以提醒你。

不想轮询?提交时加上 callback_url,任务结束后我们把结果推送到你的服务器;也可以在控制台设置默认推送地址。 Webhook 文档 →

Agent Skills:在 AI 编程助手里一句话生成视频

给 Claude Code、Codex、Cursor 等支持 skill 的助手装上 NezhaGate 的 skill,直接说「用 seedance-2.5 把这张图做成 8 秒的视频,存到 ./out」,助手会自己选模型、上传素材、等待渲染并把成片存下来。目前提供 Seedance 2.5 / 2.0 视频 skill。

一行安装
npx skills add https://nezhagate.com
设置 API Key
export NEZHAGATE_API_KEY=YOUR_API_KEY

github.com/gaoorange/nezhagate-skills · 演示视频(8 秒,一次请求生成)

复制给 AI 的接入说明

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

AI Integration Prompt
请使用 OpenAI-compatible API 接入 NezhaGate。
Base URL: https://nezhagate.com/v1
API Key: 从环境变量 NEZHAGATE_API_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 / claude-opus-5-5 / claude-sonnet-5-5。
对话模型(/chat/completions):gpt-5.6-sol / gpt-5.6-luna / gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna / claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5 / gemini-4-argon / gemini-3.1-pro / gemini-3.8-flash / deepseek-v4.1-flash / deepseek-v4-flash-0731 / glm-5.3 / qwen3.8-max / qwen3.8-flash / grok-4.7
生图模型(文生图 /images/generations,图生图 /images/edits 或加 image 参数):gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / nano-banana-2 / nano-banana-pro / nano-banana-2.1 / grok-imagine-image / grok-imagine-image-quality
生视频模型(/videos/generations,异步任务;带参考图即图生视频,各模型怎么用参考图见各自的文档):veo-3.1 / gemini-omni-flash / kling-4.0 / seedance-2.5-token / seedance-2.5-token-draft / seedance-2.5 / seedance-2.0 / seedance-2.0-fast / seedance-2.0-clip / seedance-2.5-30s / 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 直链,保留 15 天,需要长期使用请下载转存)。不要在提交后直接读取 data。
要求(视频,异步任务):提交 /videos/generations 立刻返回 HTTP 202 与任务号(object=video.generation.job);随后轮询 GET /v1/videos/jobs/{id} 直到 status=succeeded,再读取 data[0].url(重托管 mp4 直链,保留 15 天)。出片时间因模型而异(一两分钟到一个多小时),失败全额退。

查询余额 / 用量

用任意一个 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"

错误码

/v1 接口的错误都用下面这个结构(/anthropic 接口沿用 Anthropic 的格式)。code 是稳定的机器可读标识,请按 code 判断,不要匹配 message 的文字。

error envelope
{
  "error": {
    "message": "human readable",
    "type": "invalid_request_error | authentication_error | permission_error | insufficient_quota | rate_limit_error | server_error",
    "code": "stable_snake_case",
    "param": "field_name_or_null"
  }
}
HTTP含义
400参数有误或模型不存在(如 model_not_found),error.param 指出是哪个字段。
401没带 Key,或 Key 无效、已停用(missing_api_key、invalid_api_key)。
402余额不足,或这把 Key 达到了预算上限(insufficient_quota)。
403这把 Key 的模型白名单里没有这个模型,或请求来自这把 Key 的 IP 白名单以外(permission_denied)。
404路径不存在;或任务号不存在、超过了 3 天的保存期、不是这个账号提交的(job_not_found)。
429超过了这把 Key 设置的每分钟请求数或免费模型的每日额度,或者这个模型暂时满载(rate_limit_exceeded)。有 Retry-After 头就按它等待,没有就等几秒再试。
502上游出错或超时,自动重试后仍然失败;code 写明原因,如 upstream_timeout、upstream_unavailable。没有计费,可以重试。
503模型维护中(model_maintenance),或我们这边临时出错(service_unavailable)。没有计费,稍后重试。

完整错误码列表 →

思考型模型的 max_tokens — Gemini 3.x Flash(3-flash-preview / 3.6 / 3.7 / 3.8 各档)先花预算做隐藏推理,再写可见答案,所以预算太小会在答案开始前就被耗尽:实测 max_tokens=16 直接失败,32 / 64 会返回一个看起来像答案的错值并带 finish_reason=length。网关已把这些模型的输出预算自动抬到至少 512(只按实际用量计费),但请在自己的请求里也写 ≥512;看到 finish_reason=length 一律当作可能被截断,加大 max_tokens 重试。

关于接入、计费、模型与安全的常见疑问。 NezhaGate 常见问题 →