OpenAI 兼容接口:一个端点、一把 Key 调用 GPT、Claude、Gemini、DeepSeek 等对话模型,以及图片和视频生成。下面的示例都能直接复制运行。
快速接入
替换 Base URL 和 API Key 后,现有 OpenAI SDK 可直接使用。
https://nezhagate.com/v1
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。
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-sol | Agentic 编程、复杂编码、专业文档与分析工作、推理、超长上下文、图片输入、结构化输出 | /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-argon | Beta · 推理 · 长上下文 | /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 URL | https://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、工具调用、提示缓存等原生特性完整保留。
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 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 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 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
export NEZHAGATE_API_KEY=YOUR_API_KEY
复制给 AI 的接入说明
把下面整段发给 Codex / Claude Code / Cursor,它就知道怎么接。也可以用右上角「复制页面」复制整篇文档。
请使用 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 https://nezhagate.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"
curl https://nezhagate.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"
错误码
/v1 接口的错误都用下面这个结构(/anthropic 接口沿用 Anthropic 的格式)。code 是稳定的机器可读标识,请按 code 判断,不要匹配 message 的文字。
{
"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 常见问题 →