gemini-webapi 1.16.0__tar.gz → 1.17.1__tar.gz

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/.github/workflows/pypi-publish.yml

@@ -36,7 +36,7 @@ jobs:
       - name: Build package
         run: python -m build
       - name: Archive production artifacts
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v5.0.0
         with:
           name: dist
           path: dist
@@ -52,7 +52,7 @@ jobs:
       id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
     steps:
       - name: Retrieve built artifacts
-        uses: actions/download-artifact@v5.0.0
+        uses: actions/download-artifact@v6.0.0
         with:
           name: dist
           path: dist

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/.gitignore

@@ -201,4 +201,4 @@ Temporary Items
 .apdisk
 
 # Temporary files
-temp/
+.temp/

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemini-webapi
-Version: 1.16.0
+Version: 1.17.1
 Summary: ✨ An elegant async Python wrapper for Google Gemini web app
 Author: UZQueen
 License:                     GNU AFFERO GENERAL PUBLIC LICENSE
@@ -783,11 +783,11 @@ pip install -U browser-cookie3
 
 ```yaml
 services:
-  main:
-    environment:
-      GEMINI_COOKIE_PATH: /tmp/gemini_webapi
-    volumes:
-      - ./gemini_cookies:/tmp/gemini_webapi
+    main:
+        environment:
+            GEMINI_COOKIE_PATH: /tmp/gemini_webapi
+        volumes:
+            - ./gemini_cookies:/tmp/gemini_webapi
 ```
 
 > [!NOTE]
@@ -905,16 +905,12 @@ asyncio.run(main())
 
 You can specify which language model to use by passing `model` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. The default value is `unspecified`.
 
-Currently available models (as of June 12, 2025):
+Currently available models (as of November 20, 2025):
 
 - `unspecified` - Default model
+- `gemini-3.0-pro` - Gemini 3.0 Pro
+- `gemini-2.5-pro` - Gemini 2.5 Pro
 - `gemini-2.5-flash` - Gemini 2.5 Flash
-- `gemini-2.5-pro` - Gemini 2.5 Pro (daily usage limit imposed)
-
-Deprecated models (yet still working):
-
-- `gemini-2.0-flash` - Gemini 2.0 Flash
-- `gemini-2.0-flash-thinking` - Gemini 2.0 Flash Thinking
 
 ```python
 from gemini_webapi.constants import Model
@@ -933,6 +929,23 @@ async def main():
 asyncio.run(main())
 ```
 
