SDK 集成
XSI 保持各上游协议的原生语义,官方 SDK 只需修改 Base URL 与 API Key。Key 请从环境变量读取,不要写入代码。
| SDK / 协议 | Base URL | Key 传递方式 |
|---|---|---|
| OpenAI | https://<API 域名>/v1 | Authorization: Bearer |
| Anthropic | https://<API 域名> | x-api-key |
| Google GenAI | https://<API 域名> | x-goog-api-key |
export XSI_API_KEY="sk-Xvs..."
export XSI_BASE_URL="https://api.xsicontrol.com" # 或你自己的 API 域名OpenAI SDK
Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["XSI_API_KEY"],
base_url=os.environ["XSI_BASE_URL"] + "/v1",
)
# Responses
resp = client.responses.create(model="gpt-6.2-sol", input="解释什么是第一性原理")
print(resp.output_text)
# Chat Completions(流式)
stream = client.chat.completions.create(
model="gpt-6.2-sol",
messages=[{"role": "user", "content": "写一首关于路由器的短诗"}],
stream=True,
stream_options={"include_usage": True},
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
# Embeddings
emb = client.embeddings.create(model="text-embedding-3-small", input="XSI")
print(len(emb.data[0].embedding))Node.js / TypeScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.XSI_API_KEY,
baseURL: `${process.env.XSI_BASE_URL}/v1`,
});
const resp = await client.responses.create({
model: "gpt-6.2-sol",
input: "解释什么是第一性原理",
});
console.log(resp.output_text);OpenAI SDK 也会读取环境变量 OPENAI_API_KEY 与 OPENAI_BASE_URL,可直接设置为 XSI 的值。
Anthropic SDK
Python
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["XSI_API_KEY"],
base_url=os.environ["XSI_BASE_URL"],
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "解释什么是第一性原理"}],
)
print(message.content[0].text)Node.js / TypeScript
import Anthropic from "@anthropic-ai/sdk";
const anthropic = new Anthropic({
apiKey: process.env.XSI_API_KEY,
baseURL: process.env.XSI_BASE_URL,
});
const message = await anthropic.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "解释什么是第一性原理" }],
});
console.log(message.content[0].text);Anthropic SDK 也会读取 ANTHROPIC_API_KEY 与 ANTHROPIC_BASE_URL。
Google GenAI SDK
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["XSI_API_KEY"],
http_options=types.HttpOptions(base_url=os.environ["XSI_BASE_URL"]),
)
resp = client.models.generate_content(model=os.environ["GEMINI_MODEL"], contents="你好")
print(resp.text)Gemini 模型需由运营方在价格表中配置;请求的模型以 URL 中的名称为准。
会话粘性与缓存
为同一会话的多轮请求设置稳定的会话标识,可让 XSI 把它们固定到同一个上游 Key,提高提示缓存命中率:
resp = client.responses.create(
model="gpt-6.2-sol",
input="继续上一轮的分析",
prompt_cache_key="session-7f3a",
)也可以使用请求头 session_id 或 conversation_id,见《Router API》。
其他客户端
任何支持自定义 OpenAI 或 Anthropic 地址的客户端都可以接入:
- API Key 填入 XSI Key(
sk-Xvs...)。 - Base URL 填入
https://<API 域名>/v1(OpenAI 格式)或https://<API 域名>(Anthropic 格式),以客户端要求为准。 - 模型名填写价格表中的名称。
Codex 与 Claude Code 的配置见《Codex CLI / App》与《Claude Code》。