商汤日日新 SenseNova API 配置指南（OpenAI 兼容模式）

一、简介与适用场景

日日新（SenseNova）是商汤科技的自研大模型开放平台，主力模型是 SenseChat 系列，此外还有视觉与多模态能力。它是国内合规平台，调用前需要完成账号实名。

额度方面，它走的是「开通后赠送体验 token，用完转按量计费」的路子，没有长期免费档。适合的场景是：需要一家已完成国内备案的模型厂商，或者你的业务本来就在商汤生态里。

⚠️ 待核实：本文中的 Base URL 与兼容端点路径按官方文档常见写法给出，商汤对不同模型系列存在多套接口地址。正式接入前请以控制台「接口地址」栏与官方文档为准。

二、注册与获取 Key

1. 打开 商汤日日新开放平台，注册并登录。
2. 完成企业或个人实名认证——未实名无法创建密钥。
3. 在控制台的「访问管理 / API Key」页面创建密钥。
4. 到模型列表中开通你要用的模型，部分模型需要单独申请权限。

三、Base URL 与鉴权

• Base URL：https://api.sensenova.cn/v1（待核实，以控制台展示为准）
• 鉴权方式：Authorization: Bearer <你的 Key>
• 对话端点：/chat/completions

商汤同时保留了原生 SenseNova 协议与 OpenAI 兼容协议，两者的请求体结构不同。原生协议部分场景要求用 AK/SK 换取带签名的 JWT 作为鉴权凭证，而兼容模式通常直接用 API Key 即可。如果你拿到的是 AK/SK 而不是单串 Key，说明走的是原生协议，请对照官方文档生成 JWT。

官方文档：www.sensenova.cn/docs

四、客户端接入示例

以 Cherry Studio 的「自定义 OpenAI 供应商」为例：

1. 「设置 → 模型服务 → 添加供应商」，类型选 OpenAI。
2. API 地址填控制台给出的兼容模式地址。
3. API 密钥填控制台创建的 Key。
4. 手动添加模型名（如 SenseChat-5），不要依赖自动拉取。
5. 先发一条短消息验证连通性，再进行长文本测试。

五、代码示例

curl：

curl https://api.sensenova.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SENSENOVA_API_KEY" \
  -d '{
    "model": "SenseChat-5",
    "messages": [{"role": "user", "content": "用一句话解释什么是 API"}]
  }'

Python：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SENSENOVA_API_KEY"],
    base_url="https://api.sensenova.cn/v1",
)

resp = client.chat.completions.create(
    model="SenseChat-5",
    messages=[{"role": "user", "content": "用一句话解释什么是 API"}],
)
print(resp.choices[0].message.content)

Node.js：

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.SENSENOVA_API_KEY,
  baseURL: 'https://api.sensenova.cn/v1',
});

const resp = await client.chat.completions.create({
  model: 'SenseChat-5',
  messages: [{ role: 'user', content: '用一句话解释什么是 API' }],
});
console.log(resp.choices[0].message.content);

六、常见错误排查