快速开始

NoviaHub 兼容 OpenAI、Anthropic 和 Gemini 三种接口协议。已经在用这些官方 SDK 的代码，只要换掉接口地址和 API Key，就能调用 NoviaHub 上的模型。

1. 创建 API Key

   登录 noviahub.com（登录方式见 登录与账户），打开控制台的 API 密钥 页面，点击「创建 API 密钥」，填一个名称后点「保存更改」。然后点击列表里被遮住的密钥，复制完整的 Key（以 sk- 开头）。每个选项的含义见 API 密钥。

   调用按用量从账户余额扣费，余额不足时请求会返回错误。可以先到 钱包 充值，见 钱包与充值。

2. 把 Key 设为环境变量

   把 Key 存进环境变量，代码和工具从环境变量读取，就不用把 Key 直接写在代码里。下面的命令只对当前终端窗口有效；想长期生效，把它加到 ~/.zshrc 或 ~/.bashrc 末尾。

   macOS / Linux

   export NOVIAHUB_API_KEY="sk-..."

   Windows PowerShell

   $env:NOVIAHUB_API_KEY = "sk-..."

   变量名

   本文档统一使用 NOVIAHUB_API_KEY 这个变量名。在 NoviaHub 网站模型详情的「API 接入」里复制出来的示例用的是 NEW_API_KEY。两者只是名字不同，选一个用到底即可，不要混用。

   警告

   Key 等同于账户的支付凭证。不要把它写进前端代码、提交到代码仓库或发到聊天里；泄露后请在「API 密钥」页面删除并重新创建。

3. 发出第一个请求

   下面用 OpenAI 兼容的 Chat Completions 接口调用 deepseek-v4-flash。换成其他模型只需修改 model，可用的模型 ID 见 模型&价格。

   cURL

   curl https://noviahub.com/v1/chat/completions \
     -H "Authorization: Bearer $NOVIAHUB_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "deepseek-v4-flash",
       "messages": [{"role": "user", "content": "用一句话介绍你自己。"}]
     }'

   Python

   import os
   
   from openai import OpenAI
   
   client = OpenAI(
       base_url="https://noviahub.com/v1",
       api_key=os.environ["NOVIAHUB_API_KEY"],
   )
   
   completion = client.chat.completions.create(
       model="deepseek-v4-flash",
       messages=[{"role": "user", "content": "用一句话介绍你自己。"}],
   )
   
   print(completion.choices[0].message.content)

   TypeScript

   import OpenAI from 'openai'
   
   const client = new OpenAI({
     baseURL: 'https://noviahub.com/v1',
     apiKey: process.env.NOVIAHUB_API_KEY,
   })
   
   const completion = await client.chat.completions.create({
     model: 'deepseek-v4-flash',
     messages: [{ role: 'user', content: '用一句话介绍你自己。' }],
   })
   
   console.log(completion.choices[0].message.content)

   返回结果里的 choices[0].message.content 就是模型的回答。每次调用的用量和费用可以在控制台的「使用日志」里查看。

接口地址

三种协议共用同一个 API Key，区别在于接口地址和放 Key 的请求头：

协议	SDK 的 base URL	鉴权请求头
OpenAI 兼容	https://noviahub.com/v1	Authorization: Bearer <Key>
Anthropic Messages	https://noviahub.com	x-api-key: <Key>，也接受 Authorization: Bearer <Key>
Gemini	https://noviahub.com	x-goog-api-key: <Key>

Anthropic 和 Google Gen AI 的 SDK 会自己在地址后面拼上 /v1/messages、/v1beta/models/...，所以 base URL 只填域名，不要带 /v1。

每个模型支持哪些协议，可以在 模型&价格 打开模型详情查看；详情里的「API 接入」还能直接复制按该模型生成好的代码示例和编程 Agent 配置。

下一步

接入 Claude Code让 Claude Code 通过 NoviaHub 调用模型。

接入 Codex在 Codex 里添加 NoviaHub 作为模型提供方。

API 参考各协议的接口、参数与返回格式。

计费计费规则、余额与用量明细。