OpenAI 兼容 · 统一鉴权 · 一套 Key 调全部模型

智桥 API 文档

把你现有的 OpenAI SDK、Chatbox、Cherry Studio、LangChain、沉浸式翻译等工具,直接切到 novaapi.com.cn 即可接入。接口格式保持兼容,主要改 base_urlapi_key

基础地址https://novaapi.com.cn/v1 鉴权方式Authorization: Bearer sk-你的令牌 接口格式OpenAI Chat Completions / Images / Responses 兼容 适用场景对话、推理、图片生成、视频生成、向量检索
建议先在控制台创建令牌,再把应用里的 base_url 改成 https://novaapi.com.cn/v1,其余代码尽量不动。

快速说明

  • 接口需要有效令牌,未授权会返回 401。
  • 模型名请严格使用文档里的英文标识。
  • 视频类任务一般是异步提交,之后轮询结果。
  • 价格、可用模型和权限以控制台实际配置为准。
请不要把令牌公开到前端代码、仓库或截图里。

01快速开始

最小接入只需要三步:获取令牌、替换 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)

02模型广场

以下按功能分组。你可以把它理解成“上游能力清单”,但最终以后台实际接入为准。

对话 / 文本

模型说明建议场景
gpt-5.5OpenAI 旗舰模型高质量对话、复杂推理
claude-opus-4-8Anthropic 旗舰模型长文写作、代码、分析
gemini-3.1-pro-previewGoogle 旗舰模型多模态、长上下文
claude-sonnet-5Claude 主力模型日常高质量问答
glm-5.2智谱主力模型中文场景、企业应用
kimi-k2.5长上下文模型长文档、长对话
deepseek-v4-pro推理旗舰性价比和推理兼顾
DeepSeek-V3.2通用模型高并发、走量
gpt-5-mini轻量模型低成本、快速响应
gemini-3-flash-preview轻量多模态高并发

向量 / Embedding

模型说明场景
text-embedding-3-smallOpenAI 向量模型语义检索、RAG
bge-m3多语向量模型中文 / 多语言检索

图片生成

模型说明备注
gpt-image-2OpenAI 图片模型标准图像生成
gemini-3.1-flash-image快速出图偏速度
gemini-3-pro-image-preview高质量出图偏质量
doubao-seedream-4-5-251128豆包出图尺寸要求以后台为准

视频生成

模型说明调用方式
wan2.6-t2v通义万相文生视频先提交任务,再轮询结果
kling-v3可灵文生视频先提交任务,再轮询结果
模型的价格、上下文长度和是否可用,建议以后都以控制台/后台实际为准,不要在首页硬写死。

03排行榜

这里不做固定榜单数字,避免和实际可用性、渠道权重、倍率设置冲突。你如果后面真要展示排行榜,建议直接从后台数据动态生成,而不是写死在静态文档里。

推荐展示方式

04调用示例

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="")

04图片与视频

图片生成

图片接口一般使用 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" }'
如果返回的是 JSON 文本包裹的任务信息,优先解析其中的任务 ID 和状态字段,再按 5 到 10 秒轮询一次。

05文件清单

如果你要把这套站点继续接进 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 源码并重新构建。
如果你是要继续同步上游结构,优先维护这份文件清单和首页各区块,而不是把内容散在多个不相关页面里。

06关于

这个站是做什么的?

这是你的 OpenAI 兼容中转站文档页,主要面向直接接入 SDK、CLI 和第三方客户端的用户。

为什么要单独做文档?

因为主页负责转化,文档负责接入。两个页面职责分开,客户更容易看懂,也更方便后续维护。

文档里写什么最稳?

写基础地址、鉴权方式、可用模型、调用示例、常见问题和文件清单就够了,其他运营信息尽量放后台动态配置。

请妥善保管你的令牌。若令牌泄露,建议立即在控制台删除并重新生成。