From 7bd3dd9270ac8a22906a910075f5b39b16b9b556 Mon Sep 17 00:00:00 2001
From: shuwenn <47200617+alphabetc1@users.noreply.github.com>
Date: Sun, 8 Mar 2026 05:28:20 +0800
Subject: [PATCH] fix: image URL in notebook to use raw.githubusercontent.com
 (#20100)

---
 docs/advanced_features/vlm_query.ipynb        | 19 ++++---------------
 docs/basic_usage/openai_api_vision.ipynb      | 19 ++++++++++---------
 .../frontend/frontend_tutorial.ipynb          |  2 +-
 3 files changed, 15 insertions(+), 25 deletions(-)

diff --git a/docs/advanced_features/vlm_query.ipynb b/docs/advanced_features/vlm_query.ipynb
index 13491d1b9..f5497f5b7 100644
--- a/docs/advanced_features/vlm_query.ipynb
+++ b/docs/advanced_features/vlm_query.ipynb
@@ -65,7 +65,8 @@
     "nest_asyncio.apply()\n",
     "\n",
     "model_path = \"Qwen/Qwen2.5-VL-3B-Instruct\"\n",
-    "chat_template = \"qwen2-vl\""
+    "chat_template = \"qwen2-vl\"\n",
+    "example_image_url = \"https://raw.githubusercontent.com/sgl-project/sglang/main/examples/assets/example_image.png\""
    ]
   },
   {
@@ -81,13 +82,7 @@
     "\n",
     "from sglang.srt.parser.conversation import chat_templates\n",
     "\n",
-    "image = Image.open(\n",
-    "    BytesIO(\n",
-    "        requests.get(\n",
-    "            \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\"\n",
-    "        ).content\n",
-    "    )\n",
-    ")\n",
+    "image = Image.open(BytesIO(requests.get(example_image_url).content))\n",
     "\n",
     "conv = chat_templates[chat_template].copy()\n",
     "conv.append_message(conv.roles[0], f\"What's shown here: {conv.image_token}?\")\n",
@@ -238,13 +233,7 @@
     "from sglang.srt.parser.conversation import chat_templates\n",
     "\n",
     "# Download the same example image\n",
-    "image = Image.open(\n",
-    "    BytesIO(\n",
-    "        requests.get(\n",
-    "            \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\"\n",
-    "        ).content\n",
-    "    )\n",
-    ")\n",
+    "image = Image.open(BytesIO(requests.get(example_image_url).content))\n",
     "\n",
     "conv = chat_templates[chat_template].copy()\n",
     "conv.append_message(conv.roles[0], f\"What's shown here: {conv.image_token}?\")\n",
diff --git a/docs/basic_usage/openai_api_vision.ipynb b/docs/basic_usage/openai_api_vision.ipynb
index 45198bb3c..b6e6a1a24 100644
--- a/docs/basic_usage/openai_api_vision.ipynb
+++ b/docs/basic_usage/openai_api_vision.ipynb
@@ -33,6 +33,11 @@
     "from sglang.test.doc_patch import launch_server_cmd\n",
     "from sglang.utils import wait_for_server, print_highlight, terminate_process\n",
     "\n",
+    "example_image_url = \"https://raw.githubusercontent.com/sgl-project/sglang/main/examples/assets/example_image.png\"\n",
+    "logo_image_url = (\n",
+    "    \"https://raw.githubusercontent.com/sgl-project/sglang/main/assets/logo.png\"\n",
+    ")\n",
+    "\n",
     "vision_process, port = launch_server_cmd(\"\"\"\n",
     "python3 -m sglang.launch_server --model-path Qwen/Qwen2.5-VL-7B-Instruct --log-level warning\n",
     "\"\"\")\n",
@@ -73,7 +78,7 @@
     "          {{\n",
     "            \"type\": \"image_url\",\n",
     "            \"image_url\": {{\n",
-    "              \"url\": \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\"\n",
+    "              \"url\": \"{example_image_url}\"\n",
     "            }}\n",
     "          }}\n",
     "        ]\n",
@@ -117,9 +122,7 @@
     "                {\"type\": \"text\", \"text\": \"What’s in this image?\"},\n",
     "                {\n",
     "                    \"type\": \"image_url\",\n",
-    "                    \"image_url\": {\n",
-    "                        \"url\": \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\"\n",
-    "                    },\n",
+    "                    \"image_url\": {\"url\": example_image_url},\n",
     "                },\n",
     "            ],\n",
     "        }\n",
@@ -160,9 +163,7 @@
     "                },\n",
     "                {\n",
     "                    \"type\": \"image_url\",\n",
-    "                    \"image_url\": {\n",
-    "                        \"url\": \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\"\n",
-    "                    },\n",
+    "                    \"image_url\": {\"url\": example_image_url},\n",
     "                },\n",
     "            ],\n",
     "        }\n",
@@ -201,13 +202,13 @@
     "                {\n",
     "                    \"type\": \"image_url\",\n",
     "                    \"image_url\": {\n",
-    "                        \"url\": \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\",\n",
+    "                        \"url\": example_image_url,\n",
     "                    },\n",
     "                },\n",
     "                {\n",
     "                    \"type\": \"image_url\",\n",
     "                    \"image_url\": {\n",
-    "                        \"url\": \"https://raw.githubusercontent.com/sgl-project/sglang/main/assets/logo.png\",\n",
+    "                        \"url\": logo_image_url,\n",
     "                    },\n",
     "                },\n",
     "                {\n",
diff --git a/docs/references/frontend/frontend_tutorial.ipynb b/docs/references/frontend/frontend_tutorial.ipynb
index fc458fd18..9c4da052c 100644
--- a/docs/references/frontend/frontend_tutorial.ipynb
+++ b/docs/references/frontend/frontend_tutorial.ipynb
@@ -430,7 +430,7 @@
     "    s += assistant(gen(\"answer\", max_tokens=256))\n",
     "\n",
     "\n",
-    "image_url = \"https://github.com/sgl-project/sglang/blob/main/examples/assets/example_image.png?raw=true\"\n",
+    "image_url = \"https://raw.githubusercontent.com/sgl-project/sglang/main/examples/assets/example_image.png\"\n",
     "image_bytes, _ = load_image(image_url)\n",
     "state = image_qa(image_bytes, \"What is in the image?\")\n",
     "print_highlight(state[\"answer\"])"