第一步:注册千聚账号并获取API Key
在开始调用任何AI绘画模型之前,你首先需要有一个千聚账号。千聚AI中转站目前对国内开发者比较友好,注册流程也非常简洁,只需要一个邮箱即可完成。
- 访问官网:打开 千聚AI中转站官网,点击页面右上角的“注册”按钮。
- 填写信息:输入常用邮箱地址,设置登录密码,并完成邮箱验证。
- 登录后台:注册成功后,登录个人控制台。在左侧菜单中找到“API Key管理”页面。
- 生成新的Key:点击“创建API Key”,系统会为你生成一串唯一的密钥字符串。请务必复制并保存好,关闭页面后将无法再次查看明文。
获得API Key之后,你还需要确保账户中有足够的余额。如果这是你第一次使用,建议先购买少量Token用于测试调用,避免因余额不足导致请求失败。
第二步:配置Base URL与代码环境
千聚AI中转站的核心优势之一,就是完全兼容OpenAI的接口格式。这意味着你只需要修改代码中的Base URL和API Key,就能无缝切换绘画模型,无需为每个平台单独写一套请求逻辑。
在代码中,配置方式非常简单。以下是一个使用Python调用绘画模型的示例:
import openai
openai.api_key = "你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.Image.create(
model="dall-e-3",
prompt="一只穿着宇航服的猫在火星上散步,赛博朋克风格",
n=1,
size="1024x1024"
)
print(response.data[0].url)
请记住以下三个关键配置点:
- API Key:替换为你在千聚后台生成的密钥。
- Base URL:固定设为
https://www.qianjuai.cc/v1。 - 模型名称:根据你想使用的绘画引擎填写,例如
dall-e-3、stable-diffusion-xl或midjourney-proxy。
如果你使用Node.js或其他语言,原理相同:只需要修改HttpClient请求中的Base URL和Authorization头部,即可完成对接。
第三步:选择并调用AI绘画模型
千聚聚合了市面上主流的AI绘画模型方向,你可以根据具体的创作需求选择最合适的模型。下表列举了几种常见场景的推荐配置:
| 绘画需求 | 推荐模型名称 | 特点 |
|---|---|---|
| 高精度写实渲染 | dall-e-3 | 画面细腻,提示词理解能力强 |
| 风格化概念设计 | stable-diffusion-xl | 可控性强,支持多种风格微调 |
| 超高艺术感插图 | midjourney-proxy | 审美在线,适合商业素材 |
| 二次元动漫风格 | novelai | 专精日系画风人物与场景 |
每次调用时,只需在代码中修改 model 参数的值,API的返回格式统一。这大大降低了多模型协同开发时的维护成本,也是很多开发团队选择使用千聚作为AI中转站集成平台的原因之一。
常见问题与排查方法
在实际接入过程中,可能会遇到一些小问题。以下是三种最常见的情况及对应解决思路:
- 401认证失败:请检查API Key是否复制完整,或者是否包含了多余的空格与换行符。建议在后台重新生成一个Key再尝试。
- 404模型不存在:确认你填写的模型名称是否在千聚支持的模型列表中。不同时期的模型上线情况可能略有变动,建议前往官网查看最新模型清单。
- 429请求过于频繁:说明短时间内并发量较高,可以在代码中添加随机延迟(如time.sleep),或联系千聚客服咨询更高频率方案。
如果你希望在调用前确认某个特定绘画模型的最新收费方式和当前状态,直接登录 立即访问千聚 的后台控制台,所有模型的使用额度与费率都是实时更新的。
开始你的第一次AI绘画调用
现在,你已经掌握了从注册、配置到调用的完整流程。接下来需要做的,就是登录千聚后台,获取你的专属API Key,并尝试运行上面的Python示例代码。你只需要完成一次成功的请求,后续上手其他模型的速度会快很多。
下一步行动建议:
- 前往官网查看完整的AI绘画模型列表及各模型Token消耗说明
- 在后台购买适量Token用于首次测试
- 参考官方文档中的Base URL配置与Python/Node.js调用示例
- 如使用OpenAI SDK,可直接切换Base URL为千聚地址