GET

/v1/schemas/fal/image/fal-ai/gemini-3-pro-image-preview/edit

Accept:

kind inputactivity imagehash d15fc615…extracted Nov 10, 2026version currentsource upstream spec ↗

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

Request body

20 properties · 1 required · 5 $defs

property	type	description	constraints
prompt*	string	The prompt for image editing.	length ≥ 3 · length ≤ 50000
temperature	number	Sampling temperature. Omit to use the provider default of 1. Explicit values use a direct Google or Vertex API.	0 ≤ n ≤ 2 · nullable
num_images	integer	The number of images to generate.	1 ≤ n ≤ 4 · default: 1
top_p	number	Nucleus sampling probability. Omit to use the provider default of 0.95. Explicit values use a direct Google or Vertex API.	0 ≤ n ≤ 1 · nullable
history	GeminiMessage[]	Previous native user/model turns. Replay a returned conversation's messages unchanged, including thought signatures; the current prompt is appended as a new user turn.
resolution	enum	The resolution of the image to generate.	1K \| 2K \| 4K · default: "1K"
return_history	boolean	Return reusable native conversations with original image parts and provider thought signatures. Uses a native provider. Each generated conversation is independent; send its messages as history for the next turn.	default: false
safety_tolerance	enum	The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.	1 \| 2 \| 3 \| 4 \| 5 \| 6 · default: "4"
context	GeminiTextPart \| GeminiImagePart \| GeminiDocumentPart[]	Ordered text, original images, PDF or UTF-8 text documents appended to the current prompt. Uses a native provider. Images count toward the total 14-reference limit.
enable_web_search	boolean	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
sync_mode	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.	default: false
limit_generations	boolean	Experimental parameter to limit the number of generations from each round of prompting to 1. Set to `True` to to disregard any instructions in the prompt regarding the number of images to generate.	default: true
thinking_level	const	Thinking effort. Pro Image supports only high; omit to retain its provider default. An explicit level requests summaries unless include_thoughts overrides it. Thinking cannot be disabled.	"high" · nullable
output_format	enum	The format of the generated image.	jpeg \| png \| webp · default: "png"
system_prompt	string	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 instruction to Gemini (or as a system message on OpenAI-compatible providers).	length ≤ 50000 · default: ""
image_urls	string[]	The URLs of the images to use for image-to-image generation or image editing.
include_thoughts	boolean	Whether to include thought summaries. Omit to preserve the existing behavior: an explicit thinking_level requests summaries. Set limit_generations=false to return summary text in description. This does not disable thinking or return intermediate thought images.	nullable
max_output_tokens	integer	Maximum output tokens for the generation. Omit to retain the provider default. Explicit values use a direct Google or Vertex API.	1 ≤ n ≤ 32768 · nullable
seed	integer	The seed for the random number generator.	nullable
aspect_ratio	enum	The aspect ratio of the generated image, including 1:4, 4:1, 1:8 and 8:1.	auto \| 21:9 \| 16:9 \| 3:2 \| 4:3 \| 5:4 · +9 more · nullable

Types

5 $defs

GeminiDocumentPartobject

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

GeminiImagePartobject

image_url*	string	Original image URL or data URI. Replayed without resizing or re-encoding.
type*	const	The image part discriminator.	"image"
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

GeminiMessageobject

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

GeminiSignaturePartobject

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

GeminiTextPartobject

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

Validate a payload

before you spend tokens

shell

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