sususu98
aea92bc1ec
All checks were successful
Deploy to Cloudflare Pages / deploy (push) Successful in 33s
101 lines
3.3 KiB
Markdown
101 lines
3.3 KiB
Markdown
# 如何在 Cherry Studio 中愉快使用 大香蕉 Nano Banana Pro ？
|
||
|
||
## 一、Cherry Studio 简介
|
||
|
||
Cherry Studio 是一款支持多服务商集成的 AI 对话客户端，目前支持市面上绝大多数服务商的集成，并且支持多服务商的模型统一调度。
|
||
|
||
**官方网站：** https://www.cherry-ai.com/
|
||
|
||
|
||
|
||
---
|
||
|
||
## 二、添加 XCodeCLI 提供商
|
||
|
||
### 步骤 1：打开设置，添加提供商
|
||
|
||
在 Cherry Studio 中，点击左下角的 **设置按钮**（齿轮图标），进入设置页面，选择「模型服务」，然后点击底部的「+ 添加」按钮。
|
||
|
||
|
||
|
||
### 步骤 2：配置提供商信息
|
||
|
||
- **提供商名称：** `XCodeCLI`
|
||
- **提供商类型：** 选择 `Gemini`
|
||
|
||
> ⚠️ **重要：** 提供商类型必须选择 Gemini，不要选错！
|
||
|
||
|
||
|
||
---
|
||
|
||
## 三、填写 API 密钥和地址
|
||
|
||
配置完提供商后，需要填写 API 密钥和 API 地址：
|
||
|
||
- **API 密钥：** 填入你的 XCodeCLI API Key（以 `sk-` 开头）
|
||
- **API 地址：** `https://api2.xcodecli.com`
|
||
- **模型：** 选择`gemini-3-pro-image-preview`
|
||
|
||
填写完成后，可以点击「检测」按钮验证配置是否正确。
|
||
|
||
|
||
|
||
---
|
||
|
||
## 四、开始使用：添加助手并生成图片
|
||
|
||
完成上述配置后，就可以开始生成图片了！
|
||
|
||
1. 点击左上角「+ 添加助手」创建新助手
|
||
2. 顶部选择模型：`gemini-3-pro-image-preview | Xcodecli`
|
||
3. 直接输入你的绘图需求，即可生成图片
|
||
|
||
|
||
|
||
---
|
||
|
||
## 五、进阶：生成高清图片（2K/4K）
|
||
|
||
想要生成更高清的图片，需要进入助手配置进行额外设置。
|
||
|
||
点击助手名称旁的 **三点菜单** 进入助手配置，然后：
|
||
|
||
1. **关闭流式输出** - 这一步很重要！
|
||
|
||
2. **添加自定义参数：**
|
||
|
||
| 参数名 | 类型 | 值 |
|
||
| ------------- | ---- | -------------------------------------------- |
|
||
| `imageConfig` | JSON | `{"aspectRatio": "16:9", "imageSize": "4K"}` |
|
||
|
||
> 💡 **提示：**
|
||
>
|
||
> - `aspectRatio` 可选值：`16:9`、`4:3`、`1:1` 等
|
||
> - `imageSize` 可选值：`4K`、`2K`、`1K` 等（K 必须是大写）
|
||
> - 详情请参考：[Google Gemini API 文档](https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#aspect_ratios_and_image_size)
|
||
|
||
|
||
|
||
---
|
||
|
||
## 六、提醒
|
||
|
||
> ⚠️ **特别注意以下模型的使用：**
|
||
|
||
| 模型 | 建议 |
|
||
| -------------------- | -------------------------------------- |
|
||
| **Claude 系列** | 不要在这里用，去 Claude Code (CC) 使用 |
|
||
| **GPT 5.1/5.2 系列** | 只能在 Codex 内使用 |
|
||
| **Gemini 系列** | ✅ 推荐使用 |
|
||
|
||
---
|
||
|
||
## 七、快速上手总结
|
||
|
||
1. 下载安装 Cherry Studio
|
||
2. 添加提供商：名称填 `XCodeCLI`，类型选 `Gemini`
|
||
3. 填写 API Key 和地址 `https://api2.xcodecli.com`
|
||
4. 生成高清图时：关闭流式输出 + 配置自定义参数
|
||
5. 优先使用 Gemini 系列模型，暂不支持 Claude、GPT 系列模型
|