Documentation
🎨 在线生图配置

在线生图配置

🎨

想用 AiFirst 自己生图时,推荐先用 Cherry Studio 接入 AiFirst,再选择支持图像生成的模型开始创作。下面按完整流程一步步配置。

准备材料

开始前请确认你已经准备好:

项目说明
AiFirst 账号登录 https://apiaifirst.com (opens in a new tab)
账户余额生图会消耗额度,请先确认余额充足
API 密钥用于让 Cherry Studio 连接 AiFirst
Cherry Studio适合新手的桌面端 AI 客户端
⚠️

API Key 只在创建时完整显示一次,请保存到自己的安全位置,不要发给他人,也不要截图公开。

配置流程

第一步:进入 API 密钥页面

登录 AiFirst 后,在左侧菜单点击 「API 密钥」

进入 API 密钥页面

第二步:创建生图用密钥

在 API 密钥页面点击右上角 「创建密钥」

创建 API 密钥

填写密钥名称时建议写清用途,例如 生图Cherry Studio 生图。分组请选择当前可用、并支持图像模型的分组;如果后台提供了 GPT plus号池image 相关分组,可以优先选择。

选择支持生图的分组

创建完成后,点击复制按钮保存密钥。

复制 API 密钥

第三步:安装并打开 Cherry Studio

打开 Cherry Studio 官网:https://www.cherry-ai.com (opens in a new tab),选择你电脑对应的系统版本下载安装。

安装完成后打开 Cherry Studio,点击右上角 设置 图标。

打开 Cherry Studio 设置

第四步:添加 AiFirst 服务

在设置里进入 模型服务,点击底部 添加

进入模型服务并添加

新增服务时按下面填写:

配置项填写内容
提供商名称AiFirst(也可以填写自己方便识别的名称)
提供商类型OpenAI
添加提供商

保存后,在 AiFirst 服务配置里填写:

配置项填写内容
API 密钥第一步创建并复制的 AiFirst API Key
API 地址https://image.apiaifirst.com
⚠️

生图请优先填写图片专用入口 https://image.apiaifirst.com,避免图片上传、生成或长响应经过主站代理时出现超时报错。Cherry Studio 通常会自动拼接 OpenAI 接口路径;若你的版本明确要求填写完整 OpenAI Base URL,再改用 https://image.apiaifirst.com/v1

填写 API Key 和 API 地址

第五步:添加生图模型

在 AiFirst 服务的模型区域点击 管理添加,进入模型列表。

打开模型管理

找到 gpt-image 分类,点击 GPT Image 2 右侧的加号。

添加 GPT Image 2

关闭模型列表后,如果能在 AiFirst 模型列表中看到 GPT Image 2,说明模型添加成功。

第六步:开始生图

回到对话页面,在顶部模型选择器中选择 GPT Image 2 | AiFirst,然后输入你的生图提示词即可。

选择 GPT Image 2 开始生图

提示词建议

生图提示词建议写清楚这几个部分:

维度示例
主体一个年轻设计师、一个赛博风机器人、一杯冰美式
场景未来城市街头、极简办公室、阳光洒进来的厨房
风格写实摄影、3D 渲染、手绘插画、电影海报
构图近景、俯视、居中构图、留白用于标题
规格竖版海报、16:9 横图、头像比例

可以直接这样写:

生成一张 16:9 横版图片:一只透明玻璃质感的蓝色蝴蝶停在发光键盘上,背景是夜晚的极简工作台,写实摄影风格,浅景深,高级感,画面干净,不要文字。

常见问题

问题处理方式
找不到 GPT Image 2回到 Cherry Studio 的模型管理页,确认已经在 gpt-image 分类里点击加号
模型添加了但不能生图检查 AiFirst API 密钥绑定的分组是否支持图像模型
提示 API Key 无效重新复制 AiFirst 控制台里的密钥,确认没有多余空格
请求失败或地址错误生图优先填写 https://image.apiaifirst.com;如果当前 Cherry Studio 版本要求完整 Base URL,再填写 https://image.apiaifirst.com/v1
生成速度慢、超时或失败确认正在使用 https://image.apiaifirst.com,再检查账户余额、网络状态,稍后重试或换一个图像模型
💡

如果你只是想确认 API Key 是否可用,可以先参考 环境检查 验证连通性,再回到 Cherry Studio 继续配置。