Ace Banana2 Image Generation / Ace Banana2 图像生成
English | 中文
Overview / 概述
English:
Ace Banana2 is a powerful image generation and editing skill that leverages the AceData Nano Banana API. It provides a seamless workflow for creating high-quality images from text prompts or editing existing images with AI-powered transformations. The skill supports multiple models, customizable parameters, and automatic saving of generated images to your desktop.
中文:
Ace Banana2 是一个功能强大的图像生成和编辑技能，基于 AceData Nano Banana API。它提供了一个无缝的工作流程，可以从文本提示生成高质量图像，或使用 AI 驱动的转换编辑现有图像。该技能支持多种模型、可自定义参数，并自动将生成的图像保存到桌面。
AceData模型调用价格非常划算，每张照片不超过0.5元，还是很吸引人的。
Model Introduction / 模型介绍
English:
The Nano Banana API offers several cutting‑edge image generation models:
- nano‑banana‑2 (default): Professional‑quality image generation with flash speed. Ideal for most creative tasks.
- nano‑banana‑pro: Enhanced model for image‑to‑image editing and higher‑fidelity outputs.
- nano‑banana: The original model, suitable for general‑purpose generation.
All models support resolutions up to 4K and aspect ratios such as 16:9, 1:1, 4:3, etc.
中文:
Nano Banana API 提供多种先进的图像生成模型：
- nano‑banana‑2（默认）：具有快速生成速度的专业级图像生成模型，适合大多数创意任务。
- nano‑banana‑pro：增强模型，适用于图像到图像的编辑和更高保真度的输出。
- nano‑banana：原始模型，适合通用生成，不推荐使用。
所有模型支持高达 4K 的分辨率和 16:9、9:16、1:1、4:3、3:4 等宽高比。
API Key Application / API 密钥申请说明
English:
To use this skill, you need an AceData API key (Bearer Token). Follow these steps:
- Visit the AceData registration page.
- Sign up or log in to your AceData account.
- Navigate to the API Keys section in your dashboard.
- Generate a new API key (Bearer Token) with access to the Nano Banana service.
- Copy the key and keep it secure.
中文:
使用本技能需要 AceData API 密钥（Bearer Token）。请按以下步骤操作：
- 访问 AceData 注册页面。
- 注册或登录您的 AceData 账户。
- 在控制台中转到 API Keys 部分。
- 生成一个新的 API 密钥（Bearer Token），确保其具有 Nano Banana 服务的访问权限。
- 复制密钥并妥善保管。
Installation & Usage Steps / 安装与使用步骤
Step 1: Install Dependencies / 第一步：安装依赖
English:
Ensure you have Python 3.7+ installed. Then install required packages:
pip install requests pillow
中文:
确保已安装 Python 3.7+，然后安装所需包：
pip install requests pillow
Step 2: Configure API Key / 第二步：配置 API 密钥
English:
Run the script once, and it will prompt you to enter your Bearer Token. The token will be saved in a .env file inside the skill directory for future use.
中文:
运行脚本一次，它将提示您输入 Bearer Token。令牌将保存在技能目录的 .env 文件中，供以后使用。
Step 3: Run the Script / 第三步：运行脚本
English:
Navigate to the skill directory and execute:
python scripts/generate_images.py
You will be prompted for a text description (prompt) or can provide command‑line arguments.
中文:
进入技能目录并执行：
python scripts/generate_images.py
系统将提示您输入文本描述（提示词），或者您可以直接提供命令行参数。
Features / 功能特性
English:
- Dual‑mode Operation: Supports both text‑to‑image (
generate) and image‑to‑image (edit) workflows. - Local & Remote Images: Upload up to 4 local images (converted to Base64) or provide image URLs.
- CDN Upload Priority: Local images are first uploaded to AceData CDN to obtain public URLs, avoiding Base64 encoding overhead and improving transmission efficiency.
- Automatic Image Resizing: Large images are automatically resized to comply with API limits.
- Batch Generation: Generate multiple images in a single request.
- Smart Saving: Images are saved to a dated folder on your desktop with unique timestamps.
- Detailed Logging: Full JSON response is displayed for debugging and transparency.
中文:
- 双模式操作：支持文生图（
generate）和图生图（edit）工作流。 - 本地与远程图像：最多上传 4 张本地图像或提供图像 URL。
- CDN 上传优先：本地图像优先上传至 AceData CDN 获取公开 URL，避免 Base64 编码的数据膨胀，提高传输效率。
- 自动图像调整：大图像自动调整大小以符合 API 限制。
- 批量生成：单次请求生成多张图像。
- 智能保存：图像保存到桌面的日期文件夹中，文件名包含唯一时间戳。
- 详细日志：显示完整的 JSON 响应，便于调试和透明化。
Parameters / 参数详解
| Parameter / 参数 | Default / 默认值 | Description / 说明 |
|---|---|---|
--prompt | (required for generate) | Text description of the desired image / 期望图像的文本描述 |
--count | 1 | Number of images to generate / 要生成的图像数量 |
--model | nano-banana-2 | Model to use (nano-banana-2, nano-banana-pro, nano-banana) / 使用的模型 |
--resolution | 2K | Output resolution (2K, 4K, etc.) / 输出分辨率 |
--aspect_ratio | 16:9 | Aspect ratio (16:9, 1:1, 4:3, etc.) / 宽高比 |
--image | (optional) | Local image paths or URLs for edit mode (max 4) / 编辑模式的本地图像路径或 URL（最多 4 个） |
--api_key | (optional) | Bearer Token for AceData API / AceData API 的 Bearer Token |
Examples / 示例
Example 1: Basic Text‑to‑Image / 示例 1：基础文生图
English:
python scripts/generate_images.py --prompt "a serene mountain landscape at sunset" --count 2 --resolution "4K"
中文:
python scripts/generate_images.py --prompt "日落时宁静的山景" --count 2 --resolution "4K"
Example 2: Image Editing / 示例 2：图像编辑
English:
python scripts/generate_images.py --image "input.jpg" --prompt "make it look like a watercolor painting"
中文:
python scripts/generate_images.py --image "input.jpg" --prompt "让它看起来像水彩画"
Example 3: Batch Generation with Custom Aspect Ratio / 示例 3：自定义宽高比的批量生成
English:
python scripts/generate_images.py --prompt "cyberpunk city street" --count 4 --aspect_ratio "1:1"
中文:
python scripts/generate_images.py --prompt "赛博朋克城市街道" --count 4 --aspect_ratio "1:1"
Notes / 注意事项
English:
- The API may have rate limits and usage quotas. Check your AceData dashboard for details.
- Generated images are stored on AceData's CDN for a limited time; download them promptly.
- For large images (>1 MB), the script automatically resizes them to avoid timeout errors.
- Ensure your internet connection is stable during generation (requests can take up to 180 seconds).
中文:
- API 可能有速率限制和使用配额。请查看您的 AceData 控制台了解详情。
- 生成的图像在 AceData 的 CDN 上存储时间有限，请及时下载。
References / 参考资料
- API Documentation – Detailed Nano Banana API specifications.
- AceData Cloud Platform – Manage your API keys and usage.