Nicole-Ai API 使用文档

本文档用于帮助用户快速接入 Nicole-Ai API 中转服务。平台采用 OpenAI 兼容接口格式， 可用于 AI 聊天、AI 应用开发、插件调用、第三方客户端配置、自动化工具和企业内部项目接入。

统一接口信息

快速开始

使用 Nicole-Ai API 一般只需要以下几个步骤：

模型名称说明

调用 API 时，必须填写模型名称。模型名称需要与 Nicole-Ai 控制台或模型列表中显示的名称保持一致。

常见请求体示例

复制{
  "model": "gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下 Nicole-Ai"
    }
  ],
  "temperature": 0.7
}

分组说明

如果平台开启了分组功能，不同分组可能对应不同额度、倍率或模型权限。用户在使用前可以在控制台查看自己的分组信息。

如何创建 API 令牌

令牌安全建议

使用日志查看

如果调用失败或余额消耗异常，可以在控制台查看调用日志。日志通常会显示请求时间、模型名称、消耗额度、错误原因等信息。

ChatBox 配置教程

ChatBox 是常见的 AI 聊天客户端，可以通过 OpenAI 兼容方式接入 Nicole-Ai。

Open WebUI 配置教程

Open WebUI 可以通过 OpenAI API 兼容接口连接 Nicole-Ai。

LobeChat 配置教程

LobeChat 支持自定义 OpenAI 兼容接口，可以接入 Nicole-Ai。

cURL 调用示例

你可以使用下面的命令快速测试接口是否可用。

复制curl https://nicolessss.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下 Nicole-Ai"
      }
    ]
  }'

Python 调用示例

安装 OpenAI SDK：

复制pip install openai

调用示例：

复制from openai import OpenAI

client = OpenAI(
    api_key="你的_API_KEY",
    base_url="https://nicolessss.cn/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {
            "role": "user",
            "content": "你好，请介绍一下 Nicole-Ai"
        }
    ]
)

print(response.choices[0].message.content)

Node.js 调用示例

安装 OpenAI SDK：

复制npm install openai

调用示例：

复制import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的_API_KEY",
  baseURL: "https://nicolessss.cn/v1"
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [
      {
        role: "user",
        content: "你好，请介绍一下 Nicole-Ai"
      }
    ]
  });

  console.log(completion.choices[0].message.content);
}

main();

常见错误

常见问题

1. Base URL 应该怎么填？

请填写：

复制https://nicolessss.cn/v1

2. Chat 接口地址是什么？

Chat Completions 接口地址为：

复制https://nicolessss.cn/v1/chat/completions

3. API Key 在哪里获取？

登录 Nicole-Ai 控制台后，在令牌管理或 API Key 页面创建并复制。

4. 为什么提示模型不存在？

一般是模型名称填写错误，或者当前账号/分组没有该模型权限。请以控制台显示的模型名称为准。

5. 可以用于哪些场景？

可以用于 AI 聊天客户端、自动化脚本、网站应用、企业内部工具、知识库问答、插件开发等场景。

联系客服

如果你在使用 Nicole-Ai API 时遇到充值、模型调用、接口配置、令牌创建、余额异常等问题，可以联系客服协助处理。