OpenAI 兼容

星算 的 OpenAI 兼容网关挂载于 /v1,路径与 OpenAI 官方 API 一一对应。把 OpenAI SDK 的 base_url 指向 https://xingsuan.cloud 加 /v1 即可无缝替换。

端点

方法	路径	用途
GET	/v1/models	列出当前 Key 可见的启用模型
POST	/v1/chat/completions	Chat Completions(同步 + 流式)
POST	/v1/responses	Responses API(同步 + 流式)

鉴权

OpenAI SDK 默认通过 Authorization: Bearer xsk_... 发送 key,无需额外配置请求头。详见 鉴权。

流式

Chat 与 Responses 在请求体设置 "stream": true 即返回 SSE 流(text/event-stream),数据帧格式与 OpenAI 官方一致。

配置 SDK

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://xingsuan.cloud/v1",  # 你的接入地址 + /v1
    api_key="xsk_...",
)

Node.js

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://xingsuan.cloud/v1",  // 你的接入地址 + /v1
  apiKey: process.env.XSK_KEY,
})

接下来

• Chat Completions —— 对话补全(最常用)
• Responses —— Responses API
• 模型列表 —— 在线查询可用模型