+You can also pass custom model header strings directly to access models which are not listed above.
+
+```python
+# "model_name" and "model_header" keys must be present
+custom_model = {
+    "model_name": "xxx",
+    "model_header": {
+        "x-goog-ext-525001261-jspb": "[1,null,null,null,'e6fa609c3fa255c0',null,null,null,[4]]"
+    },
+}
+
+response = await client.generate_content(
+    "What's your model version?",
+    model=custom_model
+)
+```
+
 ### Apply system prompt with Gemini Gems
 
 System prompt can be applied to conversations via [Gemini Gems](https://gemini.google.com/gems/view). To use a gem, you can pass `gem` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. `gem` can be either a string of gem id or a `gemini_webapi.Gem` object. Only one gem can be applied to a single conversation.

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/README.md

@@ -99,11 +99,11 @@ pip install -U browser-cookie3
 
 ```yaml
 services:
-  main:
-    environment:
-      GEMINI_COOKIE_PATH: /tmp/gemini_webapi
-    volumes:
-      - ./gemini_cookies:/tmp/gemini_webapi
+    main:
+        environment:
+            GEMINI_COOKIE_PATH: /tmp/gemini_webapi
+        volumes:
+            - ./gemini_cookies:/tmp/gemini_webapi
 ```
 
 > [!NOTE]
@@ -221,16 +221,12 @@ asyncio.run(main())
 
 You can specify which language model to use by passing `model` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. The default value is `unspecified`.
 
-Currently available models (as of June 12, 2025):
+Currently available models (as of November 20, 2025):
 
 - `unspecified` - Default model
+- `gemini-3.0-pro` - Gemini 3.0 Pro
+- `gemini-2.5-pro` - Gemini 2.5 Pro
 - `gemini-2.5-flash` - Gemini 2.5 Flash
-- `gemini-2.5-pro` - Gemini 2.5 Pro (daily usage limit imposed)
-
-Deprecated models (yet still working):
-
-- `gemini-2.0-flash` - Gemini 2.0 Flash
-- `gemini-2.0-flash-thinking` - Gemini 2.0 Flash Thinking
 
 ```python
 from gemini_webapi.constants import Model
@@ -249,6 +245,23 @@ async def main():
 asyncio.run(main())
 ```
 
+You can also pass custom model header strings directly to access models which are not listed above.
+
+```python
+# "model_name" and "model_header" keys must be present
+custom_model = {
+    "model_name": "xxx",
+    "model_header": {
+        "x-goog-ext-525001261-jspb": "[1,null,null,null,'e6fa609c3fa255c0',null,null,null,[4]]"
+    },
+}
+
+response = await client.generate_content(
+    "What's your model version?",
+    model=custom_model
+)
+```
+
 ### Apply system prompt with Gemini Gems
 
 System prompt can be applied to conversations via [Gemini Gems](https://gemini.google.com/gems/view). To use a gem, you can pass `gem` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. `gem` can be either a string of gem id or a `gemini_webapi.Gem` object. Only one gem can be applied to a single conversation.

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/src/gemini_webapi/client.py

@@ -10,31 +10,33 @@ from httpx import AsyncClient, ReadTimeout, Response
 from .components import GemMixin
 from .constants import Endpoint, ErrorCode, Headers, Model
 from .exceptions import (
-    AuthError,
     APIError,
-    ImageGenerationError,
-    TimeoutError,
+    AuthError,
     GeminiError,
-    UsageLimitExceeded,
+    ImageGenerationError,
     ModelInvalid,
     TemporarilyBlocked,
+    TimeoutError,
+    UsageLimitExceeded,
 )
 from .types import (
-    WebImage,
-    GeneratedImage,
     Candidate,
-    ModelOutput,
     Gem,
+    GeneratedImage,
+    ModelOutput,
     RPCData,
+    WebImage,
 )
 from .utils import (
-    upload_file,
+    extract_json_from_response,
+    get_access_token,
+    get_nested_value,
+    logger,
     parse_file_name,
     rotate_1psidts,
-    get_access_token,
-    running,
     rotate_tasks,
-    logger,
+    running,
+    upload_file,
 )
 
 
@@ -42,7 +44,7 @@ class GeminiClient(GemMixin):
     """
     Async httpx client interface for gemini.google.com.
 
-    `secure_1psid` must be provided unless the optional dependency `browser-cookie3` is installed and
+    `secure_1psid` must be provided unless the optional dependency `browser-cookie3` is installed, and
     you have logged in to google.com in your local browser.
 
     Parameters
@@ -203,6 +205,7 @@ class GeminiClient(GemMixin):
         if self.close_task:
             self.close_task.cancel()
             self.close_task = None
+
         self.close_task = asyncio.create_task(self.close(self.close_delay))
 
     async def start_auto_refresh(self) -> None:
@@ -211,18 +214,25 @@ class GeminiClient(GemMixin):
         """
 
         while True:
+            new_1psidts: str | None = None
             try:
                 new_1psidts = await rotate_1psidts(self.cookies, self.proxy)
             except AuthError:
-                if task := rotate_tasks.get(self.cookies["__Secure-1PSID"]):
+                if task := rotate_tasks.get(self.cookies.get("__Secure-1PSID", "")):
                     task.cancel()
                 logger.warning(
-                    "Failed to refresh cookies. Background auto refresh task canceled."
+                    "AuthError: Failed to refresh cookies. Auto refresh task canceled."
                 )
+                return
+            except Exception as exc:
+                logger.warning(f"Unexpected error while refreshing cookies: {exc}")
 
-            logger.debug(f"Cookies refreshed. New __Secure-1PSIDTS: {new_1psidts}")
             if new_1psidts:
                 self.cookies["__Secure-1PSIDTS"] = new_1psidts
+                if self.running:
+                    self.client.cookies.set("__Secure-1PSIDTS", new_1psidts)
+                logger.debug("Cookies refreshed. New __Secure-1PSIDTS applied.")
+
             await asyncio.sleep(self.refresh_interval)
 
     @running(retry=2)
@@ -230,7 +240,7 @@ class GeminiClient(GemMixin):
         self,
         prompt: str,
         files: list[str | Path] | None = None,
-        model: Model | str = Model.UNSPECIFIED,
+        model: Model | str | dict = Model.UNSPECIFIED,
         gem: Gem | str | None = None,
         chat: Optional["ChatSession"] = None,
         **kwargs,
@@ -244,9 +254,10 @@ class GeminiClient(GemMixin):
             Prompt provided by user.
         files: `list[str | Path]`, optional
             List of file paths to be attached.
-        model: `Model` | `str`, optional
+        model: `Model | str | dict`, optional
             Specify the model to use for generation.
-            Pass either a `gemini_webapi.constants.Model` enum or a model name string.
+            Pass either a `gemini_webapi.constants.Model` enum or a model name string to use predefined models.
+            Pass a dictionary to use custom model header strings ("model_name" and "model_header" keys must be provided).
         gem: `Gem | str`, optional
             Specify a gem to use as system prompt for the chat session.
             Pass either a `gemini_webapi.types.Gem` object or a gem id string.
@@ -277,8 +288,15 @@ class GeminiClient(GemMixin):
 
         assert prompt, "Prompt cannot be empty."
 
-        if not isinstance(model, Model):
+        if isinstance(model, str):
             model = Model.from_name(model)
+        elif isinstance(model, dict):
+            model = Model.from_dict(model)
+        elif not isinstance(model, Model):
+            raise TypeError(
+                f"'model' must be a `gemini_webapi.constants.Model` instance, "
+                f"string, or dictionary; got `{type(model).__name__}`"
+            )
 
         if isinstance(gem, Gem):
             gem_id = gem.id
@@ -335,18 +353,24 @@ class GeminiClient(GemMixin):
                 f"Failed to generate contents. Request failed with status code {response.status_code}"
             )
         else:
+            response_json: list[Any] = []
+            body: list[Any] = []
+            body_index = 0
+
             try:
-                response_json = json.loads(response.text.split("\n")[2])
+                response_json = extract_json_from_response(response.text)
 
-                body = None
-                body_index = 0
                 for part_index, part in enumerate(response_json):
                     try:
-                        main_part = json.loads(part[2])
-                        if main_part[4]:
-                            body_index, body = part_index, main_part
+                        part_body = get_nested_value(part, [2])
+                        if not part_body:
+                            continue
+
+                        part_json = json.loads(part_body)
+                        if get_nested_value(part_json, [4]):
+                            body_index, body = part_index, part_json
                             break
-                    except (IndexError, TypeError, ValueError):
+                    except json.JSONDecodeError:
                         continue
 
                 if not body:
@@ -355,7 +379,8 @@ class GeminiClient(GemMixin):
                 await self.close()
 
                 try:
-                    match ErrorCode(response_json[0][5][2][0][1][0]):
+                    error_code = get_nested_value(response_json, [0, 5, 2, 0, 1, 0], -1)
+                    match ErrorCode(error_code):
                         case ErrorCode.USAGE_LIMIT_EXCEEDED:
                             raise UsageLimitExceeded(
                                 f"Failed to generate contents. Usage limit of {model.model_name} model has exceeded. Please try switching to another model."
@@ -385,47 +410,58 @@ class GeminiClient(GemMixin):
                     )
 
             try:
-                candidates = []
-                for candidate_index, candidate in enumerate(body[4]):
-                    text = candidate[1][0]
+                candidate_list: list[Any] = get_nested_value(body, [4], [])
+                output_candidates: list[Candidate] = []
+
+                for candidate_index, candidate in enumerate(candidate_list):
+                    rcid = get_nested_value(candidate, [0])
+                    if not rcid:
+                        continue  # Skip candidate if it has no rcid
+
+                    # Text output and thoughts
+                    text = get_nested_value(candidate, [1, 0], "")
                     if re.match(
                         r"^http://googleusercontent\.com/card_content/\d+", text
                     ):
-                        text = candidate[22] and candidate[22][0] or text
+                        text = get_nested_value(candidate, [22, 0]) or text
 
-                    try:
-                        thoughts = candidate[37][0][0]
-                    except (TypeError, IndexError):
-                        thoughts = None
-
-                    web_images = (
-                        candidate[12]
-                        and candidate[12][1]
-                        and [
+                    thoughts = get_nested_value(candidate, [37, 0, 0])
+
+                    # Web images
+                    web_images = []
+                    for web_img_data in get_nested_value(candidate, [12, 1], []):
+                        url = get_nested_value(web_img_data, [0, 0, 0])
+                        if not url:
+                            continue
+
+                        web_images.append(
                             WebImage(
-                                url=web_image[0][0][0],
-                                title=web_image[7][0],
-                                alt=web_image[0][4],
+                                url=url,
+                                title=get_nested_value(web_img_data, [7, 0], ""),
+                                alt=get_nested_value(web_img_data, [0, 4], ""),
                                 proxy=self.proxy,
                             )
-                            for web_image in candidate[12][1]
-                        ]
-                        or []
-                    )
+                        )
 
+                    # Generated images
                     generated_images = []
-                    if candidate[12] and candidate[12][7] and candidate[12][7][0]:
+                    if get_nested_value(candidate, [12, 7, 0]):
                         img_body = None
                         for img_part_index, part in enumerate(response_json):
                             if img_part_index < body_index:
                                 continue
-
                             try:
-                                img_part = json.loads(part[2])
-                                if img_part[4][candidate_index][12][7][0]:
-                                    img_body = img_part
+                                img_part_body = get_nested_value(part, [2])
+                                if not img_part_body:
+                                    continue
+
+                                img_part_json = json.loads(img_part_body)
+                                if get_nested_value(
+                                    img_part_json, [4, candidate_index, 12, 7, 0]
+                                ):
+                                    img_body = img_part_json
                                     break
-                            except (IndexError, TypeError, ValueError):
+                            except json.JSONDecodeError:
                                 continue
 
                         if not img_body:
@@ -434,57 +470,73 @@ class GeminiClient(GemMixin):
                                 "If the error persists and is caused by the package, please report it on GitHub."
                             )
 
