SaaS接入模型中转站配置与调用指南：从API Key到模型接入

一、注册千聚账号并获取API Key

使用SaaS接入模型中转站的第一步是获取有效的API Key。千聚AI中转站提供统一的多模型接入入口，只需完成注册即可生成专属Key。步骤如下：

• 访问 千聚AI中转站官网，完成账号注册。
• 登录后进入“API Key管理”页面，点击创建新Key，复制保存备用。
• 千聚的Key格式为 sk-qj-xxxxxxxx，可直接用于后续配置。

注意：请勿将API Key暴露在客户端代码或公开仓库中，建议使用环境变量管理。

二、配置Base URL与模型名称

千聚兼容OpenAI的调用格式，因此Base URL和模型名是关键配置。在SaaS系统中，通常需要在环境变量或配置文件中设置以下三项：

配置项	说明	千聚示例值
OPENAI_API_KEY	API密钥	sk-qj-您的实际Key
OPENAI_BASE_URL	中转站请求地址	https://api.token88.cc/v1
MODEL_NAME	具体模型标识	gpt-4o / claude-3-opus / deepseek-chat

千聚支持的模型列表可实时在官网查看。将以上三项填入SaaS应用的配置后，即可无缝切换模型，无需改造原有代码。

三、使用Python进行模型调用测试

为验证配置是否生效，推荐用以下短代码发起一次对话请求：

import openai
openai.api_key = "sk-qj-您的实际Key"
openai.base_url = "https://api.token88.cc/v1/"
response = openai.chat.completions.create(
 model="gpt-4o",
 messages=[{"role": "user", "content": "你好，请用一句话介绍千聚"}]
)
print(response.choices[0].message.content)

返回结果即表示接入成功。如果遇到网络超时，请检查Base URL是否包含末尾斜杠或代理设置。

四、SaaS集成中的常见问题与排查

• 认证错误：确认API Key未过期，且与千聚账户绑定。可在千聚后台重新生成Key测试。
• 模型不可用：部分模型需单独购买Token，请前往官网确认余额是否充足。
• 返回空白：检查模型名称是否拼写正确，不同模型对应不同标识符。

五、开始你的第一次调用

完成以上步骤后，你就可以在SaaS产品中直接使用千聚提供的多种模型能力了。千聚的OpenAI兼容接口大大降低了多模型切换的复杂度，让你更专注于业务逻辑。

立即访问 立即访问千聚 获取您的专属API Key，查看最新模型列表，并购买Token开启调用。

• 千聚官网

  模型列表

• Token购买与充值
• API接入教程
• OpenAI兼容接口说明