Agent 接入

OpenAI SDK + 星模XModel

openai 官方 SDK(Python 与 Node.js)都支持 base_url 覆盖:构造客户端时传入星模XModel 端点与你的 Key,其余代码与调用 OpenAI 完全一致。

SDK · 厂商:OpenAI

快速开始

分步接入

  1. 1前置条件:获取 API Key

    注册星模XModel 后,在控制台「API 密钥」页创建一个 Key。下文所有 YOUR_API_KEY 占位符都替换为你的 Key;Key 等同账户凭证,不要提交进仓库。

    打开 /docs/quickstart 文档

  2. 2安装 SDK

    shell
    pip install openai  # Python
    npm install openai  # Node.js
  3. 3构造客户端

    Python
    from 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)
  4. 4Node.js 版本

    Node.js
    import 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. 5需要流式时

    模型带 streaming 能力标注时传 stream=true 读 SSE;用量与中断语义见流式文档。

    打开 /docs/streaming 文档

示例提示词

配好后直接粘贴

复制任意一条发给刚配好的 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 前缀)。