快速开始
- 注册账号。新注册赠送 0.3 元使用金额,可直接创建 Key 试用。
- 控制台充值。支付宝最低 10 元,档位 10 / 20 / 50 / 100 / 200 / 500。其他额度可联系群主微信支付,大小额度都可以。
- 「API 密钥」→ 创建 Key,分组按用途选择(见下表,名称必须完全一致)。
- 客户端填 Base URL(请求地址)+ Key(令牌),按对应配置模型名。
分组与路由(必读)
客户端通常按 OpenAI 兼容格式发请求;哪吒 API 收到后,会按模型族转成渠道真正需要的协议再转发。因此:分组要对、请求地址要对、模型名要在该分组里。对话 / Codex / Claude / Gemini / Grok 的请求地址填 https://nezhai.vip/v1;生图 / 视频用 【生图组】 + 同一地址,或走创作台。
| 用途 | Key 分组 | 请求地址 | 站内转发 / 说明 |
|---|---|---|---|
| GPT 特价 / Codex | 【codex】GPT--特价×0.1 |
https://nezhai.vip/v1 |
Plus 号池,稳定渠道 |
| GPT 满血 | 【GPT】满血号池×0.23 |
https://nezhai.vip/v1 |
Pro 号池 |
| Claude 逆向 | 【claude-逆向分组】×0.6 |
https://nezhai.vip/(Claude Code)https://nezhai.vip/v1(OpenAI 客户端) |
自建号池保真 · Anthropic 原生 |
| Claude Max | 【claude -max】×1.4 |
https://nezhai.vip/(Claude Code)https://nezhai.vip/v1(OpenAI 客户端) |
官连满血 cc-max,保真高 SLA |
| Gemini / 小说 | 【哈基米----小说】×0.65 |
https://nezhai.vip/v1 |
Google Gemini 原生 |
| Grok | 【Grok-马斯克】×0.14 |
https://nezhai.vip/v1 |
grok-4.5 / grok-4.6,推荐 Grok Build 终端 |
| DeepSeek | 【DeepSeek】×0.16 |
https://nezhai.vip/v1 |
官转 Flash |
| 国产福利 | 【国产福利模型】×0.06 |
https://nezhai.vip/v1 |
福利模型,仅供学生助力 |
| 国产旗舰 | 【国产旗舰】×0.11 |
https://nezhai.vip/v1 |
kimi-k3 |
| 企业专线 | 【vip--企业专线】×1.4 |
https://nezhai.vip/v1 |
模型名必须带 -svip |
| 生图 / 视频 | 【生图组】×1.2 |
https://nezhai.vip/v1 或 创作台 |
按次固定价 |
Codex 配置
Codex 通常需要配置 config.toml 和 auth.json。配置完成后重启 Codex 生效。对话组选 【codex】GPT--特价 或 【GPT】满血号池;Grok 另选 【Grok-马斯克】。
配置文件位置
- Windows:
%USERPROFILE%\.codex\config.toml - Windows:
%USERPROFILE%\.codex\auth.json - macOS / Linux:
~/.codex/config.toml - macOS / Linux:
~/.codex/auth.json
model_provider = "NezhaAPI" model = "gpt-5.6-sol" review_model = "gpt-5.6-sol" model_reasoning_effort = "medium" disable_response_storage = true network_access = "enabled" windows_wsl_setup_acknowledged = true approval_policy = "never" sandbox_mode = "danger-full-access" [model_providers.NezhaAPI] name = "nezhai.vip" base_url = "https://nezhai.vip/v1" wire_api = "responses" requires_openai_auth = true
{
"OPENAI_API_KEY": "sk-替换为你的-哪吒API-Key"
}
gpt-5.6-luna 已下架,不要再填。
config.toml、auth.json 与 Base URL 不用改。Grok 走 Codex 时同样填 https://nezhai.vip/v1 + wire_api = "responses",但 Key 分组必须是 【Grok-马斯克】,模型填 grok-4.6 / grok-4.5。grok-4.5 / grok-4.6 推荐使用 Grok Build 终端。Claude Code
Key 分组选 【claude-逆向分组】 或满血官连 【claude -max】。配置完成后重启 Claude Code 生效。
配置文件位置
- Windows:
%USERPROFILE%\.claude\settings.json - macOS / Linux:
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://nezhai.vip/",
"ANTHROPIC_AUTH_TOKEN": "sk-替换为你的-哪吒API-Key",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"API_TIMEOUT_MS": "600000",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}
【claude -max】 另含满血官连
/v1/chat/completions。企业专线里的 claude-*-svip 不能混用这个分组。Gemini
客户端按 OpenAI 格式发对话,站内转 Google Gemini · Token 选 【哈基米----小说】 · 与 生图组 不是同一 Key
https://nezhai.vip/v1Authorization: Bearer sk-xxx【哈基米----小说】POST /v1/chat/completions→
识别哈基米分组→
Google Gemini 渠道
curl -X POST "https://nezhai.vip/v1/chat/completions" \
-H "Authorization: Bearer sk-替换为你的-哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro",
"messages": [{"role": "user", "content": "用一句话介绍你自己"}],
"max_tokens": 256,
"stream": true
}'
https://nezhai.vip/v1,模型填上表名称。Function Calling 报错时,可先关闭工具调用试纯对话。Grok
xAI 渠道 · Token 选 【Grok-马斯克】 · 推荐 Grok Build 终端 · 请求地址统一 /v1
https://nezhai.vip/v1Authorization: Bearer sk-xxx【Grok-马斯克】https://nezhai.vip/v1 + wire_api = "responses",但 Key 必须是 【Grok-马斯克】。不要把 Grok 模型填进 GPT / Claude / 生图组。Grok Build 是什么
xAI 官方编码 Agent 终端:可交互写代码,也支持 grok -p "提示词" 无界面调用,并能接 OpenAI 兼容中转 https://nezhai.vip/v1。
- 官网:https://x.ai/build
- 官方文档:https://docs.x.ai/build/overview
- 适用系统:Windows 10 / 11 x64;实测版本
grok 1.0.3 (1a29d5bc12) - 安装路径:
%USERPROFILE%\.local\bin\grok.exe
安装(Windows)
按官方脚本、WinGet 或手动下载三选一。装完必须新开终端再执行 grok --version。
irm https://x.ai/cli/install.ps1 | iex
脚本会下载 Windows 版、装到 %USERPROFILE%\.local\bin\grok.exe,并把该目录加入用户 PATH。
winget install -e --id xAI.GrokBuild --accept-package-agreements --accept-source-agreements
$dest = "$env:USERPROFILE\.local\bin"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
$exe = Join-Path $dest "grok.exe"
$tmp = "$env:TEMP\grok-1.0.3-windows-x86_64.exe"
Start-BitsTransfer -Source "https://x.ai/cli/grok-1.0.3-windows-x86_64.exe" -Destination $tmp
Copy-Item -Force $tmp $exe
Get-FileHash $exe -Algorithm SHA256
Get-AuthenticodeSignature $exe | Format-List Status, StatusMessage
$bin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$bin*") {
[Environment]::SetEnvironmentVariable("Path", "$userPath;$bin", "User")
}
$env:Path = "$bin;" + $env:Path
grok --version
D118DDEF0E14100C85154C114DA77E9074951903AC05753A1DF2F3413F55B4F7,签名状态 Valid,签名者 X.AI LLC。下坏的 grok.exe 体积看着对,启动会直接崩 0xc0000005。官网脚本装到更新版本时,以当前官网哈希为准。配置中转和令牌
Grok Build 默认走官方 https://api.x.ai/v1。改哪吒时不要只改 GROK_BASE_URL,必须同时改模型列表地址 GROK_MODELS_BASE_URL。
# Grok Build -> nezhai.vip [endpoints] models_base_url = "https://nezhai.vip/v1" [models] default = "grok-4.6" web_search = "grok-4.6" [model."grok-4.6"] model = "grok-4.6" base_url = "https://nezhai.vip/v1" name = "Nezhai Grok 4.6" api_key = "sk-替换为你的-哪吒API-Key" env_key = "NEZHAI_API_KEY" api_backend = "chat_completions" context_window = 200000
[model."grok-4.6"]。写成 [model.nezhai-grok-4.6] 时,TOML 会把最后的 .6 解析成子字段,配置会失效。api_backend = "chat_completions" 表示走 /v1/chat/completions。[Environment]::SetEnvironmentVariable("GROK_MODELS_BASE_URL", "https://nezhai.vip/v1", "User")
[Environment]::SetEnvironmentVariable("GROK_BASE_URL", "https://nezhai.vip/v1", "User")
[Environment]::SetEnvironmentVariable("XAI_API_KEY", "sk-替换为你的-哪吒API-Key", "User")
[Environment]::SetEnvironmentVariable("NEZHAI_API_KEY", "sk-替换为你的-哪吒API-Key", "User")
$env:GROK_MODELS_BASE_URL = "https://nezhai.vip/v1"
$env:GROK_BASE_URL = "https://nezhai.vip/v1"
$env:XAI_API_KEY = "sk-替换为你的-哪吒API-Key"
$env:NEZHAI_API_KEY = "sk-替换为你的-哪吒API-Key"
改完环境变量后关掉旧窗口,新开 PowerShell 再生效。
连通测试
$headers = @{
Authorization = "Bearer $env:NEZHAI_API_KEY"
"Content-Type" = "application/json"
}
Invoke-RestMethod -Uri "https://nezhai.vip/v1/models" -Headers $headers
$body = @{
model = "grok-4.6"
messages = @(@{ role = "user"; content = "ping" })
max_tokens = 32
} | ConvertTo-Json -Compress
curl.exe -sS -m 60 `
-H "Authorization: Bearer $env:NEZHAI_API_KEY" `
-H "Content-Type: application/json" `
-H "User-Agent: Mozilla/5.0" `
--data-binary $body `
https://nezhai.vip/v1/chat/completions
正常返回 HTTP 200,模型名类似 grok-4.6-build,内容类似 pong。再测终端:
grok --version grok models grok -p ping --no-alt-screen --max-turns 1 grok
实测通过时,grok models 会提示 You are using XAI_API_KEY.,默认模型 grok-4.6;grok -p ping 返回 pong。
一键脚本
保存为 install-grok-nezhai.ps1,把令牌换成自己的哪吒 Key 后执行。
$ErrorActionPreference = "Stop"
$Token = "sk-替换为你的-哪吒API-Key"
$BaseUrl = "https://nezhai.vip/v1"
$BinDir = Join-Path $env:USERPROFILE ".local\bin"
$Exe = Join-Path $BinDir "grok.exe"
$Tmp = Join-Path $env:TEMP "grok-1.0.3-windows-x86_64.exe"
$Expect = "D118DDEF0E14100C85154C114DA77E9074951903AC05753A1DF2F3413F55B4F7"
$Cfg = Join-Path $env:USERPROFILE ".grok\config.toml"
New-Item -ItemType Directory -Force -Path $BinDir | Out-Null
New-Item -ItemType Directory -Force -Path (Split-Path $Cfg) | Out-Null
if (-not (Test-Path $Exe)) {
Write-Host "Downloading official Grok Build..."
Start-BitsTransfer -Source "https://x.ai/cli/grok-1.0.3-windows-x86_64.exe" -Destination $Tmp
Copy-Item -Force $Tmp $Exe
}
$hash = (Get-FileHash $Exe -Algorithm SHA256).Hash
if ($hash -ne $Expect) {
throw "SHA256 mismatch: $hash"
}
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$BinDir*") {
[Environment]::SetEnvironmentVariable("Path", "$userPath;$BinDir", "User")
}
$env:Path = "$BinDir;$env:Path"
@"
# Grok Build -> nezhai.vip
[endpoints]
models_base_url = "$BaseUrl"
[models]
default = "grok-4.6"
web_search = "grok-4.6"
[model."grok-4.6"]
model = "grok-4.6"
base_url = "$BaseUrl"
name = "Nezhai Grok 4.6"
api_key = "$Token"
env_key = "NEZHAI_API_KEY"
api_backend = "chat_completions"
context_window = 200000
"@ | Set-Content -Path $Cfg -Encoding UTF8
[Environment]::SetEnvironmentVariable("GROK_MODELS_BASE_URL", $BaseUrl, "User")
[Environment]::SetEnvironmentVariable("GROK_BASE_URL", $BaseUrl, "User")
[Environment]::SetEnvironmentVariable("XAI_API_KEY", $Token, "User")
[Environment]::SetEnvironmentVariable("NEZHAI_API_KEY", $Token, "User")
$env:GROK_MODELS_BASE_URL = $BaseUrl
$env:GROK_BASE_URL = $BaseUrl
$env:XAI_API_KEY = $Token
$env:NEZHAI_API_KEY = $Token
Write-Host "Installed:"
& $Exe --version
& $Exe models
& $Exe -p ping --no-alt-screen --max-turns 1
常见坑
| 现象 | 原因 | 处理 |
|---|---|---|
grok.exe 启动秒崩,事件查看器 0xc0000005 |
安装包下坏,签名变成 HashMismatch |
重新下载并核对 SHA256 |
unknown model id |
配置段写成了 [model.xxx-4.6] |
改成 [model."grok-4.6"] |
还在请求 https://api.x.ai/v1/models |
只设了 GROK_BASE_URL |
再设 GROK_MODELS_BASE_URL 或 [endpoints] models_base_url |
This token has no access to model grok-4.5 |
中转站令牌只有 grok-4.6 |
把 default / web_search 都改成 grok-4.6 |
旧终端找不到 grok 或还在用旧配置 |
PATH / 环境变量未刷新 | 关掉窗口,新开 PowerShell |
Windows Terminal 报找不到 Build |
--title Grok Build 被拆成两个参数 |
标题不要有空格,或不要用 --title |
Python urllib 调中转返回 403 |
中转站拦了默认 UA | 加 User-Agent: Mozilla/5.0,或用 curl.exe |
日常命令
grok # 进入交互终端 grok -p "解释这段代码" # 一次性提问 grok models # 查看当前能用的模型 grok -m grok-4.6 # 指定模型启动 grok doctor # 检查终端环境 grok --version # 查看版本
配置与程序位置:%USERPROFILE%\.local\bin\grok.exe、%USERPROFILE%\.grok\config.toml、%USERPROFILE%\.grok\auth.json。
curl -X POST "https://nezhai.vip/v1/responses" \
-H "Authorization: Bearer sk-替换为你的-哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.6",
"input": "用一句话介绍你自己"
}'
POST /v1/chat/completions。Grok Build 默认就是这条。Codex 走 Grok 时用上面的 /v1/responses。国产与 DeepSeek
【DeepSeek】DeepSeek-V4-Flash-0731【国产旗舰】kimi-k3学生助力为福利档。路径统一 POST /v1/chat/completions,Base URL 仍是 https://nezhai.vip/v1。
企业专线
与普通分组共用 /v1 入口;Token 选 【vip--企业专线】,模型名须带 -svip 后缀(以控制台为准)
https://nezhai.vip/v1Authorization: Bearer sk-xxx【vip--企业专线】-svipPOST /v1/chat/completions→
分组 【vip--企业专线】→
模型填 xxx-svip
curl -X POST "https://nezhai.vip/v1/chat/completions" \
-H "Authorization: Bearer sk-替换为你的-哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol-svip",
"messages": [{"role": "user", "content": "你好"}],
"max_tokens": 256
}'
-svip 后缀的名称;反之亦然。Codex 用 gpt-5.6-sol-svip 时走 /v1/responses。单价见控制台「模型定价」,该组倍率为 1.4。生图 / 视频
创作台 · Token 选 【生图组】 · 请求地址填 https://nezhai.vip/v1
/v1/images/generations,带参考图走 /v1/images/edits→
Gemini 走 /v1beta/models/{model}:generateContent→
Firefly 系列仍走 /v1/chat/completions
网页创作台会按模型自动选协议。GPT Image 2 的 1K/2K/4K 对应 gpt-image-2 / gpt-image-2-2k / gpt-image-2-4k;GPT Image 2.5 固定 gpt-image-2.5,清晰度只改 size。Firefly 模型名仍按清晰度/比例拼接,例如 firefly-nano-banana2-2k-16x9。H3 视频走 POST /v1/videos 再轮询任务。
curl -X POST "https://nezhai.vip/v1/chat/completions" \
-H "Authorization: Bearer sk-替换为你的-哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "firefly-gpt-image-1k-1x1",
"stream": true,
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "白底电商主图,产品居中"}
]
}
]
}'
curl -X POST "https://nezhai.vip/v1/chat/completions" \
-H "Authorization: Bearer sk-替换为你的-哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "firefly-veo31-fast-4s-16x9-720p",
"stream": true,
"messages": [
{"role": "user", "content": "海边日落,镜头缓慢推进"}
]
}'
/v1/images/generations,参考图用 multipart /v1/images/edits(重复 image 字段,最多 7 张)。Gemini 图片走 generateContent。NanoBanana / GPT Image Firefly / VEO / 可灵 Omni 仍走聊天流式协议,不要把这几类请求套进 Image 2 的 JSON 体。生图模型规格
下表价格是生图组参考价:控制台按次价 × 1.2。同一系列不同比例单价相同。实际以定价页为准。
| 模型族 | 模型名规则 | 参考价 | 清晰度 | 常用比例 |
|---|---|---|---|---|
| GPT Image Firefly |
firefly-gpt-image-1k-1x1
前缀 + 清晰度 + 比例,如 2k-16x9、4k-9x16
|
1K ¥0.090 2K ¥0.144 4K ¥0.216 |
1K / 2K / 4K | 1x1, 16x9, 9x16, 4x3, 3x4, 3x2, 2x3, 5x4, 4x5, 21x9 |
| NanoBanana 2 |
firefly-nano-banana2-1k-1x1
前缀 + 清晰度 + 比例
|
1K ¥0.108 2K ¥0.198 4K ¥0.270 |
1K / 2K / 4K | 同上,另有 8x1 / 1x4 / 1x8 |
| NanoBanana Pro |
firefly-nano-banana-pro-1k-1x1
前缀 + 清晰度 + 比例
|
1K ¥0.162 2K ¥0.216 4K ¥0.306 |
1K / 2K / 4K | 1x1, 16x9, 9x16, 4x3, 3x4, 5x4, 4x5, 21x9 |
| GPT Image 2 简化名 |
gpt-image-2
gpt-image-2-2k
gpt-image-2-4k
|
默认 ¥0.050 2K ¥0.108 4K ¥0.180 |
默认 / 2K / 4K | 另有 medium ¥0.162、high ¥0.252。参考图最多 7 张。 |
| GPT Image 2.5 |
gpt-image-2.5
固定模型名,1K/2K/4K 只改 size
|
以定价页为准 | 1K / 2K / 4K | 质量档含 auto / high / xhigh / max。参考图走 /v1/images/edits。 |
| Gemini 生图 |
gemini-3-pro-image-preview
gemini-3.1-flash-image-preview
|
约 ¥0.023 / ¥0.022 | 1K / 2K | 走 generateContent,参考图用 inlineData。 |
| Agnes 2.1 Flash |
agnes-image-2.1-flash
档位式 size + ratio
|
免费 | 1K / 2K / 3K / 4K | 参考图放 extra_body.image。 |
Firefly 比例在模型名里写成 16x9,不要写成 16:9。GPT Image 2 / 2.5 参考图最多 7 张;Firefly 系列创作台最多 5 张。
视频模型规格
当前生图组渠道已挂载的视频模型如下。创作台页面里还有 Grok Video / Midjourney 入口,但渠道模型列表里尚未挂上,文档不把它写成可用。
| 模型族 | 模型名规则 | 参考价 | 清晰度 | 比例 | 时长 |
|---|---|---|---|---|---|
| VEO 3.1 Fast |
firefly-veo31-fast-4s-16x9-720p
前缀 + 时长s + 比例 + 清晰度
|
|
720p / 1080p | 16x9, 9x16 | 4 / 6 / 8 秒 |
| 可灵 Omni 参考 |
firefly-kling3omni-ref-5s-16x9-720p
前缀 + 时长s + 比例 + 清晰度
|
|
720p / 1080p | 16x9, 9x16 | 5 / 8 / 10 / 15 秒 |
常见问题
模型不存在 / 502 / 无权限?
先查 分组与路由:分组名必须整段复制,包括【】和中间的横线。Codex 别用 Claude / 哈基米 / 生图组;生图只用 【生图组】 + 创作台或 firefly 模型名。
API 地址填什么?
对话 / Codex / Claude / Gemini / Grok:https://nezhai.vip/v1。Claude Code 的 ANTHROPIC_BASE_URL 填 https://nezhai.vip/(不要加 v1)。客户端会自动补 /v1 时,主站填 https://nezhai.vip 即可。主站打不开时换备用 https://nezhai.dpdns.org。
Gemini 报模型不存在?
确认分组是 【哈基米----小说】,模型用上方列表中的名称(如 gemini-3.1-pro),不要套用其他站的 Gemini / Gemini-Pro 分组名。
Luna 不能用?
gpt-5.6-luna 已正式下架。改用 gpt-5.6-sol 或 gpt-5.6-terra。
生图 401 / 余额不足 / 没有图?
Token 分组必须是 【生图组】,Key 完整且未禁用,账户有余额。模型名要带清晰度和比例,例如 firefly-nano-banana2-1k-1x1。网页请走 创作台。
价格怎么算?
对话按 token 基价 × 分组倍率;生图/视频按次价 × 1.2。控制台「模型定价」是基价,创建 Key 时选的分组决定最终折扣。公开定价页:https://nezhai.vip/pricing。