# 哪吒网关 NezhaGate — 开发者文档

OpenAI-compatible AI API 网关。Base URL: `https://nezhagate.com/v1`

## 认证
所有请求需带 Bearer Token：
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## 模型与价格
| 模型 | 能力 | 端点 | 价格 |
| --- | --- | --- | --- |
| gpt-5.5 | 对话、推理、Agent、结构化输出 | /chat/completions | 输入 $0.7/1M · 输出 $4.2/1M |
| gpt-image-2 | 文生图、图生图、封面、海报、插画 | /images/generations | 1K $0.015 · 2K $0.025 · 4K $0.04 |
| gemini-3.1-pro-preview | 对话、推理、超长上下文、多模态 | /chat/completions | 输入 $1.25/1M · 输出 $5.0/1M |
| gemini-3-pro-preview | 对话、推理、超长上下文、多模态 | /chat/completions | 输入 $1.25/1M · 输出 $5.0/1M |
| gemini-3-flash-preview | 对话、推理、高并发、低延迟 | /chat/completions | 输入 $0.3/1M · 输出 $1.2/1M |

## 文本对话 (Chat Completions)
`POST /v1/chat/completions`，支持 `stream: true` 流式输出。
```bash
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":"Hello"}]}'
```

## 图片生成 (Images)
`POST /v1/images/generations`
```bash
curl https://nezhagate.com/v1/images/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"gpt-image-2","prompt":"a poster","size":"1024x1024","n":1}'
```

## 错误码
| 状态码 | 含义 |
| --- | --- |
| 401 | API Key 缺失或无效 |
| 402 | 余额不足或 Key 超出限额 |
| 400 | 模型或参数不支持 |
| 429 | 上游限流 |
| 502 | 所有上游线路失败 |