Source: https://wiki.niceai.dev/guide/api/

# API 接口总览

NiceAI 提供三种协议的接口：**OpenAI 兼容**（`https://api.niceai.dev/v1`）、**Anthropic Messages**（`https://api.niceai.dev`，不加 `/v1`）和 **Gemini**（`https://api.niceai.dev/v1beta`）。请求格式与各家官方接口一致，换掉 Base URL 和密钥即可。

## 三种协议速查

| 协议 | Base URL | 主要路径 | 鉴权请求头 | 密钥分组 |
| --- | --- | --- | --- | --- |
| OpenAI 兼容 | `https://api.niceai.dev/v1` | `/chat/completions`、`/responses` | `Authorization: Bearer <密钥>` | OpenAI（其他分组以控制台说明为准） |
| Anthropic Messages | `https://api.niceai.dev` | `/v1/messages` | `x-api-key: <密钥>` 或 `Authorization: Bearer <密钥>` | Claude |
| Gemini | `https://api.niceai.dev/v1beta` | `/models/{模型}:generateContent` | `x-goog-api-key: <密钥>` | Gemini |

**为什么 Anthropic 不加 /v1**
Anthropic SDK 和 Claude Code 会自己在 Base URL 后面拼接 `/v1/messages`；OpenAI SDK 只拼接 `/chat/completions`，所以 `/v1` 要写在 Base URL 里。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。


## 第一次调用

**-group**

```bash [OpenAI 兼容]
curl https://api.niceai.dev/v1/chat/completions \
  -H "Authorization: Bearer $NICEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名，见模型广场>",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

```bash [Anthropic]
curl https://api.niceai.dev/v1/messages \
  -H "x-api-key: $NICEAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名，见模型广场>",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

```bash [Gemini]
curl "https://api.niceai.dev/v1beta/models/<模型名>:generateContent" \
  -H "x-goog-api-key: $NICEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "你好"}]}]}'
```



运行前先把密钥存进环境变量：macOS / Linux 用 `export NICEAI_API_KEY="sk-..."`，Windows PowerShell 用 `$env:NICEAI_API_KEY = "sk-..."`。

## 按功能查文档

| 想做什么 | 文档 |
| --- | --- |
| 发起对话、了解常用参数 | [Chat Completions 接口](https://wiki.niceai.dev/guide/api/chat-completions) |
| 用 Claude 原生格式调用 | [Anthropic Messages 接口](https://wiki.niceai.dev/guide/api/anthropic-messages) |
| 用 Gemini 原生格式调用 | [Gemini 接口](https://wiki.niceai.dev/guide/api/gemini) |
| 边生成边输出 | [流式输出（SSE）](https://wiki.niceai.dev/guide/api/streaming) |
| 让模型调用函数 | [工具调用（Function Calling）](https://wiki.niceai.dev/guide/api/tools) |
| 发送图片让模型识别 | [图片输入（Vision）](https://wiki.niceai.dev/guide/api/vision) |
| 处理 429、超时和重试 | [限流、超时与重试](https://wiki.niceai.dev/guide/api/rate-limits) |

## 模型名从哪里来

`model` 字段填 [模型广场](https://niceai.dev/model-plaza) 中显示的模型名，大小写和连字符都要一致。不同分组可用的模型不同，调用前先确认密钥分组覆盖了该模型。

## 下一步

- [Chat Completions 接口](https://wiki.niceai.dev/guide/api/chat-completions)
- [API 密钥安全最佳实践](https://wiki.niceai.dev/guide/key-security)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
