GET

/v1/schemas/fal/image/fal-ai/nano-banana-pro?kind=output

Accept:

kind outputactivity imagehash ca619883…extracted Nov 10, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `040e9342fcb4b859e76f2f91debd6c4d142c2c7e503d1d4c67858c59d8b98d34` { "fetchedAt": 1794286801, "extractorVersion": "2", "verifiedAt": null }

Response body

4 properties · 2 required · 9 $defs

property	type	description
description*	string	The description of the generated images.
images*	ImageFile[]	The generated images.
grounding_metadata	object[]	Provider grounding metadata for the generated images, including search queries, source pages and image-source attribution when available.
conversations	GeminiConversation[]	Reusable per-generation conversations, populated only when return_history is true. Retain every part and thought signature when continuing a conversation.

Types

9 $defs

GeminiAudioPartobject

thought_signature	string	Opaque provider-issued thought signature. Replay it unchanged on its original part.	length ≥ 1 · nullable
thought	boolean	Provider thought marker, preserved when replaying a returned conversation.	nullable
audio_url*	string	Original audio URL or data URI from a previous Flash Image request (up to 15 MB).
type*	const	The audio part discriminator.	"audio"

GeminiConversationobject

messages*

GeminiVideoMessage[]

One complete provider conversation. Pass messages as history in the next request, retaining every signature and part.

GeminiDocumentPartobject

thought_signature	string	Opaque provider-issued thought signature. Replay it unchanged on its original part.	length ≥ 1 · nullable
thought	boolean	Provider thought marker, preserved when replaying a returned conversation.	nullable
file_url*	string	PDF or UTF-8 plain-text document URL or data URI (up to 15 MB).
mime_type*	enum	The document's media type.	application/pdf \| text/plain
type*	const	The document part discriminator.	"document"

GeminiImagePartobject

thought_signature	string	Opaque provider-issued thought signature. Replay it unchanged on its original part.	length ≥ 1 · nullable
thought	boolean	Provider thought marker, preserved when replaying a returned conversation.	nullable
image_url*	string	Original image URL or data URI. Replayed without resizing or re-encoding.
type*	const	The image part discriminator.	"image"

GeminiSignaturePartobject

thought_signature*	string	Provider-issued signature-only part, replayed unchanged.	length ≥ 1
thought	boolean	Provider thought marker, preserved when replaying a returned conversation.	nullable
type*	const	The signature part discriminator.	"signature"

GeminiTextPartobject

thought_signature	string	Opaque provider-issued thought signature. Replay it unchanged on its original part.	length ≥ 1 · nullable
text*	string	Text at this position in the conversation.
thought	boolean	Provider thought marker, preserved when replaying a returned conversation.	nullable
type*	const	The text part discriminator.	"text"

GeminiVideoMessageobject

parts*	GeminiTextPart \| GeminiImagePart \| GeminiDocumentPart[]	Ordered text, image, document, video, audio, and signature parts.	items ≥ 1
role*	enum	Native Gemini conversation role.	user \| model

GeminiVideoPartobject

video_url*	string	Video URL or data URI (up to 15 MB and 120 seconds), or a YouTube URL. Supported by Flash Image only.
thought	boolean	Provider thought marker, preserved when replaying a returned conversation.	nullable
thought_signature	string	Opaque provider-issued thought signature. Replay it unchanged on its original part.	length ≥ 1 · nullable
type*	const	The video part discriminator.	"video"

ImageFileobject

file_name	string	The name of the file. It will be auto-generated if not provided.	nullable
file_size	integer	The size of the file in bytes.	nullable
url*	string	The URL where the file can be downloaded from.
width	integer	The width of the image	nullable
height	integer	The height of the image	nullable
content_type	string	The mime type of the file.	nullable

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/nano-banana-pro","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}