OpenAI SDK 兼容
若您已有基于 OpenAI 官方 SDK 的应用,迁移到海宇数科通常只需两步:
- 将
baseURL(或base_url)改为https://api.haiyushuke.com/v1 - 将
apiKey改为在海宇控制台创建的 API Key
协议兼容 Chat Completions(client.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 openaiimport 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 openaiimport 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 |
