Agent 接入
OpenAI SDK + 星模XModel
openai 官方 SDK(Python 与 Node.js)都支持 base_url 覆盖:构造客户端时传入星模XModel 端点与你的 Key,其余代码与调用 OpenAI 完全一致。
SDK · 厂商:OpenAI
快速开始
分步接入
1前置条件:获取 API Key
注册星模XModel 后,在控制台「API 密钥」页创建一个 Key。下文所有 YOUR_API_KEY 占位符都替换为你的 Key;Key 等同账户凭证,不要提交进仓库。
2安装 SDK
shellpip install openai # Python npm install openai # Node.js3构造客户端
Pythonfrom openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://modelxing.com/v1", ) resp = client.chat.completions.create( model="qwen/qwen3-max", messages=[{"role": "user", "content": "你好,介绍一下你自己。"}], ) print(resp.choices[0].message.content)4Node.js 版本
Node.jsimport OpenAI from "openai"; const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://modelxing.com/v1", }); const resp = await client.chat.completions.create({ model: "qwen/qwen3-max", messages: [{ role: "user", content: "你好,介绍一下你自己。" }], }); console.log(resp.choices[0].message.content);5需要流式时
模型带 streaming 能力标注时传 stream=true 读 SSE;用量与中断语义见流式文档。
示例提示词
配好后直接粘贴
复制任意一条发给刚配好的 Agent,验证接入是否生效。
提示词
把这段同步代码改成带重试与超时的生产版本。提示词
用 qwen/qwen3-max 对返回结果做 JSON Mode 抽取,字段固定为 summary 和 risks。常见问题
FAQ
现有代码迁移要改多少?
通常只改 base_url(Node 是 baseURL)和 api_key 两处,请求结构与返回结构不变;迁移细节见 OpenAI 迁移文档。
计费怎么算?
按网关结算的 token 用量计费,余额与用量可用计费查询 API 实时读取。
故障排查
出问题时先看这里
AuthenticationError
api_key 传的是占位符或过期 Key;到控制台「API 密钥」页重新生成。
NotFoundError: model
model 参数用网关发布的模型 ID;对照模型市场逐字核对(含 provider 前缀)。