1
Quick start
三步完成文本对话接入
- 在 UniKeyX 控制台创建 API Key。
- 把客户端的
base_url或baseURL改成https://www.unikeyx.com/v1。 - 使用
/chat/completions调用文本模型，并把 API Key 放在服务端环境变量里。
不要把 API Key 写进前端页面
浏览器前端应调用你自己的后端服务，再由后端转发到 UniKeyX。
2
SDK setup
初始化 OpenAI 兼容客户端
Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_UNIKEYX_API_KEY",
base_url="https://www.unikeyx.com/v1",
)
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.UNIKEYX_API_KEY,
baseURL: "https://www.unikeyx.com/v1",
});
3
Examples
文本对话调用示例
GPT：结构化摘要
const completion = await client.chat.completions.create({
model: "gpt-5.6",
messages: [
{ role: "system", content: "你是一个严谨的中文技术文档助手。" },
{
role: "user",
content: "把 UniKeyX 的 API 接入流程总结成 3 个步骤，并给出注意事项。",
},
],
temperature: 0.3,
});
console.log(completion.choices[0].message.content);
Claude：审阅与改写
curl https://www.unikeyx.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [
{
"role": "system",
"content": "你是一个负责审阅 API 文档的资深工程师。"
},
{
"role": "user",
"content": "请把这段说明改写得更清晰：先创建令牌，然后把 base_url 改为 UniKeyX。"
}
],
"temperature": 0.2
}'
4
Parameters
常用参数
model
必填。填写控制台中可见的模型名，例如
gpt-5.6 或 claude-sonnet-5。
messages
必填。OpenAI 兼容消息数组，常用
system、user、assistant 三类角色。
temperature
可选。越低越稳定，越高越发散。技术文档和客服建议
0.2 到 0.5。
stream
可选。设为
true 后可流式返回，适合聊天界面逐字显示。
FAQ
文本对话 FAQ
401 unauthorized
检查 API Key 是否复制完整，请求头是否为 Authorization: Bearer YOUR_UNIKEYX_API_KEY。
模型不存在或无权限
确认 model 填写的是控制台可见模型名，并确认当前 API Key 可以调用该模型。
Python 和 JavaScript 的 base URL 参数名不同
Python SDK 使用 base_url，JavaScript SDK 使用 baseURL。
什么时候用 stream?
聊天 UI 建议开启 stream: true，一次性生成文档、摘要或结构化结果时可以不启用。