100 lines
2.5 KiB
Plaintext
100 lines
2.5 KiB
Plaintext
|
---
|
|||
|
|
title: OpenAI 兼容 SDK
|
|||
|
|
sidebarTitle: OpenAI 兼容 SDK
|
|||
|
|
description: 使用 OpenAI 官方 SDK 对接海宇数科网关（协议兼容，模型为国内 ID）
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# OpenAI SDK 兼容
|
|||
|
|
|
|||
|
|
若您已有基于 **OpenAI 官方 SDK** 的应用，迁移到海宇数科通常只需两步：
|
|||
|
|
|
|||
|
|
1. 将 `baseURL`（或 `base_url`）改为 `https://api.haiyushuke.com/v1`
|
|||
|
|
2. 将 `apiKey` 改为在海宇控制台创建的 **API Key**
|
|||
|
|
|
|||
|
|
协议兼容 **Chat Completions**（`client.chat.completions.create`），便于零学习成本切换。
|
|||
|
|
|
|||
|
|
## 环境变量（推荐）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Linux / macOS
|
|||
|
|
export HAIYUSHUKE_API_KEY="sk-..."
|
|||
|
|
export HAIYUSHUKE_BASE_URL="https://api.haiyushuke.com/v1"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
# Windows PowerShell
|
|||
|
|
$env:HAIYUSHUKE_API_KEY="sk-..."
|
|||
|
|
$env:HAIYUSHUKE_BASE_URL="https://api.haiyushuke.com/v1"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Node.js
|
|||
|
|
|
|||
|
|
安装依赖：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm install openai
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
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
|
|||
|
|
|
|||
|
|
安装依赖：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install openai
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
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`，详见 [流式调用](/docs/guides/streaming)。
|
|||
|
|
|
|||
|
|
## LangChain 等框架
|
|||
|
|
|
|||
|
|
在 LangChain 中配置自定义 `baseURL` 与 API Key 即可指向海宇网关（具体类名随 LangChain 版本而异，原则与上文一致）。模型名填控制台 **模型 ID**。
|
|||
|
|
|
|||
|
|
## 与直连 OpenAI 的差异
|
|||
|
|
|
|||
|
|
| 项目 | 说明 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 模型名 | 使用海宇 **模型广场 ID**，非 OpenAI 原站名称（若不同） |
|
|||
|
|
| 账号与计费 | 海宇控制台余额与 **使用记录**，与 OpenAI 账单无关 |
|
|||
|
|
| 能力边界 | 以各模型在海宇侧实际上线能力为准（工具调用、多模态等） |
|
|||
|
|
| 密钥 | 必须使用 **API Key**，不能使用控制台登录 JWT |
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- [HTTP API 调用](/docs/guides/http_api)
|
|||
|
|
- [工具接入概览](/docs/integrations/overview)
|
|||
|
|
- [API Key 管理](/docs/guides/api_keys)
|