第一步:注册千聚并获取API Key与Base URL
在使用千聚AI中转站之前,你需要拥有一个账号和一组API凭证。整个过程只需几分钟:
- 访问 千聚AI中转站官网,点击注册(邮箱或手机号均可)。
- 登录后进入控制台,创建你自己的API Key,并复制保存。
- 在“API接入”页面找到分配的Base URL,通常格式为
https://www.qianjuai.cc/v1(请以你获取的实际地址为准)。 - 根据需要购买Token(按量使用,无需包月)。
这些就是后续调用时需要用到的核心参数。千聚的后台管理清晰,适合团队统一使用。
第二步:编写代码示例——配置API Key与Base URL
千聚完全兼容OpenAI的调用方式,所以你现有的Python、Node.js代码几乎可以直接迁移。下面以Python为例,调通GPT和Claude:
import openai
使用千聚的Base URL和你的API Key
openai.api_base = "https://www.qianjuai.cc/v1" # 实际以官网提供为准
openai.api_key = "your-api-key-here" # 替换为你从千聚获取的Key
测试调用GPT模型(模型名由千聚统一映射)
response = openai.ChatCompletion.create(
model="gpt-4",
messages=[{"role": "user", "content": "Hello, how are you?"}]
)
print(response.choices[0].message.content)
上述代码只有 api_base 和 api_key 两个配置点。如果你想换成Claude,只需将 model 改为 claude-3 即可,其他代码完全不变。这就是AI API网关带来的统一接入体验。
第三步:切换模型与统一管理
通过千聚,你可以同时调用GPT-5系列、Claude 3、Gemini、DeepSeek、Grok、Qwen、Kimi等主流模型。所有模型共享同一个Base URL和同一个API Key,切换时只需修改 model 参数。
例如,继续上面代码,将模型名改为 claude-3 就能调用Claude;改为 gemini-1.5-pro 则调用Gemini。千聚会自动处理模型路由,你无需为每个模型申请独立的密钥和接口,极大降低了接入复杂度。
千聚还提供Token用量统计、余额告警、模型列表实时查看等功能,方便开发团队精细化管控。
第四步:常见问题排查与提示
- 连接超时或401错误:检查
api_base是否以/v1结尾,以及api_key是否正确。 - 模型不限速:千聚对同一Key的调用频率有合理约束,建议先测试单次调用。
- 如何获取最新模型列表:直接访问 千聚AI中转站官网,在控制台查看实时支持的模型清单。
如果你刚开始接触AI API网关代码示例,不必担心调试细节,千聚的文档和示例可以帮你快速上手。
下一步:现在就尝试一次模型调用
从注册到运行第一个请求,整个过程一般不超过10分钟。你还等什么?立即前往千聚AI中转站获取你的API Key,按上面的代码示例写一段测试程序,你就能成功调通GPT或Claude。
通过以上步骤,相信你已经掌握了AI API网关代码示例的核心要领。从今天开始,用千聚统一管理你的AI模型调用,减少多平台切换的麻烦,专注于业务开发吧。