准备千聚账号与API Key
要使用千聚AI中转站调用Gemini 2.5 Flash-Lite,首先需要一个千聚账户。访问千聚AI中转站官网,完成注册并登录。进入控制台后,在“API Key管理”页面创建新的密钥。请将生成的API Key复制并妥善保存——它将在后续配置中作为身份凭证传递。
千聚平台统一管理所有模型接入点的API Key,你只需要这一个密钥即可访问平台支持的多个模型系列,包括Gemini、OpenAI、Claude等,便于降低多平台切换带来的管理成本。
定位Base URL并配置OpenAI兼容客户端
千聚AI中转站提供OpenAI兼容接口,因此你可以直接使用OpenAI官方SDK或任何兼容OpenAI格式的HTTP客户端进行调用。这是接入流程中最核心的一步:正确设置Base URL。
千聚的Base URL格式如下:
https://www.qianjuai.cc/v1
无论你使用Python、Node.js、curl还是其他工具,都需要将API请求的端点指向这个地址。以Python为例,基本配置代码片段为:
from openai import OpenAI
client = OpenAI(api_key="你的千聚API Key", base_url="https://www.qianjuai.cc/v1")
只要替换为自己的API Key,客户端就能直接通过千聚中转站路由到后端的Gemini 2.5 Flash-Lite模型。
填写模型名称并发送首次请求
完成API Key和Base URL配置后,最后一步是指定模型名称。千聚平台使用的模型名称为:gemini-2.5-flash-lite。请注意大小写和分隔符,这是调用成功的关键。
以下是一个完整的Python调用示例,仅用于说明配置点:
response = client.chat.completions.create(
model="gemini-2.5-flash-lite",
messages=[{"role": "user", "content": "Hello, explain quantum computing in one sentence."}]
)
print(response.choices[0].message.content)
运行这段代码,如果返回了正常的文本回复,说明你已经成功通过千聚AI中转站接入了Gemini 2.5 Flash-Lite模型。
| 配置项 | 值 | 说明 |
|---|---|---|
| API Key | 千聚控制台生成的密钥 | 用于身份验证 |
| Base URL | https://www.qianjuai.cc/v1 | 统一接入端点 |
| 模型名称 | gemini-2.5-flash-lite | 千聚定义的模型标识 |
常见问题与排查建议
如果首次调用失败,可以按以下顺序快速排查:
- 检查API Key准确性:确认密钥已复制完整,无多余空格或换行。
- 确认Base URL是否带/v1路径:部分SDK要求精确填写路径后缀,请保持完整。
- 验证模型名称拼写:Gemini 2.5 Flash-Lite在千聚的模型名称为全小写加连字符格式,请勿自定义变化。
- 余额是否充足:登录千聚控制台查看Token余额,调用前请确保账户有可用额度。
通过千聚中转站接入还有其他优势:你可以在同一个平台上查看所有模型的调用日志、用量统计,并随时为账户充值Token,无需分别管理多个厂商账户。对于团队开发,还可创建子密钥和权限角色,更便于统一管理。
立即开始接入Gemini 2.5 Flash-Lite
访问 立即访问千聚 完成注册,在控制台获取你的API Key,然后尝试发送一次调用吧。平台模型列表页实时更新所有可用的模型及其状态,你可以随时查看到最新接入信息。
推荐延伸阅读:
- 千聚AI中转站模型列表与最新支持模型
- 千聚Token购买与余额充值指南
- 千聚OpenAI兼容接口Python/Node.js调用教程
- 千聚官网Base URL与API Key配置详解
适合继续扩展的标题方向:
- 千聚AI中转站Gemini 2.5 Flash-Lite调用常见错误与解决方案
- 千聚API接入:多模型统一管理与Token余额高效使用
- 千聚AI中转站入门:从注册到首次调用Gemini全流程
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~