5 分钟接入 QSTAR OpenAI 兼容 API

QSTAR 提供与 OpenAI 兼容的接口，你现有的 OpenAI SDK 几乎不用改。下面用五分钟走完「建 Key → 发请求 → 拿到回答」。

第一步：创建 API Key

登录后进入「API 密钥」页面，生成一个仅你可见的 Key。请把它放进环境变量，切勿写进代码或提交到 git。

第二步：发起首次请求

把 base_url 指向 QSTAR 网关，模型名换成你开通的模型 id，其余与 OpenAI 一致。下面是一段最小示例。

• 设置 Authorization: Bearer <你的 Key>
• POST /v1/chat/completions
• body: { model, messages:[{role:'user', content:'你好'}] }

第三步：处理流式响应

加上 stream:true 即可获得 SSE 流式增量，前端逐字渲染，体验与官方一致。注意捕获 401/402/429 并做退避。

至此你已经跑通最小链路。下一步可接入知识库做 RAG，或挂载工具做智能体。