OpenAI 兼容接口

适用于使用 OpenAI SDK、Chat Completions 格式或相关兼容工具的应用。先用最小请求验证，再接入业务代码。

ENDPOINT/v1/chat/completions

AUTHORIZATIONBearer YOUR_API_KEY

准备密钥与模型

1
创建 API 密钥
在控制台“API 密钥”中创建并保存密钥。示例使用环境变量，避免把完整密钥写入代码。
2
读取可调用模型
使用刚创建的 API 密钥请求 GET /v1/models，从返回结果的 data[].id 中复制一个模型 ID，替换后续示例中的 your-model-name。
3
先运行 cURL
cURL 成功后再配置 SDK，可以把认证和请求格式问题与代码环境问题分开。

读取可调用模型

curl https://nusi.si/v1/models \
  -H "Authorization: Bearer $SHARK_RELAY_API_KEY"

发送 cURL 请求

cURL

curl https://nusi.si/v1/chat/completions \
  -H "Authorization: Bearer $SHARK_RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [{ "role": "user", "content": "Reply with connection successful" }]
  }'

使用 Python SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://nusi.si",
)

response = client.chat.completions.create(
    model="your-model-name",
    messages=[{"role": "user", "content": "Reply with connection successful"}],
)
print(response.choices[0].message.content)

模型 ID 和当前可调用范围以 GET /v1/models 的实时返回为准；调用渠道会按你的路由偏好动态选择。

完成第一次验证

cURL 响应中出现 choices，并能在 choices[0].message.content 看到模型回复，即表示认证、模型和 Chat Completions 请求链路已打通。Python 示例应在终端打印同一段回复。

下一步再接入业务

保留这段最小请求作为连通性检查；业务代码中应从服务端环境变量读取密钥，并记录请求失败的状态码和响应体。

常见失败排查

现象处理方式

401 或 403

确认请求头为 Authorization: Bearer YOUR_API_KEY，密钥没有多余空格、未过期且未被删除。

模型不可用或找不到

不要使用示例占位值；重新请求 GET /v1/models，并复制返回结果中的模型 ID。

404 或请求格式错误

确认地址是 https://nusi.si/v1/chat/completions，请求体包含 model 与 messages。

SDK 能安装但无法调用

核对 base_url 是否为 https://nusi.si/v1，并先回到 cURL 示例复测。

还需要 Anthropic 兼容接口？查看 Anthropic 接入示例

NUSI 上手指南 · 持续更新中 · 2026.09