refactor: rename OPENWEBUI_API_URL to OPENWEBUI_BASE_URL

Author: danielcopper

.env.example

@@ -64,7 +64,7 @@ MODEL_CACHE_TTL=3600
 # This ensures images are accessible from anywhere (internal/external).
 
 # Open WebUI instance URL (e.g., https://chat.mydomain.com)
-OPENWEBUI_API_URL=
+OPENWEBUI_BASE_URL=
 
 # API key from Open WebUI (Settings > Account > API Keys)
 OPENWEBUI_API_KEY=

CONFIGURATION.md

@@ -58,15 +58,15 @@ Complete configuration reference for the Image Generation API.
 
 ### Open WebUI Integration
 
-**`OPENWEBUI_API_URL`**
+**`OPENWEBUI_BASE_URL`**
 - Open WebUI instance URL
 - Example: `https://chat.mydomain.com`
 - When set (with API key), images are uploaded to Open WebUI's file storage
 
 **`OPENWEBUI_API_KEY`**
 - API key from Open WebUI
 - Get from: Open WebUI Settings > Account > API Keys
-- Required together with `OPENWEBUI_API_URL`
+- Required together with `OPENWEBUI_BASE_URL`
 
 When both are configured, images are automatically uploaded to Open WebUI. This ensures images work from anywhere - no more URL accessibility issues with Docker or external access.
 

app/core/config.py

@@ -54,7 +54,7 @@ class Settings(BaseSettings):
     DEFAULT_MODEL: str | None = None  # Default model for image generation
 
     # Open WebUI Integration (optional)
-    OPENWEBUI_API_URL: str | None = None  # e.g. https://chat.mydomain.com
+    OPENWEBUI_BASE_URL: str | None = None  # e.g. https://chat.mydomain.com
     OPENWEBUI_API_KEY: str | None = None  # API key from Open WebUI settings
 
     # Server Configuration
@@ -79,7 +79,7 @@ def gemini_available(self) -> bool:
     @property
     def openwebui_available(self) -> bool:
         """Check if Open WebUI integration is configured."""
-        return bool(self.OPENWEBUI_API_URL and self.OPENWEBUI_API_KEY)
+        return bool(self.OPENWEBUI_BASE_URL and self.OPENWEBUI_API_KEY)
 
 
 settings = Settings()

app/services/openwebui_service.py

@@ -16,12 +16,12 @@ class OpenWebUIService:
     """
 
     def __init__(self):
-        if not settings.OPENWEBUI_API_URL:
-            raise ValueError("OPENWEBUI_API_URL not configured")
+        if not settings.OPENWEBUI_BASE_URL:
+            raise ValueError("OPENWEBUI_BASE_URL not configured")
         if not settings.OPENWEBUI_API_KEY:
             raise ValueError("OPENWEBUI_API_KEY not configured")
 
-        self.base_url = settings.OPENWEBUI_API_URL.rstrip("/")
+        self.base_url = settings.OPENWEBUI_BASE_URL.rstrip("/")
         self.api_key = settings.OPENWEBUI_API_KEY
 
     async def upload_image(self, image_data: bytes, filename: str) -> str:

tests/test_openwebui.py

@@ -8,16 +8,16 @@ def test_openwebui_available_property():
     from app.core.config import Settings
 
     # Not available when URL missing
-    settings = Settings(OPENWEBUI_API_URL=None, OPENWEBUI_API_KEY="key")
+    settings = Settings(OPENWEBUI_BASE_URL=None, OPENWEBUI_API_KEY="key")
     assert settings.openwebui_available is False
 
     # Not available when key missing
-    settings = Settings(OPENWEBUI_API_URL="http://localhost", OPENWEBUI_API_KEY=None)
+    settings = Settings(OPENWEBUI_BASE_URL="http://localhost", OPENWEBUI_API_KEY=None)
     assert settings.openwebui_available is False
 
     # Available when both set
     settings = Settings(
-        OPENWEBUI_API_URL="http://localhost", OPENWEBUI_API_KEY="key"
+        OPENWEBUI_BASE_URL="http://localhost", OPENWEBUI_API_KEY="key"
     )
     assert settings.openwebui_available is True
 
@@ -28,7 +28,7 @@ async def test_openwebui_service_upload():
     from app.services.openwebui_service import OpenWebUIService
 
     with patch("app.services.openwebui_service.settings") as mock_settings:
-        mock_settings.OPENWEBUI_API_URL = "https://chat.example.com"
+        mock_settings.OPENWEBUI_BASE_URL = "https://chat.example.com"
         mock_settings.OPENWEBUI_API_KEY = "test-key"
 
         service = OpenWebUIService()
@@ -65,7 +65,7 @@ async def test_openwebui_service_upload_no_file_id():
     from app.services.openwebui_service import OpenWebUIService
 
     with patch("app.services.openwebui_service.settings") as mock_settings:
-        mock_settings.OPENWEBUI_API_URL = "https://chat.example.com"
+        mock_settings.OPENWEBUI_BASE_URL = "https://chat.example.com"
         mock_settings.OPENWEBUI_API_KEY = "test-key"
 
         service = OpenWebUIService()