logo
RunComfy
  • ComfyUI
  • TrainerNew
  • Models
  • API
  • Pricing
discord logo
MODELS
Explore
All Models
LIBRARY
Generations
MODEL APIS
API Docs
API Keys
ACCOUNT
Usage

Nano Banana 2 Edit:プロンプト主導の画像編集(複数画像入力、解像度・安全性コントロール)| RunComfy

google/nano-banana-2/edit

Nano Banana 2 Edit を使って、テキストプロンプトで1枚または複数枚の画像を編集。アスペクト比、解像度、安全性許容度、出力形式、生成回数の制限をコントロールできます。

Table of contents

1. Get started2. Authentication3. API referenceSubmit a requestMonitor request statusRetrieve request resultsCancel a request4. File inputsHosted file (URL)5. SchemaInput schemaOutput schema

1. Get started

Use RunComfy's API to run google/nano-banana-2/edit. For accepted inputs and outputs, see the model's schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/nano-banana-2/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Keep the subject identity unchanged, convert the background into a rainy neon cyberpunk street at night, cinematic lighting, high detail.",
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7324/media-files/input-1-1.png"
    ]
  }'

2. Authentication

Set the YOUR_API_TOKEN environment variable with your API key (manage keys in your Profile) and include it on every request as a Bearer token via the Authorization header: Authorization: Bearer $YOUR_API_TOKEN.

3. API reference

Submit a request

Submit an asynchronous generation job and immediately receive a request_id plus URLs to check status, fetch results, and cancel.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/nano-banana-2/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Keep the subject identity unchanged, convert the background into a rainy neon cyberpunk street at night, cinematic lighting, high detail.",
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7324/media-files/input-1-1.png"
    ]
  }'

Monitor request status

Fetch the current state for a request_id ("in_queue", "in_progress", "completed", or "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Retrieve request results

Retrieve the final outputs and metadata for the given request_id; if the job is not complete, the response returns the current state so you can continue polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancel a request

Cancel a queued job by request_id, in-progress jobs cannot be cancelled.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. File inputs

Hosted file (URL)

Provide a publicly reachable HTTPS URL. Ensure the host allows server‑side fetches (no login/cookies required) and isn't rate‑limited or blocking bots. Recommended limits: images ≤ 50 MB (~4K), videos ≤ 100 MB (~2–5 min @ 720p). Prefer stable or pre‑signed URLs for private assets.

5. Schema

Input schema

{
  "type": "object",
  "title": "Input",
  "required": [
    "prompt",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "title": "プロンプト",
      "description": "画像編集のためのプロンプトです。",
      "type": "string",
      "default": "Keep the subject identity unchanged, convert the background into a rainy neon cyberpunk street at night, cinematic lighting, high detail."
    },
    "image_urls": {
      "title": "画像",
      "description": "image-to-image 生成または画像編集に使用する画像URLです。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 20,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7324/media-files/input-1-1.png"
      ]
    },
    "num_images": {
      "title": "生成枚数",
      "description": "生成する画像の枚数です。",
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 4
    },
    "seed": {
      "title": "シード",
      "description": "乱数生成器のシードです。",
      "type": "integer",
      "default": 0
    },
    "aspect_ratio": {
      "title": "アスペクト比(W:H)",
      "description": "生成画像のアスペクト比です。",
      "type": "string",
      "enum": [
        "auto",
        "21:9",
        "16:9",
        "3:2",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "2:3",
        "9:16"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "解像度",
      "description": "生成する画像の解像度です。",
      "type": "string",
      "enum": [
        "0.5K",
        "1K",
        "2K",
        "4K"
      ],
      "default": "1K"
    },
    "output_format": {
      "title": "出力形式",
      "description": "生成画像の形式です。",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "safety_tolerance": {
      "title": "安全性許容度",
      "description": "コンテンツモデレーションの安全性許容度です。1が最も厳格で、6が最も緩やかです。",
      "type": "integer",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6
      ],
      "default": 4
    },
    "limit_generations": {
      "title": "生成回数を制限",
      "description": "true の場合、各プロンプトラウンドを1回の生成に制限します。",
      "type": "boolean",
      "default": true
    },
    "enable_web_search": {
      "title": "ウェブ検索を有効化",
      "description": "生成時に最新情報を参照するためのウェブ検索を有効にします。",
      "type": "boolean",
      "default": false
    }
  }
}

Output schema

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "single image URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "single video URL"
      },
      "images": {
        "type": "array",
        "description": "multiple image URLs",
        "items": { "type": "string", "format": "uri" }
      },
      "videos": {
        "type": "array",
        "description": "multiple video URLs",
        "items": { "type": "string", "format": "uri" }
      }
    }
  }
}
Follow us
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • Email
  • System Status
  • Affiliate
Video Models
  • Seedance 1.0
  • Wan 2.6
  • Wan 2.6 Flash
  • Wan 2.2
  • Seedance 1.5 Pro
  • Hailuo 02
  • View All Models →
Image Models
  • Seedream 5.0 Lite
  • Seedream 5.0 Lite text to image
  • Wan 2.6 Image to Image
  • Nano Banana Pro
  • seedream 4.0
  • Flux 2 Dev
  • View All Models →
Legal
  • Terms of Service
  • Privacy Policy
  • Cookie Policy
RunComfy
Copyright 2026 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.