配置完AI网关,从哪开始?
AI网关文档配置完成后,第一件事不是急着写代码,而是确认三个基础信息:Base URL、API Key和模型名称。这三点是任何一次API调用的必备参数,少了任何一个都会导致请求失败。
对于使用 千聚AI中转站官网 的用户来说,流程会更加简化。千聚提供了统一的Base URL入口,无需为每个模型单独配置不同的网关地址。你只需要一个API Key,就可以调用包括GPT-5、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等在内的主流模型,大大降低了多平台切换的复杂度。
API Key 获取与设置(最容易忽略的细节)
API Key是调用AI模型的唯一凭证,很多人配置完AI网关文档后,却忽略了正确设置Key的格式。以下是标准步骤:
- 注册并登录千聚账号:前往千聚AI中转站,完成注册后进入控制台。
- 生成API Key:在“API Key管理”页面点击创建,系统会生成一串以“sk-”开头的密钥。复制并妥善保存,离开页面后Key将不再明文显示。
- 设置环境变量或直接写入代码:建议将Key存储在环境变量中,避免硬编码泄露。
示例代码(Python环境变量方式):
import os
api_key = os.getenv("QIANJU_API_KEY")
或者直接赋值:api_key = "sk-你的密钥"
如果Key无效或格式错误,调用时会返回401认证失败,这是最常见的调用错误之一。
Base URL 与模型名称的正确配置
Base URL 决定了请求发往哪个网关。千聚使用统一的OpenAI兼容接口,Base URL格式固定,无需根据模型切换。模型名称则需要根据你实际想要调用的模型填写,不同模型的名称写法略有差异。
下表列出几个常见模型的配置示例:
| 配置项 | 示例值 |
|---|---|
| Base URL | https://www.qianjuai.cc/v1 |
| API Key | sk-你的密钥 |
| 模型名称(GPT-5) | gpt-5 |
| 模型名称(Claude 3.5) | claude-3.5-sonnet |
| 模型名称(DeepSeek) | deepseek-chat |
模型名称的完整列表会随平台更新,以 立即访问千聚 官网展示的实时信息为准。
完整调用测试:用Python发一条请求
以下是基于OpenAI Python SDK的调用示例,适用于千聚提供的兼容接口:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://www.qianjuai.cc/v1"
)
response = client.chat.completions.create(
model="gpt-5",
messages=[
{"role": "user", "content": "请用一句话介绍AI网关文档的作用"}
]
)
print(response.choices[0].message.content)
运行这段代码,如果能正常返回AI的回答,说明你的API Key、Base URL和模型名称都配置正确。如果遇到错误,请优先检查:
- API Key是否已正确复制(注意不要多空格)
- Base URL是否以“/v1”结尾
- 模型名称是否与千聚平台提供的名称一致
- 账户余额是否充足(前往千聚控制台查看Token余额)
下一步做什么?
立即开始你的第一次模型调用:
- 访问 千聚AI中转站官网 注册账号
- 在控制台获取你的专属API Key
- 查看最新的模型列表,选择你需要的模型
- 购买Token并开始测试调用
配置AI网关文档只是第一步,真正让模型为你工作,关键在于正确使用API Key和调用方式。千聚通过统一的OpenAI兼容接口,让接入过程更简单,同时支持按量计费,适合个人开发者到企业团队的不同使用场景。
更多相关资源
- 千聚AI中转站官网
- 查看实时模型列表和价格
- Token购买与余额管理指南
- OpenAI兼容接口的Python/Node.js调用教程
- API Key安全管理最佳实践