diff --git a/README.md b/README.md
index 19587f3..4979334 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,7 @@ The plugin can be configured during setup. Here's an example with all available
 require("gemini").setup({
     -- Model configuration
     model = "gemini-2.0-flash", -- The Gemini model to use
+    api_url = "https://generativelanguage.googleapis.com/v1/models/%s:generateContent", -- API endpoint URL
 
     -- Window appearance
     window = {
@@ -78,6 +79,28 @@ require("gemini").setup({
 })
 ```
 
+### Configuration Options
+
+#### Model Configuration
+- `model`: The Gemini model to use (default: "gemini-2.0-flash")
+- `api_url`: The Google AI API endpoint URL format (default: "https://generativelanguage.googleapis.com/v1/models/%s:generateContent")
+
+#### Window Appearance
+- `window.width`: Width of the chat window (number or function)
+- `window.height`: Height of the chat window (number or function)
+- `window.border`: Border style ("none", "single", "double", "rounded")
+- `window.title`: Title of the chat window
+- `window.title_pos`: Position of the title ("left", "center", "right")
+
+#### Chat Window Keymaps
+- `mappings.close`: Key to close the chat window (default: 'q')
+- `mappings.return_focus`: Key to return to previous window (default: '<Esc>')
+- `mappings.new_query`: Key to start a new query (default: 'i')
+
+#### Highlight Groups
+- `highlights.user`: Highlight group for user messages (default: "GeminiUser")
+- `highlights.separator`: Highlight group for message separators (default: "GeminiSeparator")
+
 ### Customizing Highlights
 
 The plugin defines two highlight groups that you can customize:
@@ -88,9 +111,9 @@ vim.api.nvim_set_hl(0, "GeminiUser", { fg = "#EBCB8B", bold = true })
 vim.api.nvim_set_hl(0, "GeminiSeparator", { fg = "#616E88", bold = true })
 ```
 
-### Default Keymaps
+### Default Global Keymaps
 
-The plugin sets up the following default keymaps:
+The plugin sets up the following default keymaps in normal mode:
 
 - `<leader>gc`: Open chat window for a new query
 - `<leader>gs`: Open chat window with current buffer as context
@@ -109,35 +132,58 @@ vim.keymap.set("n", "<leader>M", function()
 end, { desc = "Chat with Gemini AI (with buffer context)" })
 ```
 
-### Configuration Tips
+### Configuration Examples
 
-1. **Window Size**: The window size functions can be customized to your needs:
+1. **Custom Window Size (Percentage Based)**:
 ```lua
-window = {
-    width = function()
-        -- Use 40% of screen width
-        return math.floor(vim.o.columns * 0.4)
-    end,
-    height = function()
-        -- Use 80% of screen height
-        return math.floor(vim.o.lines * 0.8)
-    end
-}
+require("gemini").setup({
+    window = {
+        width = function()
+            -- Use 40% of screen width
+            return math.floor(vim.o.columns * 0.4)
+        end,
+        height = function()
+            -- Use 80% of screen height
+            return math.floor(vim.o.lines * 0.8)
+        end
+    }
+})
 ```
 
-2. **Fixed Dimensions**: You can use fixed numbers instead of functions:
+2. **Fixed Window Dimensions**:
 ```lua
-window = {
-    width = 80,   -- Fixed width of 80 columns
-    height = 40,  -- Fixed height of 40 lines
-}
+require("gemini").setup({
+    window = {
+        width = 80,   -- Fixed width of 80 columns
+        height = 40,  -- Fixed height of 40 lines
+    }
+})
 ```
 
-3. **Custom Border Style**: Choose from available border styles:
+3. **Custom Appearance**:
 ```lua
-window = {
-    border = "double",  -- Options: "none", "single", "double", "rounded"
-}
+require("gemini").setup({
+    window = {
+        border = "double",
+        title = "AI Assistant",
+        title_pos = "left"
+    },
+    highlights = {
+        user = "Statement",     -- Use built-in highlight group
+        separator = "Comment"   -- Use built-in highlight group
+    }
+})
+```
+
+4. **Custom Keymaps**:
+```lua
+require("gemini").setup({
+    mappings = {
+        close = '<C-c>',
+        return_focus = '<C-w>',
+        new_query = 'a'
+    }
+})
 ```
 
 ## Usage