跳到主要内容

自定义 Provider 应用

许多支持自定义 provider、自定义 endpoint 或 OpenAI 风格 Base URL 的客户端，都可以直接连接 XInfera。XInfera 本身是多协议网关。

开始之前​

请先准备：

  • 支持自定义 provider 的应用、SDK、no-code 工具或自动化平台。
  • 已在 XInfera 控制台创建 API Key。
  • /v1/models 返回的模型 ID。

方式一：配置应用 UI（推荐）​

桌面客户端、no-code 工具、浏览器插件和内部工具优先使用这种方式。

第 1 步：选择自定义 provider 类型​

在应用中选择 OpenAI、Custom Provider、Custom Endpoint 或其他允许填写 Base URL 的类似 provider 类型。

第 2 步：添加 XInfera 设置​

使用以下值：

应用中的字段名XInfera 值
OpenAI Base URL / API Base / Endpointhttps://api.xinfera.cn/v1
API Key / OpenAI API Keysk-YOUR_API_KEY
Model / Model ID/v1/models 返回的模型 ID

常见字段名：

应用字段XInfera 值
API Hosthttps://api.xinfera.cn/v1
API Basehttps://api.xinfera.cn/v1
Base URLhttps://api.xinfera.cn/v1
Custom Endpointhttps://api.xinfera.cn/v1
OpenAI Keysk-YOUR_API_KEY
模型 ID模型 ID，例如 deepseek-v4-flash

第 3 步：验证连接​

发送短测试提示词：

用一句话确认 XInfera 已连接。

方式二：配置 SDK​

如果你在代码中通过 OpenAI SDK 集成 XInfera，使用该方式。Claude 风格请求请使用 原生Claude格式。

第 1 步：创建 client​

from openai import OpenAI

client = OpenAI(
    base_url="https://api.xinfera.cn/v1",
    api_key="sk-YOUR_API_KEY",
)

第 2 步：发送测试请求​

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "用一句话打个招呼。"}],
)

print(response.choices[0].message.content)

第 3 步：将 API 密钥移到环境变量​

生产代码中，请从环境变量或 secrets manager 读取 API Key，不要硬编码。

安全建议​

  • 不同应用使用不同 API Key。
  • 为桌面客户端和实验场景设置配额。
  • 删除不再使用的 Key。
  • 避免把 API Key 粘贴到共享配置文件中。

常见问题​

1. 401 Unauthorized

检查 API Key，移除多余空格，并确认应用以 Bearer token 方式发送。

2. 404 Not Found

通过 OpenAI 风格自定义 provider 配置的应用请使用 https://api.xinfera.cn/v1。除非应用明确要求不带 /v1 的 provider endpoint，否则不要使用 https://api.xinfera.cn。

3. Model not found

使用同一个 API 密钥调用 /v1/models，并使用返回的模型 ID。

4. 应用无法拉取模型或流式输出失败

如果应用无法拉取模型列表，请手动添加模型 ID。如果 streaming 失败，请关闭 streaming 或选择支持流式输出的模型。

Contents