API 类型
OpenAI Compatible / OpenAI 兼容
Base URL
https://api.xmapi.com.cn/v1API Key
控制台令牌管理里创建的
sk- 密钥推荐模型
gpt-5.4-mini、gpt-5.4、gpt-5.5照着填
1
先生成一个令牌
登录星猫控制台，进入“令牌管理”，点击“添加令牌”。名称可以写自己的设备名，例如 Cursor、Chatbox、客户A。
2
复制 API Key
保存后复制以 sk- 开头的密钥。只复制一次就行，不要多复制空格，也不要把兑换码当成 API Key。
3
打开客户端设置
在 Cursor、Chatbox、Cherry Studio、Codex 或其他工具里找到模型服务商设置，类型选择 OpenAI、OpenAI Compatible、OpenAI 兼容、自定义 OpenAI 这类选项。
4
填写地址和模型
Base URL 填 https://api.xmapi.com.cn/v1，API Key 填 sk- 密钥，Model 填 gpt-5.4-mini 或模型广场里复制的完整模型名。
5
发一句话测试
保存后发送“你好”。如果能回复，再去星猫控制台的“使用日志”看是否有记录；有记录就说明已经走星猫接口。
常见软件填法
- Cursor：Settings / Models 里添加 OpenAI Compatible，Base URL 填
https://api.xmapi.com.cn/v1。 - Cherry Studio：模型服务选择 OpenAI 兼容，接口地址填
https://api.xmapi.com.cn/v1，模型名手动添加。 - Chatbox：模型提供方选择 OpenAI API 或自定义 OpenAI，API Host 填
https://api.xmapi.com.cn/v1。 - 代码调用：只需要把官方 OpenAI SDK 的
baseURL改成星猫地址，Key 换成星猫令牌。
GPT/OpenAI 兼容客户端必须带
/v1。如果只填 https://api.xmapi.com.cn，很多软件会报 404 或模型列表为空。import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.xmapi.com.cn/v1",
apiKey: "sk-你的星猫令牌"
});
const completion = await client.chat.completions.create({
model: "gpt-5.4-mini",
messages: [{ role: "user", content: "你好，介绍一下星猫 AI" }]
});