Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging level | INFO |
| ACEDATACLOUD_API_TOKEN | Yes | API token from AceDataCloud | |
| ACEDATACLOUD_API_BASE_URL | No | API base URL | https://api.acedata.cloud |
| NANOBANANA_REQUEST_TIMEOUT | No | Request timeout in seconds | 180 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nanobanana_generate_image | Generate an AI image from a text prompt using Google's Nano Banana model. This creates high-quality images from detailed text descriptions. The more
descriptive your prompt, the better the results.
Use this when:
- You want to generate a new image from scratch
- You have a detailed description of the desired image
- You need photorealistic or artistic image generation
Prompt writing tips:
- Include: Main subject + Atmosphere + Lighting + Camera/Lens + Quality keywords
- Example: "Urban career woman, backlit sunlight, film grain, orange-gold tones, hopeful dawn"
Returns:
Task ID, trace ID, and generated image URL. |
| nanobanana_edit_image | Edit or combine images using AI based on a text prompt. This allows you to modify existing images or combine multiple images together.
Perfect for virtual try-on, product placement, image enhancement, and more.
Use this when:
- You want to combine multiple images (e.g., person + clothing)
- You want to modify an existing image
- You need virtual try-on (putting clothes on a person)
- You want to place products in different scenes
- You need to change attributes (materials, colors, styles)
Common use cases:
- Portrait replacement: Try different clothing on same person
- Product scene composition: Place products in realistic environments
- Attribute replacement: Change materials, colors, or variants
- Poster editing: Rapidly change styles or themes
- 2D to 3D conversion: Convert images to 3D product mockups
- Image restoration: Restore old or damaged photos
Returns:
Task ID, trace ID, and edited image URL. |
| nanobanana_get_task | Query the status and result of an image generation or edit task. Use this to check if a generation/edit is complete and retrieve the resulting
image URLs and metadata.
Use this when:
- You want to check if an image generation has completed
- You need to retrieve image URLs from a previous generation
- You want to get the full details of a generated/edited image
Returns:
Task status and image information including URLs and prompts. |
| nanobanana_get_tasks_batch | Query multiple image generation/edit tasks at once. Efficiently check the status of multiple tasks in a single request.
More efficient than calling nanobanana_get_task multiple times.
Use this when:
- You have multiple pending generations to check
- You want to get status of several images at once
- You're tracking a batch of generations
Returns:
Status and image information for all queried tasks. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| nanobanana_image_generation_guide | Guide for choosing the right NanoBanana tool for image tasks. |
| nanobanana_prompt_writing_guide | Guide for writing effective image generation prompts. |
| nanobanana_workflow_examples | Common workflow examples for NanoBanana image generation. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |