一个 Key，接入全站 AI 模型

1快速开始

如果你的软件支持 OpenAI-compatible、OpenAI API、自定义 Base URL 或自定义模型服务，通常只需要填写三项信息：

2接入地址

绝大多数工具只要求填写 Base URL、API Key 和模型名。如果工具要求填写完整接口地址，请使用 https://xinyunapi.cn/v1/chat/completions。

3认证与令牌

所有请求都需要携带你的星云智联 API Key。不要把上游渠道 Key 写进客户端，也不要把星云智联 API Key 公开到网页前端、截图、仓库或聊天记录里。

Authorization: Bearer sk-你的星云智联令牌
Content-Type: application/json

• 每个项目建议单独创建一个令牌，方便区分消耗来源。
• 测试环境和正式环境建议使用不同令牌。
• 如果令牌疑似泄露，请立即禁用旧令牌并重新创建。
• 调用失败时，优先检查令牌额度、分组权限和模型可用性。

4调用示例

星云智联API 使用 OpenAI 兼容协议。下面的示例可用于命令行、服务端脚本或支持自定义 API 的工具。

curl

curl https://xinyunapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的星云智联令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "你好，帮我写一句测试回复。" }
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的星云智联令牌",
    base_url="https://xinyunapi.cn/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "用一句话介绍星云智联 API。"}],
)
print(resp.choices[0].message.content)

JavaScript fetch

const response = await fetch("https://xinyunapi.cn/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-你的星云智联令牌",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "deepseek-v4-flash",
    messages: [
      { role: "user", content: "用一句话介绍星云智联 API。" }
    ]
  })
});
const data = await response.json();
console.log(data.choices?.[0]?.message?.content);

5能力与接口

星云智联API 完整兼容 OpenAI 协议家族，除对话外还开放以下能力端点（按需开通，模型可用性以 GET /v1/models 为准）。

6客户端配置

在 Cherry Studio、OpenAI-compatible 插件、个人脚本、Bot、自动化工具或其他 AI 客户端中，可以按下面的通用方式填写：

7模型与分组

模型可用性取决于你当前账户、令牌分组、余额和后台渠道配置。创建令牌时，请确认令牌有权限调用你准备使用的模型。

精选模型

完整模型列表

以下为模型广场当前开放的全量模型（26 个）。实际可用性以你的令牌调用 GET /v1/models 返回为准。

8定价参考

本站按「倍率 × 单价基数」计费，充值激活分组后即可调用对应模型。下表为常见模型的参考倍率，实际以控制台定价页为准。静态参考

9常见错误排查

10安全建议

• 不要在浏览器前端直连中转站令牌；生产项目建议由自己的服务端代理请求。
• 不要把 API Key 写入 GitHub、网盘公开分享、网页源码或截图。
• 为不同工具、项目、团队成员创建不同 Key，出现异常时可以单独停用。
• 定期查看用量日志和余额变化，发现异常消耗时先禁用相关令牌。

11FAQ