OpenAI SDK

使用官方 OpenAI SDK 在 Node.js 与 Python 项目中配置 AnyStarX 接口。

在已经引入官方 OpenAI SDK 的现有工程中,迁移到 AnyStarX 仅需调整两项基础配置:

  • 将客户端初始化参数中的 apiKey 替换为在控制台创建的有效密钥。
  • baseURL 修改为 https://console.anystarx.com/v1

其余的模型调用逻辑、流式监听与工具调用代码均可保持原有写法。

Node.js 环境接入

安装官方依赖包:

npm install openai

在本地开发目录中创建 .env.local 配置文件:

OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://console.anystarx.com/v1
MODEL_ID=MODEL_ID

示例调用代码:

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL,
});

const completion = await client.chat.completions.create({
  model: process.env.MODEL_ID ?? 'MODEL_ID',
  messages: [
    {
      role: 'user',
      content: '请解释什么是大语言模型 API 中的 Base URL。',
    },
  ],
});

console.log(completion.choices[0]?.message?.content);

Python 环境接入

安装 Python 官方依赖:

pip install openai

在运行环境中配置环境变量:

export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://console.anystarx.com/v1"
export MODEL_ID="MODEL_ID"

示例调用代码:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://console.anystarx.com/v1"),
)

completion = client.chat.completions.create(
    model=os.environ.get("MODEL_ID", "MODEL_ID"),
    messages=[
        {
            "role": "user",
            "content": "请解释什么是 API 密钥的作用与安全规范。",
        }
    ],
)

print(completion.choices[0].message.content)

Responses 接口调用

若项目需要接入新版 Responses 接口协议,可使用 SDK 提供的 client.responses 模块:

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://console.anystarx.com/v1',
});

const response = await client.responses.create({
  model: 'MODEL_ID',
  input: '请简要说明大语言模型在自动化代码重构中的核心优势。',
});

console.log(response.output_text);

常见调用异常处理

TypeError: fetch failed 或网络连接失败

该错误通常表明本地运行时无法建立与目标服务器的网络连接。排查时应确认网络代理设置是否影响了 Node.js 进程,并核对 baseURL 是否正确配置为 https://console.anystarx.com/v1,避免包含了拼写错误的域名或端口。

401 Unauthorized 认证失败

该状态码表示 API Key 校验不通过。请核对传入的密钥是否完整复制自当前控制台,并确认没有在字符串首尾附带多余的引号或空格。

model_not_found 模型不存在

该错误表明请求的模型标识符未被系统识别。请登录管理控制台核对可用模型列表,确认账号具备对应权限,并将 MODEL_ID 替换为控制台中展示的精确字符串。

本页内容