OpenAI SDK 兼容

若您已有基于 OpenAI 官方 SDK 的应用,迁移到海宇数科通常只需两步:

  1. baseURL(或 base_url)改为 https://api.haiyushuke.com/v1
  2. apiKey 改为在海宇控制台创建的 API Key

协议兼容 Chat Completionsclient.chat.completions.create),便于零学习成本切换。

环境变量(推荐)

# Linux / macOS
export HAIYUSHUKE_API_KEY="sk-..."
export HAIYUSHUKE_BASE_URL="https://api.haiyushuke.com/v1"
# Windows PowerShell
$env:HAIYUSHUKE_API_KEY="sk-..."
$env:HAIYUSHUKE_BASE_URL="https://api.haiyushuke.com/v1"

Node.js

安装依赖:

npm install openai
import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: process.env.HAIYUSHUKE_API_KEY,
  baseURL: process.env.HAIYUSHUKE_BASE_URL ?? "https://api.haiyushuke.com/v1",
});
 
const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Hello" }],
});
 
console.log(completion.choices[0]?.message?.content);

Python

安装依赖:

pip install openai
import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.environ["HAIYUSHUKE_API_KEY"],
    base_url=os.environ.get("HAIYUSHUKE_BASE_URL", "https://api.haiyushuke.com/v1"),
)
 
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

流式

与 OpenAI 相同,设置 stream=True / stream: true,详见 流式调用

LangChain 等框架

在 LangChain 中配置自定义 baseURL 与 API Key 即可指向海宇网关(具体类名随 LangChain 版本而异,原则与上文一致)。模型名填控制台 模型 ID

与直连 OpenAI 的差异

项目说明
模型名使用海宇 模型广场 ID,非 OpenAI 原站名称(若不同)
账号与计费海宇控制台余额与 使用记录,与 OpenAI 账单无关
能力边界以各模型在海宇侧实际上线能力为准(工具调用、多模态等)
密钥必须使用 API Key,不能使用控制台登录 JWT

相关文档