功能描述

Generate and edit images using the AceData Nano Banana API. Supports models like nano-banana-2, custom aspect ratios (default 16:9), and resolutions (default...

使用说明 (SKILL.md)

Ace Banana2 Image Generation / Ace Banana2 图像生成

Name: Ace Banana2 Image Generation / Ace Banana2 图像生成
Author: xiyunnet

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 驱动的转换编辑现有图像。该技能支持多种模型、可自定义参数，并自动将生成的图像保存到桌面。

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、1:1、4:3 等宽高比。

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.
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 张本地图像（转换为 Base64）或提供图像 URL。
自动图像调整：大图像自动调整大小以符合 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 上存储时间有限，请及时下载。
对于大图像（>1 MB），脚本会自动调整大小以避免超时错误。
生成期间请确保网络连接稳定（请求可能长达 180 秒）。

References / 参考资料

API Documentation – Detailed Nano Banana API specifications.
AceData Cloud Platform – Manage your API keys and usage.

安全使用建议

This skill's code implements image generation against https://api.acedata.cloud and mostly matches its description, but there are a few red flags to consider before installing: - The registry metadata does not declare that an AceData API key is required, yet the script prompts for and saves ACEDATA_API_KEY. Confirm you trust AceData and the skill author before providing a Bearer token. - The script saves your API key in plaintext to a .env file inside the skill directory. If you install, consider moving that file to a secure location, deleting it after use, or manually setting ACEDATA_API_KEY in a secure environment rather than letting the script write it. - SKILL.md and the script contain different registration/share URLs — verify the correct official registration page with the service to avoid phishing/typo-squatting links. - The script uses USERPROFILE to save images to Desktop (Windows-only). On other OSes it may fail or behave unexpectedly; check and modify the save path if needed. - The skill prints full JSON responses (may include API error details or task metadata); if you are concerned about exposing results, review or sanitize output before sharing. If you decide to proceed: inspect the .env file after first run, consider running the script in an isolated environment (VM or container), and avoid reusing high-privilege tokens. If you need higher assurance, ask the skill author to update the registry metadata to declare the required ACEDATA_API_KEY and to document where tokens are stored and how to change the Desktop path.

功能分析

Type: OpenClaw Skill Name: ace-banana Version: 1.0.3 The skill provides a functional interface for the AceData Nano Banana image generation API. The main script (`scripts/generate_images.py`) manages API authentication, processes images using Pillow, and saves results to a dated folder on the user's Desktop. All behaviors, including the use of a local .env file for credential storage and the inclusion of referral links in `SKILL.md`, are transparently documented and consistent with the stated purpose of the tool.

能力评估

⚠ Purpose & Capability

The skill's purpose is image generation via AceData Nano Banana and the included script implements that. However, the registry metadata declares no required environment variables while both SKILL.md and the script require an AceData Bearer token (ACEDATA_API_KEY). This metadata omission is an incoherence the maintainer should explain.

ℹ Instruction Scope

Runtime instructions and the Python script only perform operations relevant to image generation/editing: accept prompts, encode local images to Base64, POST to the Nano Banana API, and save returned images. They do, however, prompt for and persist an API key to a .env file in the skill directory, and save generated images to the user's Desktop. The script prints full API JSON responses (which may contain metadata) and will read/write local image files — behavior consistent with the stated purpose but with privacy implications.

✓ Install Mechanism

This is instruction-only with a local Python script; there is no remote binary download or packaged installer. Dependencies are pip-installable libraries (requests, pillow), which is proportionate for the task.

⚠ Credentials

The script requires and persists ACEDATA_API_KEY but the registry metadata lists no required env vars or primary credential. It also relies on USERPROFILE to locate the Desktop (Windows-specific) without documenting cross-platform behavior. Storing the Bearer token in plaintext in a .env file inside the skill directory is convenient but increases the chance of accidental token exposure.

ℹ Persistence & Privilege

The skill does persistently store the API key in a local .env file and creates folders/files on the user's Desktop. It does not request 'always: true', does not modify other skills, nor does it access unrelated system credentials. Persisting the token and writing to Desktop are expected for this type of script but are persistent actions you should be aware of.

版本历史

v1.0.3

- Expanded documentation to include both English and Chinese instructions. - Added detailed installation steps, parameter explanations, and multiple usage examples. - Provided clear API key acquisition and configuration guidance. - Enhanced feature list and workflow description for both text-to-image and image-to-image modes. - Included troubleshooting notes and information about API limitations.

v1.0.1

- Changed skill name to ace-banana2. - Improved description with details on supported models, custom aspect ratios, batch generation, and local/remote image editing. - Added workflow: streamlined authentication (with interactive API key prompt and saving), flexible model/parameter selection, and automated output folder management. - Simplified usage: single script for prompt-driven image generation and editing; outputs include saved images and full JSON responses. - Included reference to the official API documentation.

元数据

Slug ace-banana

版本 1.0.3

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题