OpenAI · SDK

OpenAI SDK

官方 OpenAI SDK（Python 和 Node）都接受自定义端点。把 base_url 设为你的 NextModel 端点、密钥放在环境变量里，其余代码保持不变。

快速开始

  1. 获取你的 NextModel API 密钥

    在 NextModel 控制台创建密钥，并导出为 NEXTMODEL_API_KEY，方便下面的片段读取。

    Shell
    export NEXTMODEL_API_KEY=<YOUR_API_KEY>

  2. 把 Python 客户端指向 NextModel

    与默认 OpenAI 配置相比，唯一的变化就是 base_url。

    官方文档

    Python
    import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nextmodel.app/v1",
    api_key=os.environ["NEXTMODEL_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
)
print(resp.choices[0].message.content)

  3. 或者使用 Node 客户端

    TypeScript 同理：baseURL 是唯一新增的参数。

    官方文档

    TypeScript
    import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nextmodel.app/v1",
  apiKey: process.env.NEXTMODEL_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-4-5",
  messages: [{ role: "user", content: "Say hello in one sentence." }],
});
console.log(resp.choices[0].message.content);

  4. 不要把密钥写进代码

    两个客户端都从环境变量读取密钥——本地用 dotenv 加载，生产环境用平台的密钥管理服务。

示例提示词

提示词保持英文以获最佳效果

提示词
Classify this support ticket as billing, bug report, or how-to, and answer it.
Draft a three-paragraph product description from these bullet points.

常见问题

哪些 SDK 版本支持 base_url？

当前所有 openai-python 和 openai-node 版本都在客户端构造函数里接受 base_url / baseURL——包括你项目正在用的版本。

支持流式输出吗？

支持。Python 传 stream=True，Node 传 stream: true，然后按块迭代响应，与默认端点完全一致。

快速测试时可以把密钥写死吗？

即使在本地也建议用环境变量——示例片段读取 NEXTMODEL_API_KEY，避免敏感信息进入 git。

故障排除

AuthenticationError 401

进程没有读到 NEXTMODEL_API_KEY。先在同一个 shell 里 echo 该变量——或检查 .env 的加载——再重试。

chat.completions 返回 404

base_url 必须以 /v1 结尾且只出现一次。缺少 /v1 或写成 /v1/v1 都会表现为 not found。

其他 Agent

CLIOpenAI

Codex CLI

OpenAI 的终端编程代理，指向 NextModel。

Codex CLI 从 ~/.codex/config.toml 读取模型提供商配置。添加一个指向 NextModel 端点的 provider 并导出密钥，之后每次 codex 调用都会经过 NextModel。

Codex CLI
IDEAnysphere

Cursor

AI 优先的 IDE，接上你自己的端点。

Cursor 支持为 OpenAI 兼容端点自带密钥（BYOK）。在 Settings → Models 中粘贴你的 NextModel 密钥，并把 OpenAI 提供商的 Base URL 指向 NextModel，OpenAI 格式的请求就会发往 NextModel。

Cursor
IDECline

Cline

VS Code 里的自主编程代理，用你自己的密钥。

Cline 是一个 VS Code 扩展，会在每一步征求你的确认后规划和修改代码。它的 OpenAI Compatible provider 接受任意端点，填一张表就能接上 NextModel。

Cline
桌面端Cherry Studio

Cherry Studio

开箱即说 OpenAI 的桌面聊天客户端。

Cherry Studio 把模型提供商作为服务来管理。把 NextModel 作为 OpenAI 兼容服务添加一次，它就会出现在你已有的服务列表旁边。

Cherry Studio