nTokenX 开发者文档

nTokenX 是一个统一的 AI API 网关，完全兼容 OpenAI 接口协议。把你现有代码里的 base_url 换成 nTokenX 地址、填入 nTokenX 密钥，即可访问平台聚合的多家大模型。

💡

完全兼容 OpenAI SDK无需改动业务逻辑，只需替换接入地址和 API Key，官方及各语言的 OpenAI SDK 都可直接使用。

快速开始 #

三步即可发出第一个请求：

登录控制台，在「令牌」页面创建一个 API Key。
将接入地址设为 https://api.ntokenx.com/v1。
用下面任意一种方式发起调用。

cURL

curl https://api.ntokenx.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NTOKENX_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好，介绍下你自己"}]
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ntokenx.com/v1",
    api_key="NTOKENX_API_KEY",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ntokenx.com/v1",
  apiKey: process.env.NTOKENX_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

认证与密钥 #

所有请求都通过 HTTP 头 Authorization 携带你的 API Key：

HTTP Header

Authorization: Bearer NTOKENX_API_KEY

🔒

妥善保管密钥API Key 拥有你账户的调用权限，切勿硬编码进前端或提交到代码仓库。建议放入环境变量，并为不同项目创建独立令牌以便单独管控额度与吊销。

接入地址 #

用途	地址
API 接口	`https://api.ntokenx.com/v1`

接口路径与 OpenAI 保持一致，例如 /v1/chat/completions、/v1/models。

对话补全 #

POST/v1/chat/completions

最核心的接口，用于多轮对话与文本生成。

请求示例

Request

{
  "model": "gpt-5.5",
  "messages": [
    {"role": "system", "content": "你是一个乐于助人的助手。"},
    {"role": "user", "content": "用一句话解释什么是 API 网关"}
  ],
  "temperature": 0.7,
  "max_tokens": 1024
}

响应示例

Response

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 28, "completion_tokens": 42, "total_tokens": 70}
}

流式输出 #

设置 "stream": true 即可通过 SSE（Server-Sent Events）逐字接收结果，适合聊天类实时场景。nTokenX 网关已针对流式做了透传优化，不做缓冲。

Python 流式

stream = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "写一首关于秋天的诗"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

⚡

流式响应的每个数据块以 data: 前缀返回，最后以 data: [DONE] 结束。

模型列表 #

GET/v1/models

返回当前令牌可用的模型清单。具体可用模型以控制台「模型」页面展示为准。

cURL

curl https://api.ntokenx.com/v1/models \
  -H "Authorization: Bearer $NTOKENX_API_KEY"

图像生成 #

POST/v1/images/generations

根据文本提示词生成图像。

Request

{
  "model": "gpt-image-2",
  "prompt": "一只在星空下奔跑的橘色狐狸，插画风格",
  "n": 1
}

📐

不支持 size 尺寸参数当前图像模型不接受 size（即使传入也会被忽略）。如需控制画面比例或尺寸，请直接在 prompt 里用文字描述，例如“竖版 9:16 构图”“正方形”“横版宽幅”等。

常用参数 #

参数	类型	说明
`model`	string	使用的模型名称，必填。
`messages`	array	对话消息数组，含 `role` 与 `content`。
`temperature`	number	采样温度，0–2，越高越随机，默认 1。
`max_tokens`	integer	生成的最大 token 数。
`top_p`	number	核采样，与 temperature 二选一。
`stream`	boolean	是否流式返回，默认 false。
`stop`	string / array	停止词。

错误码 #

接口沿用标准 HTTP 状态码，错误详情在响应体的 error 字段中：

状态码	含义	常见原因
`400`	请求错误	参数缺失或格式不正确。
`401`	未授权	API Key 无效或未提供。
`403`	禁止访问	令牌无权限或额度用尽。
`404`	未找到	模型名称或路径不存在。
`429`	请求过多	触发限流，请降低频率或重试。
`500`	服务器错误	上游异常，可稍后重试。

限流与配额 #

每个令牌可在控制台单独设置额度上限与到期时间。
触发限流会返回 429，建议实现指数退避重试。
用量、余额与调用日志均可在控制台实时查看。

常见问题 #

可以直接用 OpenAI 官方 SDK 吗？

可以。只需把 base_url/baseURL 指向 https://api.ntokenx.com/v1，并使用 nTokenX 的 API Key 即可。

支持哪些模型？

平台聚合多家厂商模型，具体清单以控制台「模型」页面或 /v1/models 接口返回为准。

调用报 401 怎么办？

检查 Authorization 头是否为 Bearer <你的密钥> 格式，以及密钥是否已在控制台启用、未过期。