客户端与 SDK
Python / Node.js SDK
用 OpenAI 官方 SDK 接入,包括流式、超时与重试设置。
ModelTown 兼容 OpenAI 协议,直接使用 OpenAI 官方 SDK,只需要改 base_url 和 api_key。
安装
pip install openai流式调用、超时与重试
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.example.cn/v1",
api_key=os.environ["RELAY_API_KEY"],
timeout=120, # 秒;长输出可适当调大
max_retries=2, # SDK 只对连接错误、429、5xx 重试
)
stream = client.chat.completions.create(
model="qwen3.8-flash",
messages=[{"role": "user", "content": "解释一下什么是向量数据库"}],
stream=True,
stream_options={"include_usage": True},
)
for chunk in stream:
if chunk.choices:
print(chunk.choices[0].delta.content or "", end="", flush=True)
if chunk.usage:
print("\n用量:", chunk.usage)在 LangChain、Dify 中使用
这类框架都支持“OpenAI 兼容”的模型提供方,填写同样的三项即可:
| 配置项 | 填写 |
|---|---|
| API 地址(Base URL) | https://api.example.cn/v1 |
| API Key | 你的 sk-relay-… |
| 模型名称 | 模型广场里的模型 ID |