OpenAI 兼容接口
Base URL 的写法、聊天补全与流式输出、获取可用模型列表。
更新于 2026-11-15
TokenDuo 提供与 OpenAI 格式兼容的接口。支持自定义 Base URL 的 OpenAI SDK 或客户端,一般都可以直接使用。
Base URL
https://niul-ai.cn/v1
- 大多数 SDK 的
base_url需要带上/v1。 - 部分客户端会自动补全
/v1/chat/completions,这时只需填写https://niul-ai.cn,以客户端的说明为准。 - 从其他 OpenAI 兼容的 API 中转服务迁移过来时,通常只需替换 Base URL 和 API 密钥,代码里的请求格式不用改。
请求头中使用 Authorization: Bearer sk-xxxx 传入 API 密钥。
聊天补全
curl https://niul-ai.cn/v1/chat/completions \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "模型名称",
"messages": [
{"role": "system", "content": "你是一个乐于助人的助手。"},
{"role": "user", "content": "用一句话介绍你自己"}
]
}'
流式输出
在请求中加入 "stream": true,响应会以 SSE(Server-Sent Events)的形式逐段返回:
from openai import OpenAI
client = OpenAI(base_url="https://niul-ai.cn/v1", api_key="sk-xxxx")
stream = client.chat.completions.create(
model="模型名称",
messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
获取可用模型列表
curl https://niul-ai.cn/v1/models \
-H "Authorization: Bearer sk-xxxx"
返回该密钥当前可以调用的模型。如果创建密钥时设置了「模型限制」,这里只会列出被允许的模型。
注意事项
model字段必须使用「模型与价格」页面中显示的模型名称。- 只有详情页「端点」中包含
openai的模型才支持本格式。