Skip to main content
ArtEmotion
Image

Nano Banana 2 (Edit)

Credit-based pricing. Supports reference images, batch up to 4.

Nano Banana 2 (Edit) preview
Output
image
Aspect ratio
21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16, 4:1, 1:4, 8:1, 1:8
Resolution
512, 1024, 2048, 4096
Max batch
4

Inputs

  • Reference image (required)
  • Batch up to 4 per request

Example prompt

Transform this European town into a breathtaking floating sky city — the stone bridge now arches between two cloud islands thousands of meters above the earth, ancient buildings covered in hanging gardens and glowing lanterns, airships and giant kites drifting through golden clouds, the river replaced by a cascading waterfall that disappears into the sky below, epic fantasy realism
Try this prompt →
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/nano-banana-2/edit.

POST/api/v1/generate16 fields · 3 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
enable_web_searchbooleanOptionalEnable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. · Default: false
safety_tolerancenumberOptionalThe safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. · Allowed: 1, 2, 3, 4, 5, 6 · Default: 4
system_promptstringOptionalOptional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt. · Default:
thinking_levelstringOptionalWhen set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable. · Allowed: minimal, high
aspect_ratiostringOptionalAllowed: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16, 4:1, 1:4, 8:1, 1:8
resolutionstringOptionalAllowed: 512, 1024, 2048, 4096
output_formatstringOptionalAllowed: png, jpeg, webp
num_imagesintegerOptionalRange: 1–4
reference_image_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "fal-ai/nano-banana-2/edit",
  "prompt": "Transform this European town into a breathtaking floating sky city — the stone bridge now arches between two cloud islands thousands of meters above the earth, ancient buildings covered in hanging gardens and glowing lanterns, airships and giant kites drifting through golden clouds, the river replaced by a cascading waterfall that disappears into the sky below, epic fantasy realism",
  "reference_image_url": "https://example.com/reference_image"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-2%2Fedit",
  "title": "Nano Banana 2 (Edit) generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-2/edit.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/nano-banana-2/edit",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "enable_web_search": {
      "title": "Enable Web Search",
      "description": "Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image.",
      "default": false,
      "type": "boolean"
    },
    "safety_tolerance": {
      "title": "Safety Tolerance",
      "description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
      "default": "4",
      "type": "number",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6
      ]
    },
    "system_prompt": {
      "title": "System Prompt",
      "description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
      "default": "",
      "type": "string"
    },
    "thinking_level": {
      "title": "Thinking Level",
      "description": "When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable.",
      "type": "string",
      "enum": [
        "minimal",
        "high"
      ]
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "3:2",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "2:3",
        "9:16",
        "4:1",
        "1:4",
        "8:1",
        "1:8"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "512",
        "1024",
        "2048",
        "4096"
      ]
    },
    "output_format": {
      "type": "string",
      "enum": [
        "png",
        "jpeg",
        "webp"
      ]
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}

FAQ

How much does Nano Banana 2 (Edit) cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Nano Banana 2 (Edit) fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Nano Banana 2 (Edit) from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/nano-banana-2/edit". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Nano Banana 2 (Edit)?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.