Nano Banana 2 Edit: 프롬프트 기반 이미지 편집(다중 이미지 입력, 해상도·안전 제어) | RunComfy
Nano Banana 2 Edit로 텍스트 프롬프트를 사용해 한 장 또는 여러 장의 이미지를 편집하세요. 종횡비, 해상도, 안전 허용도, 출력 형식, 생성 제한을 제어할 수 있습니다.
Table of contents
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이면 각 프롬프트 라운드를 한 번의 생성으로 제한합니다.",
"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" }
}
}
}
}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.