快速开始

几分钟内完成 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 地址即可。

四、模型列表

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

提供商	模型名称	状态
OpenAI	gpt-4o	✅ 可用
OpenAI	gpt-4o-mini	✅ 可用
OpenAI	o1 / o3	✅ 可用
Anthropic	claude-sonnet-3.5	✅ 可用
Google	gemini-2.0-pro	✅ 可用
Google	gemini-2.0-flash	✅ 可用
DeepSeek	deepseek-chat	✅ 可用
DeepSeek	deepseek-reasoner	✅ 可用
Meta	llama-3.1-405b	✅ 可用
Mistral	mistral-large	✅ 可用

完整模型列表请登录后台「模型」页面查看，所有已配置的模型均可直接调用。

五、配置示例

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

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="gpt-4o",
    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: 'gpt-4o',
    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": "gpt-4o",
    "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	是	模型名称，如 gpt-4o
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="gpt-4o",
    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 或地址。