快速开始

酷智AI开放平台提供 OpenAI 兼容 的对话 API。只需三步即可接入：

1. 在 用户中心 → API密钥 创建密钥（nh-* 开头）；
2. 将请求地址设置为 https://你的域名/api/chat/completions；
3. 携带 Authorization: Bearer <密钥> 发送 JSON 请求即可。

对话接口（流式）

POST /api/chat/completions
Content-Type: application/json
Authorization: Bearer nh-xxxx

{
  "model": "nova-chat",
  "messages": [
    {"role": "user", "content": "你好"}
  ],
  "stream": true
}

流式响应为 SSE（text/event-stream），每帧格式：

data: {"type":"meta","conv_id":123}
data: {"type":"search","results":[...]}   // 开启联网搜索时
data: {"type":"delta","content":"你"}     // 增量正文
data: {"type":"usage","tokens":42,"points":1}
data: {"type":"done"}

模型功能与使用教程

本站提供 语言 / 绘画 / 视频 / 3D / 音频 五大类模型能力。每一类都有独立的触发方式、参数与计费规则，下面按类别逐一说明「能做什么、怎么用、怎么接入」。

语言模型（对话 · 推理 · 编程 · 写作）

语言模型是平台的核心能力，覆盖日常问答、深度推理、编程开发、写作文案、办公效率、学习辅导等场景。不同模型定位不同，选对模型能显著提升效果与性价比。

# 对话触发（网页端）
在输入框直接输入问题，Enter 发送；Shift+Enter 换行。

# 指定模型的 API 调用（OpenAI 兼容）
{
  "model": "模型ID",
  "messages": [{"role": "user", "content": "帮我分析这段代码的时间复杂度"}],
  "stream": true
}

绘画模型（文生图 · 图生图）

输入一句画面描述即可出图，支持写实、插画、国风、赛博朋克等多种风格，并可指定尺寸、出图张数。绘画走 openai-image 协议，异步生成。

POST /api/images/generations
Authorization: Bearer nh-xxxx
{"model": "模型ID", "prompt": "一只在星空下奔跑的独角兽，赛博朋克风格", "n": 1, "size": "1024x1024"}

视频模型（文生视频 · 图生视频）

输入描述或上传图片即可生成短视频，支持人物一致性、镜头调度。视频走 openai-video 协议，为异步任务——提交后返回任务 ID，轮询进度获取成片地址。

POST /api/videos/generations
Authorization: Bearer nh-xxxx
{"model": "模型ID", "prompt": "无人机航拍雪山日出的 10 秒短片", "duration": 10}

3D 模型（文生 3D · 图生 3D）

输入描述或上传图片生成三维模型，产出标准 .glb 格式，可直接导入 Blender / Unity / Three.js 等工具，适合商品展示与人物建模。

POST /api/3d/generations
Authorization: Bearer nh-xxxx
{"model": "模型ID", "prompt": "一个 Q 版卡通风格的太空飞船", "format": "glb"}

音频模型（TTS 语音合成 · 文生音乐）

文字转语音（TTS）、语音识别（ASR）与文生音乐统一入口，音色自然、表现力强。语音能力需后台单独配置语音密钥（与文本模型分离）。

POST /api/audio/speech
Authorization: Bearer nh-xxxx
{"model": "语音模型ID", "input": "你好，欢迎使用 NovaHub", "voice": "音色ID"}

计费与常见问题

模型列表

请求 GET /api/models 返回当前可用模型（名称、类别、上下文长度、计费单价）。

认证与密钥

平台支持两种登录体系：账号密码（JWT 令牌，7 天有效）与 彩虹聚合登录（QQ/微信/支付宝等 10+ 平台）。API 调用统一使用 Bearer 令牌或 API 密钥。

聚合登录接入（彩虹协议）

平台已按彩虹聚合登录标准协议完成集成，后台「系统设置 → 聚合登录」填入 appid / appkey 即可启用：

Step1 获取跳转地址
GET {网关}/connect.php?act=login&appid={appid}&appkey={appkey}
    &type=qq&redirect_uri={https://你的域名/oauth}
→ {"code":0,"url":"https://第三方授权页"}

Step2 跳转到 url，授权后回跳 /oauth?type=qq&code=xxxx

Step3 换取用户信息
GET {网关}/connect.php?act=callback&appid=&appkey=&type=qq&code=xxxx
→ {"code":0,"social_uid":"...","nickname":"...","faceimg":"..."}

可选 主动查询用户信息
GET {网关}/connect.php?act=query&appid=&appkey=&type=qq&social_uid=xxx

平台侧自动完成「绑定 → 登录 / 自动注册」，登录方式支持 qq / wx / alipay / sina / baidu / douyin / huawei / xiaomi / bilibili / dingtalk。

聚合支付接入（彩虹易支付协议）

后台「系统设置 → 支付配置」填入网关地址、商户 ID（pid）与商户密钥（key）后即启用真实支付；未配置时自动进入演示收银台：

下单（API 模式 mapi.php）
POST {网关}/mapi.php
pid / type=alipay / out_trade_no / notify_url / return_url
name / money=29.00 / clientip / device=mobile
sign = md5(按ASCII升序拼接的参数串 + KEY)   // sign、sign_type、空值不参与

返回 JSON
{"code":1, "trade_no":"...", "payurl":"...", "qrcode":"..."}

异步通知 notify_url（GET）
pid / trade_no / out_trade_no / type / name / money
trade_status=TRADE_SUCCESS / sign / sign_type
→ 验签通过后返回纯文本 "success"

多模态能力（图像 · 视频 · 语音）

除文本对话外，平台已打通 文生图 / 文生视频 / 语音合成（TTS）/ 语音识别（ASR） 四类多模态能力，均通过「工具」「场景」或对话指令触发（非独立 OpenAI 端点，无需额外对接）：

示例代码

PHP 非流式调用
$ch = curl_init('https://你的域名/api/chat/completions');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Authorization: Bearer nh-xxxx',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'nova-chat',
    'messages' => [['role' => 'user', 'content' => '你好']],
  ]),
  CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);