Skip to main content
ArtEmotion
Image

Nano Banana 2

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

Nano Banana 2 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 (optional)
  • Batch up to 4 per request

Example prompt

A massive translucent jellyfish floating through a sunlit library atrium, its luminous tendrils gently brushing the spines of leather-bound books on towering mahogany shelves. Golden afternoon light streams through arched skylights casting prismatic rainbow patterns on the marble floor below.
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.

POST/api/v1/generate16 fields · 2 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_urlstringOptionalFormat: uri
Minimal request example
{
  "model_id": "fal-ai/nano-banana-2",
  "prompt": "A massive translucent jellyfish floating through a sunlit library atrium, its luminous tendrils gently brushing the spines of leather-bound books on towering mahogany shelves. Golden afternoon light streams through arched skylights casting prismatic rainbow patterns on the marble floor below."
}
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",
  "title": "Nano Banana 2 generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-2.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/nano-banana-2",
      "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"
  ],
  "additionalProperties": false
}

FAQ

How much does Nano Banana 2 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 fails?

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

Can I call Nano Banana 2 from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/nano-banana-2". 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?

Start now →

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