把你现有的 OpenAI SDK、Chatbox、Cherry Studio、LangChain、沉浸式翻译等工具,直接切到 novaapi.com.cn 即可接入。接口格式保持兼容,主要改 base_url 和 api_key。
https://novaapi.com.cn/v1
鉴权方式Authorization: Bearer sk-你的令牌
接口格式OpenAI Chat Completions / Images / Responses 兼容
适用场景对话、推理、图片生成、视频生成、向量检索
base_url 改成 https://novaapi.com.cn/v1,其余代码尽量不动。最小接入只需要三步:获取令牌、替换 base_url、选择模型名。
from openai import OpenAI
client = OpenAI(
base_url="https://novaapi.com.cn/v1",
api_key="sk-你的令牌",
)
resp = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[{"role": "user", "content": "你好,介绍一下你自己"}],
)
print(resp.choices[0].message.content)
以下按功能分组。你可以把它理解成“上游能力清单”,但最终以后台实际接入为准。
| 模型 | 说明 | 建议场景 |
|---|---|---|
| gpt-5.5 | OpenAI 旗舰模型 | 高质量对话、复杂推理 |
| claude-opus-4-8 | Anthropic 旗舰模型 | 长文写作、代码、分析 |
| gemini-3.1-pro-preview | Google 旗舰模型 | 多模态、长上下文 |
| claude-sonnet-5 | Claude 主力模型 | 日常高质量问答 |
| glm-5.2 | 智谱主力模型 | 中文场景、企业应用 |
| kimi-k2.5 | 长上下文模型 | 长文档、长对话 |
| deepseek-v4-pro | 推理旗舰 | 性价比和推理兼顾 |
| DeepSeek-V3.2 | 通用模型 | 高并发、走量 |
| gpt-5-mini | 轻量模型 | 低成本、快速响应 |
| gemini-3-flash-preview | 轻量多模态 | 高并发 |
| 模型 | 说明 | 场景 |
|---|---|---|
| text-embedding-3-small | OpenAI 向量模型 | 语义检索、RAG |
| bge-m3 | 多语向量模型 | 中文 / 多语言检索 |
| 模型 | 说明 | 备注 |
|---|---|---|
| gpt-image-2 | OpenAI 图片模型 | 标准图像生成 |
| gemini-3.1-flash-image | 快速出图 | 偏速度 |
| gemini-3-pro-image-preview | 高质量出图 | 偏质量 |
| doubao-seedream-4-5-251128 | 豆包出图 | 尺寸要求以后台为准 |
| 模型 | 说明 | 调用方式 |
|---|---|---|
| wan2.6-t2v | 通义万相文生视频 | 先提交任务,再轮询结果 |
| kling-v3 | 可灵文生视频 | 先提交任务,再轮询结果 |
这里不做固定榜单数字,避免和实际可用性、渠道权重、倍率设置冲突。你如果后面真要展示排行榜,建议直接从后台数据动态生成,而不是写死在静态文档里。
curl https://novaapi.com.cn/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [{"role": "user", "content": "你好"}]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://novaapi.com.cn/v1",
api_key="sk-你的令牌",
)
resp = client.chat.completions.create(
model="claude-opus-4-8",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://novaapi.com.cn/v1",
apiKey: "sk-你的令牌",
});
const resp = await client.chat.completions.create({
model: "gpt-5.5",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
resp = client.chat.completions.create(
model="gemini-3.1-pro-preview",
messages=[{"role": "user", "content": "写一首关于桥的短诗"}],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="")
图片接口一般使用 POST /v1/images/generations。
curl https://novaapi.com.cn/v1/images/generations \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-image",
"prompt": "a red fox sitting in a snowy forest, cinematic",
"n": 1,
"size": "1024x1024"
}'
视频通常是异步任务:先提交,再轮询结果。不同模型的参数字段可能不同,以下是通用思路。
# 1) 提交任务
curl https://novaapi.com.cn/v1/responses \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.6-t2v",
"input": "一只金色的狐狸在雪地里奔跑,电影质感",
"parameters": { "size": "1280*720", "duration": 2 }
}'
# 2) 轮询结果
curl https://novaapi.com.cn/v1/responses \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{ "model": "wan2.6-get", "input": "刚才返回的 task_id" }'
# 1) 提交任务
curl https://novaapi.com.cn/v1/responses \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-v3",
"input": "一只金色的狐狸在雪地里奔跑,电影质感",
"parameters": { "duration": 3, "mode": "std" }
}'
# 2) 轮询结果
curl https://novaapi.com.cn/v1/responses \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{ "model": "kling-v3-get-all", "input": "刚才返回的 taskId" }'
如果你要把这套站点继续接进 new-api,下面这些文件就是核心入口。文档页已经按这些文件的职责拆好了,方便你后续直接维护。
| 文件 | 作用 | 说明 |
|---|---|---|
| custom-frontend/index.html | 首页 SEO 与入口 | 控制首页标题、描述、 canonical 和分享信息。 |
| custom-frontend/public/docs.html | 公开文档页 | 你现在看到的这份文档,直接对外提供接入说明。 |
| custom-frontend/src/pages/Home/index.jsx | 首页结构 | 组合 Header、Hero、模型墙、特性、示例、定价、CTA 和 Footer。 |
| custom-frontend/src/pages/Home/sections/Header.jsx | 顶栏导航 | 负责首页顶部菜单和文档入口。 |
| custom-frontend/src/pages/Home/sections/Hero.jsx | 首屏主视觉 | 负责品牌主张、首屏文案和主 CTA。 |
| custom-frontend/src/pages/Home/sections/ModelGrid.jsx | 模型列表 | 展示已接通的模型能力和文档入口。 |
| custom-frontend/src/pages/Home/sections/Features.jsx | 卖点说明 | 展示兼容性、国内直连和冗余能力。 |
| custom-frontend/src/pages/Home/sections/CodeExample.jsx | 接入示例 | 展示 cURL、Python、Node.js 三种调用方式。 |
| custom-frontend/src/pages/Home/sections/Pricing.jsx | 定价入口 | 这里不硬写价格,改成指向文档,避免信息过期。 |
| custom-frontend/src/pages/Home/sections/Footer.jsx | 页脚导航 | 补充文档、定价、服务状态等入口。 |
| custom-frontend/接入说明.md | 接入操作手册 | 告诉你怎么把这套前端接回 new-api 源码并重新构建。 |
这是你的 OpenAI 兼容中转站文档页,主要面向直接接入 SDK、CLI 和第三方客户端的用户。
因为主页负责转化,文档负责接入。两个页面职责分开,客户更容易看懂,也更方便后续维护。
写基础地址、鉴权方式、可用模型、调用示例、常见问题和文件清单就够了,其他运营信息尽量放后台动态配置。