SDK 集成

XSI 保持各上游协议的原生语义,官方 SDK 只需修改 Base URL 与 API Key。Key 请从环境变量读取,不要写入代码。

SDK / 协议Base URLKey 传递方式
OpenAIhttps://<API 域名>/v1Authorization: Bearer
Anthropichttps://<API 域名>x-api-key
Google GenAIhttps://<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 地址的客户端都可以接入:

  1. API Key 填入 XSI Key(sk-Xvs...)。
  2. Base URL 填入 https://<API 域名>/v1(OpenAI 格式)或 https://<API 域名>(Anthropic 格式),以客户端要求为准。
  3. 模型名填写价格表中的名称。

Codex 与 Claude Code 的配置见《Codex CLI / App》与《Claude Code》。

相关文档