快速开始

几分钟内完成 Noxtra 接口配置，开始调用全球主流大模型。

一、账号注册

注册与充值

访问 Noxtra 首页，点击「快速开始」或「免费开始使用」注册账号。
通过联系页面添加客服微信，告知你的账号用户名和充值金额，微信转账。
客服确认后会在后台人工为你的账号加上余额，随后即可使用 API 服务。

💡

说明：当前充值采用人工处理（微信转账 + 后台手动加款），一般即时完成；加款记录和余额在后台随时可查。

二、获取 API Key

登录 Noxtra 后台管理系统。
在左侧导航中找到「令牌」页面。
点击「添加令牌」，为你的应用创建一个新的 API Key。
妥善保管生成的 Key，它用于所有 API 请求的身份验证。

💡

提示：你可以创建多个令牌，分别用于不同项目或团队成员，方便分别管理用量和费用。

三、接口地址

主地址

一般情况下，直接使用以下主地址即可：

https://noxtra.cc

完整地址

如果你的客户端软件不会自动补全端点路径，请使用完整地址：

https://noxtra.cc/v1
https://noxtra.cc/v1/chat/completions

💡

兼容说明：Noxtra 接口完全兼容 OpenAI API 格式。如果你的项目已经使用 OpenAI SDK，只需把 baseURL 改为 Noxtra 地址即可。

四、模型列表

以下是当前支持的主流模型（持续更新中）：

提供商	模型名称	状态
DeepSeek	deepseek-v4-pro	✅ 可用
DeepSeek	deepseek-v4-flash	✅ 可用
OpenAI	gpt-5.5 等系列	🕐 接入中，即将开放
GPT 系列（企业渠道）	待公布	🕐 审批中，即将开放

完整模型列表请登录后台「模型」页面查看；模型是否可调用以实际渠道状态为准。

五、计费说明

Noxtra 统一按 Token 用量计费，以每百万 Token 为计价单位，输入和输出分别计费：

模型	输入（每百万 Token）	输出（每百万 Token）
deepseek-v4-pro	$0.62	$1.23
deepseek-v4-flash	$0.21	$0.41

每次调用的 Token 消耗和费用都会实时记录，登录后台「日志」页面可查看每一笔明细，余额变化透明可查。实际价格以控制台实时显示为准。

💡

省钱提示：DeepSeek 模型支持上下文缓存，缓存命中部分按超低价计费（命中读取约 $0.005/百万 Token），长上下文、多轮对话场景能显著降低成本。

六、配置示例

以下是常见开发环境的接入配置：

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://noxtra.cc/v1",
    api_key="sk-noxtra-xxxxxx"
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "user", "content": "你好，世界！"}
    ]
)
print(response.choices[0].message.content)

JavaScript / Node.js

import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://noxtra.cc/v1',
    apiKey: 'sk-noxtra-xxxxxx'
});

const res = await client.chat.completions.create({
    model: 'deepseek-v4-pro',
    messages: [{ role: 'user', content: 'Hello!' }]
});

console.log(res.choices[0].message.content);

cURL

curl https://noxtra.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-noxtra-xxxxxx" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

💡

任意 OpenAI 兼容客户端都可用：Cherry Studio、ChatBox、LobeChat、NextChat 等客户端，在设置中填入 Noxtra 地址和你的 Key 即可。

Chat Completions 接口

Endpoint：POST /v1/chat/completions

完全兼容 OpenAI Chat Completions API 规范。支持流式输出（stream）、多轮对话、System Prompt、Function Calling 等特性。

请求参数说明

参数	类型	必填	说明
model	string	是	模型名称，如 deepseek-v4-pro
messages	array	是	对话消息列表
stream	boolean	否	是否流式输出，默认 false
temperature	number	否	随机性 0-2，默认 1
max_tokens	integer	否	最大输出 Token 数
top_p	number	否	核采样参数 0-1

流式请求示例

from openai import OpenAI

client = OpenAI(
    base_url="https://noxtra.cc/v1",
    api_key="sk-noxtra-xxxxxx"
)

stream = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "写一首诗"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Embeddings 接口

Endpoint：POST /v1/embeddings

将文本转换为向量表示，用于语义搜索、文本分类等场景。

⏳

暂未开放：该接口所属渠道正在接入中，暂不可调用，开放后另行通知。以下示例供参考。

请求示例

from openai import OpenAI

client = OpenAI(
    base_url="https://noxtra.cc/v1",
    api_key="sk-noxtra-xxxxxx"
)

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="需要嵌入的文本内容"
)

print(response.data[0].embedding)

图片生成接口

Endpoint：POST /v1/images/generations

根据文本描述生成图片，兼容 OpenAI Images API。

⏳

暂未开放：该接口所属渠道正在接入中，暂不可调用，开放后另行通知。以下示例供参考。

请求示例

from openai import OpenAI

client = OpenAI(
    base_url="https://noxtra.cc/v1",
    api_key="sk-noxtra-xxxxxx"
)

response = client.images.generate(
    model="dall-e-3",
    prompt="一只在阳光下打盹的橘猫",
    size="1024x1024",
    quality="standard",
    n=1
)

print(response.data[0].url)

音频接口

Endpoint：POST /v1/audio/transcriptions

语音转文字（Speech to Text），兼容 OpenAI Audio API。

⏳

暂未开放：该接口所属渠道正在接入中，暂不可调用，开放后另行通知。以下示例供参考。

请求示例

from openai import OpenAI

client = OpenAI(
    base_url="https://noxtra.cc/v1",
    api_key="sk-noxtra-xxxxxx"
)

audio_file = open("recording.mp3", "rb")
transcript = client.audio.transcriptions.create(
    model="whisper-1",
    file=audio_file
)

print(transcript.text)

常见问题

Q: 如何注册账号？

访问首页点击「免费开始使用」，按引导完成注册即可，无需信用卡。

Q: 支持哪些支付方式？

目前采用人工充值：通过联系页面添加客服微信，微信转账后，客服会尽快在后台为你的账号手动加上余额。

Q: API 调用失败怎么办？

请先检查：① Key 是否正确；② 账户余额是否充足；③ 模型名称是否正确；④ 网络是否正常。如仍有问题，可通过联系页面联系客服协助排查。

Q: 有调用频率限制吗？

默认按账户余额和模型供应商的限制为准，具体可在后台「令牌设置」中自定义速率限制。

Q: 数据安全吗？

全程 HTTPS 加密传输。我们不会记录或存储你的对话内容，只记录调用次数和 Token 消耗用于计费。

Q: 如何切换模型？

只需修改请求中的 model 参数即可，无需更换 Key 或地址。