Documentation Index
Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
Use this file to discover all available pages before exploring further.
Pricing: $0.08/image. Endpoint:
POST /v1/models/google/nano-banana-2/runs.Overview
- Endpoint: https://api.runflow.io/v1/models/google/nano-banana-2/runs
- Model ID: google/nano-banana-2
- Provider: Google
- License: commercial
- Last Updated: 2026-04-13
Pricing
- Base price: $0.08/image
- Note: Per image (1K default)
Nano Banana 2 API
Endpoint:POST /v1/models/google/nano-banana-2/runs
Run the model
Python
Node.js
cURL
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
input | object | required | Model input parameters. See “Input schema” below. |
callback_url | string | null | optional | Webhook URL - POSTed when the run reaches a terminal state. |
metadata | object | null | optional | Arbitrary key-value pairs attached to the run. |
Input schema
| Field | Type | Required | Allowed values | Description |
|---|---|---|---|---|
prompt | string | required | Any | Text prompt describing the image. 3–50,000 characters. |
resolution | string | optional | 0.5K, 1K, 2K, 4K | Output resolution. Options: “0.5K”, “1K”, “2K”, “4K”. Default: “1K”. Price varies by tier. |
aspect_ratio | string | optional | auto, 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 | Image aspect ratio. Options: “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”. Use “auto” to let the model decide. Default: “auto”. |
enable_web_search | boolean | optional | Any | Enable web search to ground generation in current information. +$0.015/image. Default: false. |
thinking_level | string | optional | minimal, high | Enable model thinking. Options: “minimal”, “high”. Adds +$0.002/image at high level. Omit to disable. |
num_images | integer | optional | Any | Number of images to generate. Range: 1–4. Default: 1. |
output_format | string | optional | jpeg, png, webp | Output format. Options: “jpeg”, “png”, “webp”. Default: “png”. |
safety_tolerance | string | optional | Any | Content moderation level. 1 = most strict, 6 = least strict. Default: 4. |
seed | integer | optional | Any | Random seed for reproducible outputs. |
limit_generations | boolean | optional | Any | Limit to 1 image per prompt round regardless of prompt instructions. Default: true. |
sync_mode | boolean | optional | Any | Return media as data URI without storing in history. Default: false. |
Output schema
| Field | Type | Description |
|---|---|---|
outputs | json | Unified output array - one entry per generated artifact with url/type/width/height/duration/etc. |
model_data | json | Model-specific extra fields (prompt, description, actual_prompt, masks, etc.) keyed by field name. |
nsfw_detected | json | true if the provider flagged output as NSFW, false if cleared, null if not checked. |
seed | json | Deterministic seed used for generation, or null if the provider doesn’t return one. |
timing | json | Provider timing info (inference_ms etc.), or null. |
Callback payload
When you provide acallback_url, Runflow POSTs to it once the run reaches a terminal state.
| Field | Type | Description |
|---|---|---|
event | string | Event type: “run.completed”, “run.failed”, or “run.cancelled”. |
run_id | string | The unique identifier of the run. |
status | string | Terminal status: “succeeded”, “failed”, or “cancelled”. |
output | object | null | The run output. Null if the run failed or was cancelled. |
duration_ms | number | null | Total run duration in milliseconds. |
created_at | string | null | ISO 8601 timestamp when the run was created. |
completed_at | string | null | ISO 8601 timestamp when the run reached terminal state. |
metadata | object | null | The metadata object passed at run creation, if any. |
- Retries: 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
- Headers:
Runflow-Request-Idis always sent.Runflow-Signatureis sent if a signing secret is configured.
Additional Resources
Related
Browse all models
Browse the catalog.
Run lifecycle
Callbacks, polling, statuses.
Callbacks
Handle async results.
Pricing
How requests bill out.