-                        img_candidate = img_body[4][candidate_index]
-
-                        text = re.sub(
-                            r"http://googleusercontent\.com/image_generation_content/\d+",
-                            "",
-                            img_candidate[1][0],
-                        ).rstrip()
-
-                        generated_images = [
-                            GeneratedImage(
-                                url=generated_image[0][3][3],
-                                title=(
-                                    f"[Generated Image {generated_image[3][6]}]"
-                                    if generated_image[3][6]
-                                    else "[Generated Image]"
-                                ),
-                                alt=(
-                                    generated_image[3][5][image_index]
-                                    if generated_image[3][5]
-                                    and len(generated_image[3][5]) > image_index
-                                    else (
-                                        generated_image[3][5][0]
-                                        if generated_image[3][5]
-                                        else ""
-                                    )
-                                ),
-                                proxy=self.proxy,
-                                cookies=self.cookies,
+                        img_candidate = get_nested_value(
+                            img_body, [4, candidate_index], []
+                        )
+
+                        if finished_text := get_nested_value(
+                            img_candidate, [1, 0]
+                        ):  # Only overwrite if new text is returned after image generation
+                            text = re.sub(
+                                r"http://googleusercontent\.com/image_generation_content/\d+",
+                                "",
+                                finished_text,
+                            ).rstrip()
+
+                        for img_index, gen_img_data in enumerate(
+                            get_nested_value(img_candidate, [12, 7, 0], [])
+                        ):
+                            url = get_nested_value(gen_img_data, [0, 3, 3])
+                            if not url:
+                                continue
+
+                            img_num = get_nested_value(gen_img_data, [3, 6])
+                            title = (
+                                f"[Generated Image {img_num}]"
+                                if img_num
+                                else "[Generated Image]"
+                            )
+
+                            alt_list = get_nested_value(gen_img_data, [3, 5], [])
+                            alt = (
+                                get_nested_value(alt_list, [img_index])
+                                or get_nested_value(alt_list, [0])
+                                or ""
                             )
-                            for image_index, generated_image in enumerate(
-                                img_candidate[12][7][0]
+
+                            generated_images.append(
+                                GeneratedImage(
+                                    url=url,
+                                    title=title,
+                                    alt=alt,
+                                    proxy=self.proxy,
+                                    cookies=self.cookies,
+                                )
                             )
-                        ]
 
-                    candidates.append(
+                    output_candidates.append(
                         Candidate(
-                            rcid=candidate[0],
+                            rcid=rcid,
                             text=text,
                             thoughts=thoughts,
                             web_images=web_images,
                             generated_images=generated_images,
                         )
                     )
-                if not candidates:
+
+                if not output_candidates:
                     raise GeminiError(
                         "Failed to generate contents. No output data found in response."
                     )
 
-                output = ModelOutput(metadata=body[1], candidates=candidates)
-            except (TypeError, IndexError):
-                logger.debug(f"Invalid response: {response.text}")
+                output = ModelOutput(
+                    metadata=get_nested_value(body, [1], []),
+                    candidates=output_candidates,
+                )
+            except (TypeError, IndexError) as e:
+                logger.debug(
+                    f"{type(e).__name__}: {e}; Invalid response structure: {response.text}"
+                )
                 raise APIError(
                     "Failed to parse response body. Data structure is invalid."
                 )
@@ -574,9 +626,10 @@ class ChatSession:
         Reply id, if provided together with metadata, will override the second value in it.
     rcid: `str`, optional
         Reply candidate id, if provided together with metadata, will override the third value in it.
-    model: `Model` | `str`, optional
+    model: `Model | str | dict`, optional
         Specify the model to use for generation.
-        Pass either a `gemini_webapi.constants.Model` enum or a model name string.
+        Pass either a `gemini_webapi.constants.Model` enum or a model name string to use predefined models.
+        Pass a dictionary to use custom model header strings ("model_name" and "model_header" keys must be provided).
     gem: `Gem | str`, optional
         Specify a gem to use as system prompt for the chat session.
         Pass either a `gemini_webapi.types.Gem` object or a gem id string.
@@ -597,13 +650,13 @@ class ChatSession:
         cid: str | None = None,  # chat id
         rid: str | None = None,  # reply id
         rcid: str | None = None,  # reply candidate id
-        model: Model | str = Model.UNSPECIFIED,
+        model: Model | str | dict = Model.UNSPECIFIED,
         gem: Gem | str | None = None,
     ):
         self.__metadata: list[str | None] = [None, None, None]
         self.geminiclient: GeminiClient = geminiclient
         self.last_output: ModelOutput | None = None
-        self.model: Model | str = model
+        self.model: Model | str | dict = model
         self.gem: Gem | str | None = gem
 
         if metadata:

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/src/gemini_webapi/constants.py

@@ -43,26 +43,27 @@ class Headers(Enum):
 
 class Model(Enum):
     UNSPECIFIED = ("unspecified", {}, False)
-    G_2_5_FLASH = (
-        "gemini-2.5-flash",
-        {"x-goog-ext-525001261-jspb": '[1,null,null,null,"71c2d248d3b102ff",null,null,0,[4]]'},
+    G_3_0_PRO = (
+        "gemini-3.0-pro",
+        {
+            "x-goog-ext-525001261-jspb": '[1,null,null,null,"9d8ca3786ebdfbea",null,null,0,[4]]'
+        },
         False,
     )
     G_2_5_PRO = (
         "gemini-2.5-pro",
-        {"x-goog-ext-525001261-jspb": '[1,null,null,null,"4af6c7f5da75d65d",null,null,0,[4]]'},
+        {
+            "x-goog-ext-525001261-jspb": '[1,null,null,null,"4af6c7f5da75d65d",null,null,0,[4]]'
+        },
         False,
     )
-    G_2_0_FLASH = (
-        "gemini-2.0-flash",
-        {"x-goog-ext-525001261-jspb": '[1,null,null,null,"f299729663a2343f"]'},
-        False,
-    )  # Deprecated
-    G_2_0_FLASH_THINKING = (
-        "gemini-2.0-flash-thinking",
-        {"x-goog-ext-525001261-jspb": '[null,null,null,null,"7ca48d02d802f20a"]'},
+    G_2_5_FLASH = (
+        "gemini-2.5-flash",
+        {
+            "x-goog-ext-525001261-jspb": '[1,null,null,null,"9ec249fc9ad08861",null,null,0,[4]]'
+        },
         False,
-    )  # Deprecated
+    )
 
     def __init__(self, name, header, advanced_only):
         self.model_name = name
@@ -74,10 +75,28 @@ class Model(Enum):
         for model in cls:
             if model.model_name == name:
                 return model
+
         raise ValueError(
             f"Unknown model name: {name}. Available models: {', '.join([model.model_name for model in cls])}"
         )
 
+    @classmethod
+    def from_dict(cls, model_dict: dict):
+        if "model_name" not in model_dict or "model_header" not in model_dict:
+            raise ValueError(
+                "When passing a custom model as a dictionary, 'model_name' and 'model_header' keys must be provided."
+            )
+
+        if not isinstance(model_dict["model_header"], dict):
+            raise ValueError(
+                "When passing a custom model as a dictionary, 'model_header' must be a dictionary containing valid header strings."
+            )
+
+        custom_model = cls.UNSPECIFIED
+        custom_model.model_name = model_dict["model_name"]
+        custom_model.model_header = model_dict["model_header"]
+        return custom_model
+
 
 class ErrorCode(IntEnum):
     """

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/src/gemini_webapi/utils/__init__.py

@@ -3,11 +3,12 @@
 from asyncio import Task
 
 from .decorators import running
-from .upload_file import upload_file, parse_file_name
-from .rotate_1psidts import rotate_1psidts
 from .get_access_token import get_access_token
 from .load_browser_cookies import load_browser_cookies
 from .logger import logger, set_log_level
+from .parsing import extract_json_from_response, get_nested_value
+from .rotate_1psidts import rotate_1psidts
+from .upload_file import upload_file, parse_file_name
 
 
 rotate_tasks: dict[str, Task] = {}

gemini_webapi-1.17.1/src/gemini_webapi/utils/parsing.py

@@ -0,0 +1,79 @@
+from typing import Any
+
+import orjson as json
+
+from .logger import logger
+
+
+def get_nested_value(data: list, path: list[int], default: Any = None) -> Any:
+    """
+    Safely get a value from a nested list by a sequence of indices.
+
+    Parameters
+    ----------
+    data: `list`
+        The nested list to traverse.
+    path: `list[int]`
+        A list of indices representing the path to the desired value.
+    default: `Any`, optional
+        The default value to return if the path is not found.
+    """
+
+    current = data
+
+    for i, key in enumerate(path):
+        try:
+            current = current[key]
+        except (IndexError, TypeError, KeyError) as e:
+            current_repr = repr(current)
+            if len(current_repr) > 200:
+                current_repr = f"{current_repr[:197]}..."
+
+            logger.debug(
+                f"{type(e).__name__}: parsing failed at path {path} (index {i}, key '{key}') "
+                f"while attempting to get value from `{current_repr}`"
+            )
+            return default
+
+    if current is None and default is not None:
+        return default
+
+    return current
+
+
+def extract_json_from_response(text: str) -> list:
+    """
+    Clean and extract the JSON content from a Google API response.
+
+    Parameters
+    ----------
+    text: `str`
+        The raw response text from a Google API.
+
+    Returns
+    -------
+    `list`
+        The extracted JSON array or object (should be an array).
+
+    Raises
+    ------
+    `TypeError`
+        If the input is not a string.
+    `ValueError`
+        If no JSON object is found or the response is empty.
+    """
+
+    if not isinstance(text, str):
+        raise TypeError(
+            f"Input text is expected to be a string, got {type(text).__name__} instead."
+        )
+
+    # Find the first line which is valid JSON
+    for line in text.splitlines():
+        try:
+            return json.loads(line.strip())
+        except json.JSONDecodeError:
+            continue
+
+    # If no JSON is found, raise ValueError
+    raise ValueError("Could not find a valid JSON object or array in the response.")

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/src/gemini_webapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemini-webapi
-Version: 1.16.0
+Version: 1.17.1
 Summary: ✨ An elegant async Python wrapper for Google Gemini web app
 Author: UZQueen
 License:                     GNU AFFERO GENERAL PUBLIC LICENSE
@@ -783,11 +783,11 @@ pip install -U browser-cookie3
 
 ```yaml
 services:
-  main:
-    environment:
-      GEMINI_COOKIE_PATH: /tmp/gemini_webapi
-    volumes:
-      - ./gemini_cookies:/tmp/gemini_webapi
+    main:
+        environment:
+            GEMINI_COOKIE_PATH: /tmp/gemini_webapi
+        volumes:
+            - ./gemini_cookies:/tmp/gemini_webapi
 ```
 
 > [!NOTE]
@@ -905,16 +905,12 @@ asyncio.run(main())
 
 You can specify which language model to use by passing `model` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. The default value is `unspecified`.
 
-Currently available models (as of June 12, 2025):
+Currently available models (as of November 20, 2025):
 
 - `unspecified` - Default model
+- `gemini-3.0-pro` - Gemini 3.0 Pro
+- `gemini-2.5-pro` - Gemini 2.5 Pro
 - `gemini-2.5-flash` - Gemini 2.5 Flash
-- `gemini-2.5-pro` - Gemini 2.5 Pro (daily usage limit imposed)
-
-Deprecated models (yet still working):
-
-- `gemini-2.0-flash` - Gemini 2.0 Flash
-- `gemini-2.0-flash-thinking` - Gemini 2.0 Flash Thinking
 
 ```python
 from gemini_webapi.constants import Model
@@ -933,6 +929,23 @@ async def main():
 asyncio.run(main())
 ```
 
+You can also pass custom model header strings directly to access models which are not listed above.
+
+```python
+# "model_name" and "model_header" keys must be present
+custom_model = {
+    "model_name": "xxx",
+    "model_header": {
+        "x-goog-ext-525001261-jspb": "[1,null,null,null,'e6fa609c3fa255c0',null,null,null,[4]]"
+    },
+}
+
+response = await client.generate_content(
+    "What's your model version?",
+    model=custom_model
+)
+```
+
 ### Apply system prompt with Gemini Gems
 
 System prompt can be applied to conversations via [Gemini Gems](https://gemini.google.com/gems/view). To use a gem, you can pass `gem` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. `gem` can be either a string of gem id or a `gemini_webapi.Gem` object. Only one gem can be applied to a single conversation.

{gemini_webapi-1.16.0 → gemini_webapi-1.17.1}/src/gemini_webapi.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ src/gemini_webapi/utils/decorators.py
 src/gemini_webapi/utils/get_access_token.py
 src/gemini_webapi/utils/load_browser_cookies.py
 src/gemini_webapi/utils/logger.py
+src/gemini_webapi/utils/parsing.py
 src/gemini_webapi/utils/rotate_1psidts.py
 src/gemini_webapi/utils/upload_file.py
 tests/test_client_features.py