Private
Public Access
1
0

feat: 更新文档配置,添加 Cherry Studio 配置链接
All checks were successful
Deploy to Cloudflare Pages / deploy (push) Successful in 42s

- 在参考部分添加 Cherry Studio 配置的链接
- 移除 API 端点和常见问题的注释项
This commit is contained in:
2025-12-19 18:00:52 +08:00
parent 27ec4a2d38
commit 096437cc8d
9 changed files with 103 additions and 2 deletions

View File

@@ -31,8 +31,7 @@ export default defineConfig({
{
text: '参考',
items: [
// { text: 'API 端点', link: '/reference/endpoints' },
// { text: '常见问题', link: '/reference/faq' }
{ text: 'Cherry Studio 配置', link: '/cherry-studio-nanobana' }
]
}
],

Binary file not shown.

After

Width:  |  Height:  |  Size: 146 KiB

BIN
docs/assets/add.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 466 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

BIN
docs/assets/setting.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

View File

@@ -0,0 +1,102 @@
# 如何在 Cherry Studio 中愉快使用 大香蕉 Nano Banana Pro
## 一、Cherry Studio 简介
Cherry Studio 是一款支持多服务商集成的 AI 对话客户端,目前支持市面上绝大多数服务商的集成,并且支持多服务商的模型统一调度。
**官方网站:** https://www.cherry-ai.com/
![Cherry Studio 官网](assets/cherry%20studio%20官网.png)
---
## 二、添加 XCodeCLI 提供商
### 步骤 1打开设置添加提供商
在 Cherry Studio 中,点击左下角的 **设置按钮**(齿轮图标),进入设置页面,选择「模型服务」,然后点击底部的「+ 添加」按钮。
![设置页面 - 添加提供商](assets/add.png)
### 步骤 2配置提供商信息
- **提供商名称:** `XCodeCLI`
- **提供商类型:** 选择 `Gemini`
> ⚠️ **重要:** 提供商类型必须选择 Gemini不要选错
![添加提供商](assets/添加提供商.png)
---
## 三、填写 API 密钥和地址
配置完提供商后,需要填写 API 密钥和 API 地址:
- **API 密钥:** 填入你的 XCodeCLI API Key`sk-` 开头)
- **API 地址:** `https://api2.xcodecli.com`
- **模型:** 选择`gemini-3-pro-image-preview`
填写完成后,可以点击「检测」按钮验证配置是否正确。
![填写 API 密钥和地址](assets/填写从ke和base%20url.png)
---
## 四、开始使用:添加助手并生成图片
完成上述配置后,就可以开始生成图片了!
1. 点击左上角「+ 添加助手」创建新助手
2. 顶部选择模型:`gemini-3-pro-image-preview | Xcodecli`
3. 直接输入你的绘图需求,即可生成图片
![添加助手和配置](assets/添加助手和配置.png)
---
## 五、进阶生成高清图片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)
![助手参数配置](assets/9a1a0771d520055942e263d4b1011328.png)
---
## 六、提醒
> ⚠️ **特别注意以下模型的使用:**
| 模型 | 建议 |
| -------------------- | -------------------------------------- |
| **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 系列