From f9e857e0b7c69f4dfee05d42662289fbbcc9e9c0 Mon Sep 17 00:00:00 2001
From: kasparasizi1 <132673909+kasparasizi1@users.noreply.github.com>
Date: Sun, 6 Sep 2026 21:55:33 +0300
Subject: [PATCH] =?UTF-8?q?docs(gemini):=20image=5Furl=20is=20not=20suppor?=
 =?UTF-8?q?ted=20=E2=80=94=20it=20returns=20422?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-out Gemini accepts the upload and then refuses to answer about it
(PERMISSION_DENIED from its own generate call), so scrapebadger now 422s
image asks immediately instead of charging for a request that cannot
succeed. The parameter stays on the type — removing it would break
callers — but the JSDoc no longer promises an answer. chatgpt.ask takes
an image and answers about it.

See scrape-badger/scrapebadger#1614.
---
 package.json      | 2 +-
 src/gemini/ask.ts | 9 ++++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/package.json b/package.json
index 09af713..aafc8d5 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "scrapebadger",
-  "version": "0.43.0",
+  "version": "0.43.1",
   "description": "Official Node.js SDK for ScrapeBadger - Async web scraping APIs for Twitter, Google, Vinted, Reddit, and more",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/src/gemini/ask.ts b/src/gemini/ask.ts
index 5744ef4..af2ccfc 100644
--- a/src/gemini/ask.ts
+++ b/src/gemini/ask.ts
@@ -38,9 +38,12 @@ export class AskClient {
    * @param params.prompt - The prompt to send (max 4096 characters).
    * @param params.country - ISO-3166 alpha-2 egress country (default: "US").
    * @param params.web_search - "auto", "force", or "off" (default: "auto").
-   * @param params.image_url - Public image URL to attach; Gemini answers about
-   *   the picture. It will NOT generate one — anonymous gemini.google.com requires a login
-   *   for that. Allow 90-150s for an image ask.
+   * @param params.image_url - NOT SUPPORTED; returns 422 and is never billed.
+   *   Signed-out Gemini accepts the upload and then refuses to answer about it
+   *   (PERMISSION_DENIED from its own generate call), so the API fails fast
+   *   rather than charging for a request that cannot succeed. Use
+   *   `chatgpt.ask` for image input. Gemini will not generate one either —
+   *   anonymous gemini.google.com requires a login for that.
    * @returns The answer, its citations, and the full retrieved search set.
    *
    * @example