客户端接入

x001.ai 的核心接入方式是 OpenAI 兼容协议。大多数支持自定义 OpenAI Base URL 的客户端都可以接入。

通用参数

配置项	值
API Key	控制台创建的令牌
Base URL	https://x001.ai/v1
Chat Completions	https://x001.ai/v1/chat/completions
Embeddings	https://x001.ai/v1/embeddings

Cherry Studio

在 Cherry Studio 中添加 OpenAI 兼容服务商：

1. 服务商类型选择 OpenAI Compatible。
2. API Key 填写控制台令牌。
3. API 地址填写 https://x001.ai/v1。
4. 保存后选择可用模型并发送测试消息。

LobeChat

在 LobeChat 的 OpenAI 配置中：

API Key: 你的 x001.ai 令牌
Base URL: https://x001.ai/v1

生产应用不建议把 API Key 直接放在浏览器前端代码里。

OpenAI SDK

Node.js 示例：

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.X001_API_KEY,
  baseURL: 'https://x001.ai/v1',
})

const response = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Hello' }],
})

console.log(response.choices[0]?.message?.content)

Python 示例：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["X001_API_KEY"],
    base_url="https://x001.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)

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

常见问题

如果客户端提示模型不存在，请确认：

• 控制台选择的用户分组有权限使用该模型。
• 请求中的 model 字段与控制台可见的模型名一致。
• 该模型当前没有维护或临时不可用提示。