Atlas Nanobanana Image-to-Image 🖼️

Edits and combines images using the AtlasCloud Nanobanana 2 Edit model (google/nano-banana-2/edit).

Token Setup

Before generating images, you need the user's AtlasCloud API token.

• Check memory for atlascloud_token.
• If not found, ask the user: "Please provide your AtlasCloud API token to get started."
• Save the token to memory as atlascloud_token so it is not needed again.

How to Generate an Image

Step 1: Write the params to {baseDir}/params.json.

Step 2: Run the script:

node {baseDir}/generate.js <TOKEN> {baseDir}/params.json

Step 3 — REQUIRED: After the script finishes, run this bash command to read the generated URL:

cat {baseDir}/last_url.txt

⚠️ CRITICAL: Step 3 is mandatory and irreplaceable. The correct URL is ONLY in last_url.txt. Run cat as a separate bash command and use the exact text returned. Never use a URL from the conversation history, previous files in the context, or any other source.

Report the URL from last_url.txt to the user.

params.json — Payload Correto

⚠️ IMPORTANT: Never include media_resolution in the payload — it causes an HTTP 500 error.

{
  "prompt": "Replace the dress on the model in image 0 with the dress from image 1. Preserve identity, face, pose, and lighting.",
  "images": [
    "https://url-of-base-image.png",
    "https://url-of-reference-image.png"
  ],
  "aspect_ratio": "16:9",
  "output_format": "png",
  "resolution": "1k",
  "enable_base64_output": false,
  "enable_sync_mode": false,
  "enable_web_search": false,
  "enable_image_search": false
}

Available Fields

Do not include media_resolution — it causes a 500 error.

Prompt Tips for Image-to-Image

• Refer to images by position: "image 0" (base), "image 1" (reference).
• State clearly what to preserve: face, pose, proportions, lighting, background.
• State clearly what to replace: the clothing, the background, the style.
• Use negative instructions: "DO NOT change the face", "DO NOT transfer human elements from image 1".

Error Handling

When to use this skill:

• "swap the clothes in this photo"
• "apply the style from image 1 to image 0"
• "edit this image using another as a reference"
• "change clothes in the photo"
• "combine two images with AI"