Skip to content

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、/responsesAuthorization: Bearer <密钥>OpenAI(其他分组以控制台说明为准)
Anthropic Messageshttps://api.niceai.dev/v1/messagesx-api-key: <密钥> 或 Authorization: Bearer <密钥>Claude
Geminihttps://api.niceai.dev/v1beta/models/{模型}:generateContentx-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 字段填 模型广场 中显示的模型名,大小写和连字符都要一致。不同分组可用的模型不同,调用前先确认密钥分组覆盖了该模型。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站