TokenDuo

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 的模型才支持本格式。

上一篇:计费、分组与充值

下一篇:Anthropic 兼容接口