外观
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。
第一次调用
bash
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
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
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 接口 |
| 用 Claude 原生格式调用 | Anthropic Messages 接口 |
| 用 Gemini 原生格式调用 | Gemini 接口 |
| 边生成边输出 | 流式输出(SSE) |
| 让模型调用函数 | 工具调用(Function Calling) |
| 发送图片让模型识别 | 图片输入(Vision) |
| 处理 429、超时和重试 | 限流、超时与重试 |
模型名从哪里来
model 字段填 模型广场 中显示的模型名,大小写和连字符都要一致。不同分组可用的模型不同,调用前先确认密钥分组覆盖了该模型。