Gemini 3.1 Flash Image Preview

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SP_KEY' \
  -d '{"tool":"fal.gemini-3.1-flash-image-preview-edit","input":{"prompt":""},"idempotency_key":"example-request-1"}'

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "safety_tolerance": {
      "type": "string",
      "description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
      "default": "4",
      "enum": [
        "1",
        "2",
        "3",
        "4",
        "5",
        "6"
      ]
    },
    "num_images": {
      "type": "integer",
      "description": "The number of images to generate.",
      "default": 1
    },
    "enable_web_search": {
      "type": "boolean",
      "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
    },
    "aspect_ratio": {
      "type": "string",
      "description": "The aspect ratio of the generated image. Supports extreme ratios: 4:1, 1:4, 8:1, 1:8.",
      "default": "auto",
      "enum": [
        "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"
      ]
    },
    "limit_generations": {
      "type": "boolean",
      "description": "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 and ignore any intermediate images generated by the model. This may affect generation quality.",
      "default": true
    },
    "pdf_url": {
      "type": "string",
      "description": "Optional PDF document to use as input context. Accepts an http(s)/data URL (downloaded and sent inline, max 15MB)."
    },
    "image_urls": {
      "type": "array",
      "description": "The URLs of the images to use for image-to-image generation or image editing. Optional when at least one of `video_url`, `audio_url`, or `pdf_url` is provided."
    },
    "audio_url": {
      "type": "string",
      "description": "Optional audio file to use as input context. Accepts an http(s)/data URL (downloaded and sent inline, max 15MB)."
    },
    "output_format": {
      "type": "string",
      "description": "The format of the generated image.",
      "default": "png",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ]
    },
    "resolution": {
      "type": "string",
      "description": "The resolution of the image to generate.",
      "default": "1K",
      "enum": [
        "0.5K",
        "1K",
        "2K",
        "4K"
      ]
    },
    "sync_mode": {
      "type": "boolean",
      "description": "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
    },
    "seed": {
      "type": "integer",
      "description": "The seed for the random number generator."
    },
    "system_prompt": {
      "type": "string",
      "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 instruction to Gemini (or as a system message on OpenAI-compatible providers).",
      "default": ""
    },
    "prompt": {
      "type": "string",
      "description": "The prompt for image editing."
    },
    "video_url": {
      "type": "string",
      "description": "Optional video to use as input context. Accepts an http(s)/data URL to a video file (downloaded and sent inline, max 15MB) or a YouTube URL (passed through to the model without downloading)."
    },
    "thinking_level": {
      "type": "string",
      "description": "When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable.",
      "enum": [
        "minimal",
        "high"
      ]
    }
  }
}