indoxrouter 0.1.15__tar.gz → 0.1.17__tar.gz

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/PKG-INFO

@@ -1,9 +1,13 @@
 Metadata-Version: 2.4
 Name: indoxrouter
-Version: 0.1.15
+Version: 0.1.17
 Summary: A unified client for various AI providers
 Author-email: indoxRouter Team <ashkan.eskandari.dev@gmail.com>
+License: MIT
 Project-URL: Homepage, https://github.com/indoxrouter/indoxrouter
+Project-URL: Repository, https://github.com/indoxrouter/indoxrouter
+Project-URL: Issues, https://github.com/indoxrouter/indoxrouter/issues
+Keywords: ai,api,client,openai,anthropic,google,mistral,xai,imagen,grok,image-generation
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -129,13 +133,43 @@ print(f"First embedding: {response['data'][0]['embedding'][:5]}...")
 ### Image Generation
 
 ```python
+# OpenAI Image Generation
 response = client.images(
     prompt="A serene landscape with mountains and a lake",
     model="openai/dall-e-3",
-    size="1024x1024"
+    size="1024x1024",
+    quality="standard",  # Options: standard, hd
+    style="vivid"  # Options: vivid, natural
 )
 
 print(f"Image URL: {response['data'][0]['url']}")
+
+# Google Imagen Image Generation
+from indoxrouter.constants import GOOGLE_IMAGE_MODEL
+
+response = client.images(
+    prompt="A robot holding a red skateboard in a futuristic city",
+    model=GOOGLE_IMAGE_MODEL,
+    n=2,  # Generate 2 images
+    negative_prompt="broken, damaged, low quality",
+    guidance_scale=7.5,  # Control adherence to prompt
+    seed=42,  # For reproducible results
+)
+
+# xAI Grok Image Generation
+from indoxrouter.constants import XAI_IMAGE_MODEL
+
+response = client.images(
+    prompt="A cat in a tree",
+    model=XAI_IMAGE_MODEL,
+    n=1,
+    response_format="b64_json"  # Get base64 encoded image
+)
+
+# Access base64 encoded image data
+if "b64_json" in response["data"][0]:
+    b64_data = response["data"][0]["b64_json"]
+    # Use the base64 data (e.g., to display in HTML or save to file)
 ```
 
 ### Streaming Responses

indoxrouter-0.1.15/indoxrouter.egg-info/PKG-INFO → indoxrouter-0.1.17/README.md

@@ -1,22 +1,3 @@
-Metadata-Version: 2.4
-Name: indoxrouter
-Version: 0.1.15
-Summary: A unified client for various AI providers
-Author-email: indoxRouter Team <ashkan.eskandari.dev@gmail.com>
-Project-URL: Homepage, https://github.com/indoxrouter/indoxrouter
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.25.0
-Requires-Dist: python-dotenv>=1.0.0
-
 # IndoxRouter Client
 
 A unified client for various AI providers, including OpenAI, anthropic, Google, and Mistral.
@@ -129,13 +110,43 @@ print(f"First embedding: {response['data'][0]['embedding'][:5]}...")
 ### Image Generation
 
 ```python
+# OpenAI Image Generation
 response = client.images(
     prompt="A serene landscape with mountains and a lake",
     model="openai/dall-e-3",
-    size="1024x1024"
+    size="1024x1024",
+    quality="standard",  # Options: standard, hd
+    style="vivid"  # Options: vivid, natural
 )
 
 print(f"Image URL: {response['data'][0]['url']}")
+
+# Google Imagen Image Generation
+from indoxrouter.constants import GOOGLE_IMAGE_MODEL
+
+response = client.images(
+    prompt="A robot holding a red skateboard in a futuristic city",
+    model=GOOGLE_IMAGE_MODEL,
+    n=2,  # Generate 2 images
+    negative_prompt="broken, damaged, low quality",
+    guidance_scale=7.5,  # Control adherence to prompt
+    seed=42,  # For reproducible results
+)
+
+# xAI Grok Image Generation
+from indoxrouter.constants import XAI_IMAGE_MODEL
+
+response = client.images(
+    prompt="A cat in a tree",
+    model=XAI_IMAGE_MODEL,
+    n=1,
+    response_format="b64_json"  # Get base64 encoded image
+)
+
+# Access base64 encoded image data
+if "b64_json" in response["data"][0]:
+    b64_data = response["data"][0]["b64_json"]
+    # Use the base64 data (e.g., to display in HTML or save to file)
 ```
 
 ### Streaming Responses

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/cookbook/indoxRouter_cookbook.ipynb

@@ -14,52 +14,6 @@
         "\n"
       ]
     },
-    {
-      "cell_type": "code",
-      "execution_count": 2,
-      "id": "479b6ce6",
-      "metadata": {},
-      "outputs": [
-        {
-          "name": "stdout",
-          "output_type": "stream",
-          "text": [
-            "Collecting passlib\n",
-            "  Using cached passlib-1.7.4-py2.py3-none-any.whl.metadata (1.7 kB)\n",
-            "Using cached passlib-1.7.4-py2.py3-none-any.whl (525 kB)\n",
-            "Installing collected packages: passlib\n",
-            "Successfully installed passlib-1.7.4\n",
-            "Note: you may need to restart the kernel to use updated packages.\n"
-          ]
-        },
-        {
-          "name": "stderr",
-          "output_type": "stream",
-          "text": [
-            "\n",
-            "[notice] A new release of pip is available: 24.3.1 -> 25.0.1\n",
-            "[notice] To update, run: python.exe -m pip install --upgrade pip\n"
-          ]
-        }
-      ],
-      "source": [
-        "pip install passlib"
-      ]
-    },
-    {
-      "cell_type": "code",
-      "execution_count": 1,
-      "id": "e03bc1cc",
-      "metadata": {},
-      "outputs": [],
-      "source": [
-        "import sys\n",
-        "import os\n",
-        "module_path = os.path.abspath('E:/Codes/indoxRouter/')\n",
-        "if module_path not in sys.path:\n",
-        "    sys.path.append(module_path)"
-      ]
-    },
     {
       "cell_type": "code",
       "execution_count": null,
@@ -252,14 +206,15 @@
       "metadata": {},
       "outputs": [],
       "source": [
+        "from indoxrouter import Client\n",
+        "client = Client(api_key=\"your-api-key\")\n",
+        "\n",
         "response = client.chat(\n",
         "    messages=[\n",
         "        {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\n",
-        "        {\"role\": \"user\", \"content\": \"Write a short poem about AI.\"}\n",
+        "        {\"role\": \"user\", \"content\": \"What is the capital of France?\"}\n",
         "    ],\n",
-        "    model=\"deepseek/deepseek-chat\",\n",
-        "    temperature=0.8,\n",
-        "    max_tokens=500\n",
+        "    model=\"openai/gpt-4o-mini\"  \n",
         ")\n",
         "\n",
         "print(\"Response:\", response[\"data\"])\n",
@@ -1358,6 +1313,207 @@
         "\n",
         "For more information, refer to the [IndoxRouter documentation](https://docs.indoxrouter.com).\n"
       ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 1,
+      "id": "60ca0fd8",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "Requirement already satisfied: openai in e:\\anaconda\\lib\\site-packages (1.52.2)\n",
+            "Requirement already satisfied: anyio<5,>=3.5.0 in e:\\anaconda\\lib\\site-packages (from openai) (4.2.0)\n",
+            "Requirement already satisfied: distro<2,>=1.7.0 in e:\\anaconda\\lib\\site-packages (from openai) (1.9.0)\n",
+            "Requirement already satisfied: httpx<1,>=0.23.0 in e:\\anaconda\\lib\\site-packages (from openai) (0.27.0)\n",
+            "Requirement already satisfied: jiter<1,>=0.4.0 in e:\\anaconda\\lib\\site-packages (from openai) (0.6.1)\n",
+            "Requirement already satisfied: pydantic<3,>=1.9.0 in c:\\users\\ashkan\\appdata\\roaming\\python\\python312\\site-packages (from openai) (2.9.2)\n",
+            "Requirement already satisfied: sniffio in e:\\anaconda\\lib\\site-packages (from openai) (1.3.0)\n",
+            "Requirement already satisfied: tqdm>4 in e:\\anaconda\\lib\\site-packages (from openai) (4.66.4)\n",
+            "Requirement already satisfied: typing-extensions<5,>=4.11 in e:\\anaconda\\lib\\site-packages (from openai) (4.11.0)\n",
+            "Requirement already satisfied: idna>=2.8 in e:\\anaconda\\lib\\site-packages (from anyio<5,>=3.5.0->openai) (3.7)\n",
+            "Requirement already satisfied: certifi in e:\\anaconda\\lib\\site-packages (from httpx<1,>=0.23.0->openai) (2024.6.2)\n",
+            "Requirement already satisfied: httpcore==1.* in e:\\anaconda\\lib\\site-packages (from httpx<1,>=0.23.0->openai) (1.0.5)\n",
+            "Requirement already satisfied: h11<0.15,>=0.13 in e:\\anaconda\\lib\\site-packages (from httpcore==1.*->httpx<1,>=0.23.0->openai) (0.14.0)\n",
+            "Requirement already satisfied: annotated-types>=0.6.0 in e:\\anaconda\\lib\\site-packages (from pydantic<3,>=1.9.0->openai) (0.6.0)\n",
+            "Requirement already satisfied: pydantic-core==2.23.4 in e:\\anaconda\\lib\\site-packages (from pydantic<3,>=1.9.0->openai) (2.23.4)\n",
+            "Requirement already satisfied: colorama in e:\\anaconda\\lib\\site-packages (from tqdm>4->openai) (0.4.6)\n"
+          ]
+        },
+        {
+          "name": "stderr",
+          "output_type": "stream",
+          "text": [
+            "\n",
+            "[notice] A new release of pip is available: 24.3.1 -> 25.1.1\n",
+            "[notice] To update, run: python.exe -m pip install --upgrade pip\n"
+          ]
+        }
+      ],
+      "source": [
+        "!pip install openai"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 2,
+      "id": "4da1a40d",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from openai import OpenAI\n",
+        "client = OpenAI(\n",
+        "  base_url=\"https://api.indoxrouter.com\",\n",
+        "  api_key=\"indox-vgfI5PEfUoZ6qufR2z6QqXFV4BHgxrez\",\n",
+        ")\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 5,
+      "id": "648eff2d",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from openai import OpenAI\n",
+        "client = OpenAI(\n",
+        "  base_url=\"https://api.indoxrouter.com\",\n",
+        "  api_key=\"indox-vgfI5PEfUoZ6qufR2z6QqXFV4BHgxrez\",\n",
+        ")\n",
+        "\n",
+        "completion = client.chat.completions.create(\n",
+        "  model=\"deepseek/deepseek-chat\",\n",
+        "  messages=[\n",
+        "    {\n",
+        "      \"role\": \"user\",\n",
+        "      \"content\": \"What is the meaning of life?\"\n",
+        "    }\n",
+        "  ]\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 6,
+      "id": "becbf4fa",
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "ChatCompletion(id=None, choices=None, created=None, model='deepseek-chat', object=None, service_tier=None, system_fingerprint=None, usage=CompletionUsage(completion_tokens=None, prompt_tokens=None, total_tokens=None, completion_tokens_details=None, prompt_tokens_details=None, tokens_prompt=10, tokens_completion=348, tokens_total=358, cost=0.000706, latency=19.672869205474854, timestamp='2025-05-19T06:05:02.416455'), request_id='5ce677cf-0e30-49e3-a9d9-bf99f91edbb6', created_at='2025-05-19T06:05:02.434101', duration_ms=21821.611166000366, provider='deepseek', success=True, message='', raw_response=None, data='The meaning of life is one of the most profound and debated questions in philosophy, religion, and science. Different perspectives offer various answers:\\n\\n1. **Philosophical Perspectives:**  \\n   - **Existentialism (e.g., Sartre, Camus):** Life has no inherent meaning—we must create our own purpose through choices and actions.  \\n   - **Absurdism (Camus):** The search for meaning in a meaningless universe is absurd, but we must embrace life anyway.  \\n   - **Stoicism:** Meaning comes from virtue, wisdom, and living in harmony with nature.  \\n\\n2. **Religious/Spiritual Views:**  \\n   - **Theistic (Christianity, Islam, etc.):** Life’s purpose is to serve, love, or unite with God (or the divine).  \\n   - **Eastern Traditions (Buddhism, Hinduism):** Meaning may involve enlightenment (breaking the cycle of suffering) or fulfilling dharma (duty).  \\n\\n3. **Scientific Perspectives:**  \\n   - **Biological:** Life’s \"purpose\" is survival, reproduction, and passing on genes (evolutionary biology).  \\n   - **Cosmic:** From a physics standpoint, life may be a rare, fleeting phenomenon in an indifferent universe.  \\n\\n4. **Personal/Subjective Meaning:**  \\n   Many find purpose in relationships, creativity, helping others, or personal growth. Viktor Frankl (Holocaust survivor) argued that meaning arises from suffering, love, and work.  \\n\\n**Short answer?** There’s no universal meaning—it’s up to you to define it. What gives *your* life purpose?  \\n\\nWould you like to explore a specific perspective?', finish_reason=None)"
+            ]
+          },
+          "execution_count": 6,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "completion"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 7,
+      "id": "410449d5",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "ChatCompletion(id=None, choices=None, created=None, model='deepseek-chat', object=None, service_tier=None, system_fingerprint=None, usage=CompletionUsage(completion_tokens=None, prompt_tokens=None, total_tokens=None, completion_tokens_details=None, prompt_tokens_details=None, tokens_prompt=10, tokens_completion=348, tokens_total=358, cost=0.000706, latency=19.672869205474854, timestamp='2025-05-19T06:05:02.416455'), request_id='5ce677cf-0e30-49e3-a9d9-bf99f91edbb6', created_at='2025-05-19T06:05:02.434101', duration_ms=21821.611166000366, provider='deepseek', success=True, message='', raw_response=None, data='The meaning of life is one of the most profound and debated questions in philosophy, religion, and science. Different perspectives offer various answers:\\n\\n1. **Philosophical Perspectives:**  \\n   - **Existentialism (e.g., Sartre, Camus):** Life has no inherent meaning—we must create our own purpose through choices and actions.  \\n   - **Absurdism (Camus):** The search for meaning in a meaningless universe is absurd, but we must embrace life anyway.  \\n   - **Stoicism:** Meaning comes from virtue, wisdom, and living in harmony with nature.  \\n\\n2. **Religious/Spiritual Views:**  \\n   - **Theistic (Christianity, Islam, etc.):** Life’s purpose is to serve, love, or unite with God (or the divine).  \\n   - **Eastern Traditions (Buddhism, Hinduism):** Meaning may involve enlightenment (breaking the cycle of suffering) or fulfilling dharma (duty).  \\n\\n3. **Scientific Perspectives:**  \\n   - **Biological:** Life’s \"purpose\" is survival, reproduction, and passing on genes (evolutionary biology).  \\n   - **Cosmic:** From a physics standpoint, life may be a rare, fleeting phenomenon in an indifferent universe.  \\n\\n4. **Personal/Subjective Meaning:**  \\n   Many find purpose in relationships, creativity, helping others, or personal growth. Viktor Frankl (Holocaust survivor) argued that meaning arises from suffering, love, and work.  \\n\\n**Short answer?** There’s no universal meaning—it’s up to you to define it. What gives *your* life purpose?  \\n\\nWould you like to explore a specific perspective?', finish_reason=None)\n"
+          ]
+        }
+      ],
+      "source": [
+        "from pprint import pprint\n",
+        "pprint(completion)"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 8,
+      "id": "ff185a0a",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "Note: you may need to restart the kernel to use updated packages.Collecting indoxrouter\n",
+            "  Using cached indoxrouter-0.1.15-py3-none-any.whl.metadata (5.4 kB)\n",
+            "Requirement already satisfied: requests>=2.25.0 in e:\\anaconda\\lib\\site-packages (from indoxrouter) (2.32.3)\n",
+            "Requirement already satisfied: python-dotenv>=1.0.0 in e:\\anaconda\\lib\\site-packages (from indoxrouter) (1.0.1)\n",
+            "Requirement already satisfied: charset-normalizer<4,>=2 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (3.3.2)\n",
+            "Requirement already satisfied: idna<4,>=2.5 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (3.7)\n",
+            "Requirement already satisfied: urllib3<3,>=1.21.1 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (2.2.2)\n",
+            "Requirement already satisfied: certifi>=2017.4.17 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (2024.6.2)\n",
+            "Using cached indoxrouter-0.1.15-py3-none-any.whl (11 kB)\n",
+            "Installing collected packages: indoxrouter\n",
+            "Successfully installed indoxrouter-0.1.15\n",
+            "\n"
+          ]
+        },
+        {
+          "name": "stderr",
+          "output_type": "stream",
+          "text": [
+            "\n",
+            "[notice] A new release of pip is available: 24.3.1 -> 25.1.1\n",
+            "[notice] To update, run: python.exe -m pip install --upgrade pip\n"
+          ]
+        }
+      ],
+      "source": [
+        "pip install indoxrouter"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 9,
+      "id": "b584d7c4",
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "{'request_id': 'c08cc108-6b0d-48bd-a660-546143f1b9fa',\n",
+              " 'created_at': '2025-05-19T06:07:38.077269',\n",
+              " 'duration_ms': 9664.651870727539,\n",
+              " 'provider': 'deepseek',\n",
+              " 'model': 'deepseek-chat',\n",
+              " 'success': True,\n",
+              " 'message': '',\n",
+              " 'usage': {'tokens_prompt': 15,\n",
+              "  'tokens_completion': 107,\n",
+              "  'tokens_total': 122,\n",
+              "  'cost': 0.000229,\n",
+              "  'latency': 9.487398862838745,\n",
+              "  'timestamp': '2025-05-19T06:07:38.065330'},\n",
+              " 'raw_response': None,\n",
+              " 'data': 'In a bustling city, a small cleaning robot named Pip discovered a lost kitten in an alley. Despite its simple programming, Pip felt a strange urge to protect the tiny creature. It carried the kitten through busy streets, dodging humans and traffic, until it found a kind woman who gasped in delight. The woman took the kitten home, and Pip watched from the sidewalk, its circuits humming with something like happiness. That night, as it returned to its charging station, Pip replayed the memory—its first act of kindness beyond code.',\n",
+              " 'finish_reason': None}"
+            ]
+          },
+          "execution_count": 9,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "from indoxrouter import Client\n",
+        "client= Client(api_key=\"indox-vgfI5PEfUoZ6qufR2z6QqXFV4BHgxrez\")\n",
+        "client.chat(\n",
+        "    messages=[\n",
+        "        {\"role\": \"user\", \"content\": \"Tell me a story about a robot in 5 sentences.\"}\n",
+        "    ],\n",
+        "    model=\"deepseek/deepseek-chat\",\n",
+        ")"
+      ]
     }
   ],
   "metadata": {

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/indoxrouter/__init__.py

@@ -30,7 +30,7 @@ For custom server URLs:
     ```
 """
 
-from .client import Client
+from .client import Client, IndoxRouter
 from .exceptions import (
     IndoxRouterError,
     AuthenticationError,
@@ -39,13 +39,18 @@ from .exceptions import (
     ProviderError,
     ModelNotFoundError,
     ProviderNotFoundError,
+    ModelNotAvailableError,
     InvalidParametersError,
+    RequestError,
     InsufficientCreditsError,
+    ValidationError,
+    APIError,
 )
 
 __version__ = "0.2.1"
 __all__ = [
     "Client",
+    "IndoxRouter",
     "IndoxRouterError",
     "AuthenticationError",
     "NetworkError",
@@ -53,6 +58,10 @@ __all__ = [
     "ProviderError",
     "ModelNotFoundError",
     "ProviderNotFoundError",
+    "ModelNotAvailableError",
     "InvalidParametersError",
+    "RequestError",
     "InsufficientCreditsError",
+    "ValidationError",
+    "APIError",
 ]

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/indoxrouter/client.py

@@ -57,10 +57,14 @@ from .exceptions import (
     NetworkError,
     ProviderNotFoundError,
     ModelNotFoundError,
+    ModelNotAvailableError,
     InvalidParametersError,
     RateLimitError,
     ProviderError,
+    RequestError,
     InsufficientCreditsError,
+    ValidationError,
+    APIError,
 )
 from .constants import (
     DEFAULT_BASE_URL,
@@ -316,29 +320,57 @@ class Client:
                 if "provider" in error_message.lower():
                     raise ProviderNotFoundError(error_message)
                 elif "model" in error_message.lower():
-                    raise ModelNotFoundError(error_message)
+                    # Check if it's a model not found vs model not available
+                    if (
+                        "not supported" in error_message.lower()
+                        or "disabled" in error_message.lower()
+                        or "unavailable" in error_message.lower()
+                    ):
+                        raise ModelNotAvailableError(error_message)
+                    else:
+                        raise ModelNotFoundError(error_message)
                 else:
-                    raise NetworkError(
-                        f"Resource not found: {error_message} (URL: {url})"
-                    )
+                    raise APIError(f"Resource not found: {error_message} (URL: {url})")
             elif status_code == 429:
                 raise RateLimitError(f"Rate limit exceeded: {error_message}")
             elif status_code == 400:
-                raise InvalidParametersError(f"Invalid parameters: {error_message}")
+                # Check if it's a validation error or invalid parameters
+                if (
+                    "validation" in error_message.lower()
+                    or "invalid format" in error_message.lower()
+                ):
+                    raise ValidationError(f"Request validation failed: {error_message}")
+                else:
+                    raise InvalidParametersError(f"Invalid parameters: {error_message}")
             elif status_code == 402:
                 raise InsufficientCreditsError(f"Insufficient credits: {error_message}")
+            elif status_code == 422:
+                # Unprocessable Entity - typically validation errors
+                raise ValidationError(f"Request validation failed: {error_message}")
+            elif status_code == 503:
+                # Service Unavailable - model might be temporarily unavailable
+                if "model" in error_message.lower():
+                    raise ModelNotAvailableError(
+                        f"Model temporarily unavailable: {error_message}"
+                    )
+                else:
+                    raise APIError(f"Service unavailable: {error_message}")
             elif status_code == 500:
                 # Provide more detailed information for server errors
                 error_detail = error_data.get("detail", "No details provided")
                 # Include the request data in the error message for better debugging
                 request_data_str = json.dumps(data, indent=2) if data else "None"
-                raise ProviderError(
+                raise RequestError(
                     f"Server error (500): {error_detail}. URL: {url}.\n"
                     f"Request data: {request_data_str}\n"
                     f"This may indicate an issue with the server configuration or a problem with the provider service."
                 )
+            elif status_code >= 400 and status_code < 500:
+                # Client errors
+                raise APIError(f"Client error ({status_code}): {error_message}")
             else:
-                raise ProviderError(f"Provider error ({status_code}): {error_message}")
+                # Server errors
+                raise RequestError(f"Server error ({status_code}): {error_message}")
         except requests.RequestException as e:
             logger.error(f"Request exception: {str(e)}")
             raise NetworkError(f"Network error: {str(e)}")
@@ -503,6 +535,26 @@ class Client:
         n: int = 1,
         quality: str = "standard",
         style: str = "vivid",
+        # Standard parameters
+        response_format: Optional[str] = None,
+        user: Optional[str] = None,
+        # OpenAI-specific parameters
+        background: Optional[str] = None,
+        moderation: Optional[str] = None,
+        output_compression: Optional[int] = None,
+        output_format: Optional[str] = None,
+        # Google-specific parameters
+        negative_prompt: Optional[str] = None,
+        guidance_scale: Optional[float] = None,
+        seed: Optional[int] = None,
+        safety_filter_level: Optional[str] = None,
+        person_generation: Optional[str] = None,
+        include_safety_attributes: Optional[bool] = None,
+        include_rai_reason: Optional[bool] = None,
+        language: Optional[str] = None,
+        output_mime_type: Optional[str] = None,
+        add_watermark: Optional[bool] = None,
+        enhance_prompt: Optional[bool] = None,
         **kwargs,
     ) -> Dict[str, Any]:
         """
@@ -510,11 +562,35 @@ class Client:
 
         Args:
             prompt: Text prompt
-            model: Model to use in the format "provider/model" (e.g., "openai/dall-e-3")
+            model: Model to use in the format "provider/model" (e.g., "openai/dall-e-3", "google/imagen-3.0-generate-002")
             size: Image size (e.g., "1024x1024")
             n: Number of images to generate
             quality: Image quality (e.g., "standard", "hd")
             style: Image style (e.g., "vivid", "natural")
+
+            # Standard parameters
+            response_format: Format of the response - "url" or "b64_json"
+            user: A unique identifier for the end-user
+
+            # OpenAI-specific parameters
+            background: Background style - "transparent", "opaque", or "auto"
+            moderation: Moderation level - "low" or "auto"
+            output_compression: Compression quality for output images (0-100)
+            output_format: Output format - "png", "jpeg", or "webp"
+
+            # Google-specific parameters
+            negative_prompt: Description of what to discourage in the generated images
+            guidance_scale: Controls how much the model adheres to the prompt
+            seed: Random seed for image generation
+            safety_filter_level: Filter level for safety filtering
+            person_generation: Controls generation of people ("dont_allow", "allow_adult", "allow_all")
+            include_safety_attributes: Whether to report safety scores of generated images
+            include_rai_reason: Whether to include filter reason if the image is filtered
+            language: Language of the text in the prompt
+            output_mime_type: MIME type of the generated image
+            add_watermark: Whether to add a watermark to the generated images
+            enhance_prompt: Whether to use prompt rewriting logic
+
             **kwargs: Additional parameters to pass to the API
 
         Returns:
@@ -529,6 +605,7 @@ class Client:
             if key not in ["return_generator"]:  # List of parameters to exclude
                 filtered_kwargs[key] = value
 
+        # Create the base request data
         data = {
             "prompt": prompt,
             "model": formatted_model,
@@ -536,9 +613,52 @@ class Client:
             "size": size,
             "quality": quality,
             "style": style,
-            "additional_params": filtered_kwargs,
         }
 
+        # Add standard parameters if provided
+        if response_format is not None:
+            data["response_format"] = response_format
+        if user is not None:
+            data["user"] = user
+
+        # Add OpenAI-specific parameters if provided
+        if background is not None:
+            data["background"] = background
+        if moderation is not None:
+            data["moderation"] = moderation
+        if output_compression is not None:
+            data["output_compression"] = output_compression
+        if output_format is not None:
+            data["output_format"] = output_format
+
+        # Add Google-specific parameters if provided
+        if negative_prompt is not None:
+            data["negative_prompt"] = negative_prompt
+        if guidance_scale is not None:
+            data["guidance_scale"] = guidance_scale
+        if seed is not None:
+            data["seed"] = seed
+        if safety_filter_level is not None:
+            data["safety_filter_level"] = safety_filter_level
+        if person_generation is not None:
+            data["person_generation"] = person_generation
+        if include_safety_attributes is not None:
+            data["include_safety_attributes"] = include_safety_attributes
+        if include_rai_reason is not None:
+            data["include_rai_reason"] = include_rai_reason
+        if language is not None:
+            data["language"] = language
+        if output_mime_type is not None:
+            data["output_mime_type"] = output_mime_type
+        if add_watermark is not None:
+            data["add_watermark"] = add_watermark
+        if enhance_prompt is not None:
+            data["enhance_prompt"] = enhance_prompt
+
+        # Add any remaining parameters
+        if filtered_kwargs:
+            data["additional_params"] = filtered_kwargs
+
         return self._request("POST", IMAGE_ENDPOINT, data)
 
     def models(self, provider: Optional[str] = None) -> Dict[str, Any]:

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/indoxrouter/constants.py

@@ -13,6 +13,10 @@ USE_COOKIES = True  # Always use cookie-based authentication
 DEFAULT_MODEL = "openai/gpt-4o-mini"
 DEFAULT_EMBEDDING_MODEL = "openai/text-embedding-3-small"
 DEFAULT_IMAGE_MODEL = "openai/dall-e-3"
+GOOGLE_IMAGE_MODEL = "google/imagen-3.0-generate-002"
+XAI_IMAGE_MODEL = "xai/grok-2-image"
+XAI_IMAGE_LATEST_MODEL = "xai/grok-2-image-latest"
+XAI_IMAGE_SPECIFIC_MODEL = "xai/grok-2-image-1212"
 
 # API endpoints
 CHAT_ENDPOINT = "chat/completions"

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/indoxrouter/exceptions.py

@@ -38,14 +38,20 @@ class ProviderError(IndoxRouterError):
     pass
 
 
+class ProviderNotFoundError(ProviderError):
+    """Raised when a requested provider is not found."""
+
+    pass
+
+
 class ModelNotFoundError(ProviderError):
     """Raised when a requested model is not found."""
 
     pass
 
 
-class ProviderNotFoundError(ProviderError):
-    """Raised when a requested provider is not found."""
+class ModelNotAvailableError(ProviderError):
+    """Raised when a model is disabled or not supported by the provider."""
 
     pass
 
@@ -56,7 +62,25 @@ class InvalidParametersError(IndoxRouterError):
     pass
 
 
+class RequestError(IndoxRouterError):
+    """Raised when a request to a provider fails."""
+
+    pass
+
+
 class InsufficientCreditsError(IndoxRouterError):
     """Raised when the user doesn't have enough credits."""
 
     pass
+
+
+class ValidationError(IndoxRouterError):
+    """Raised when request validation fails."""
+
+    pass
+
+
+class APIError(IndoxRouterError):
+    """Raised when the API returns an error."""
+
+    pass

indoxrouter-0.1.15/README.md → indoxrouter-0.1.17/indoxrouter.egg-info/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.4
+Name: indoxrouter
+Version: 0.1.17
+Summary: A unified client for various AI providers
+Author-email: indoxRouter Team <ashkan.eskandari.dev@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/indoxrouter/indoxrouter
+Project-URL: Repository, https://github.com/indoxrouter/indoxrouter
+Project-URL: Issues, https://github.com/indoxrouter/indoxrouter/issues
+Keywords: ai,api,client,openai,anthropic,google,mistral,xai,imagen,grok,image-generation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=1.0.0
+
 # IndoxRouter Client
 
 A unified client for various AI providers, including OpenAI, anthropic, Google, and Mistral.
@@ -110,13 +133,43 @@ print(f"First embedding: {response['data'][0]['embedding'][:5]}...")
 ### Image Generation
 
 ```python
+# OpenAI Image Generation
 response = client.images(
     prompt="A serene landscape with mountains and a lake",
     model="openai/dall-e-3",
-    size="1024x1024"
+    size="1024x1024",
+    quality="standard",  # Options: standard, hd
+    style="vivid"  # Options: vivid, natural
 )
 
 print(f"Image URL: {response['data'][0]['url']}")
+
+# Google Imagen Image Generation
+from indoxrouter.constants import GOOGLE_IMAGE_MODEL
+
+response = client.images(
+    prompt="A robot holding a red skateboard in a futuristic city",
+    model=GOOGLE_IMAGE_MODEL,
+    n=2,  # Generate 2 images
+    negative_prompt="broken, damaged, low quality",
+    guidance_scale=7.5,  # Control adherence to prompt
+    seed=42,  # For reproducible results
+)
+
+# xAI Grok Image Generation
+from indoxrouter.constants import XAI_IMAGE_MODEL
+
+response = client.images(
+    prompt="A cat in a tree",
+    model=XAI_IMAGE_MODEL,
+    n=1,
+    response_format="b64_json"  # Get base64 encoded image
+)
+
+# Access base64 encoded image data
+if "b64_json" in response["data"][0]:
+    b64_data = response["data"][0]["b64_json"]
+    # Use the base64 data (e.g., to display in HTML or save to file)
 ```
 
 ### Streaming Responses

{indoxrouter-0.1.15 → indoxrouter-0.1.17}/pyproject.toml

@@ -1,16 +1,18 @@
 [build-system]
-requires = ["setuptools>=42", "wheel"]
+requires = ["setuptools>=61.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "indoxrouter"
-version = "0.1.15"
+version = "0.1.17"
 authors = [
     {name = "indoxRouter Team", email = "ashkan.eskandari.dev@gmail.com"},
 ]
 description = "A unified client for various AI providers"
 readme = "README.md"
 requires-python = ">=3.8"
+license = {text = "MIT"}
+keywords = ["ai", "api", "client", "openai", "anthropic", "google", "mistral", "xai", "imagen", "grok", "image-generation"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -28,7 +30,11 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://github.com/indoxrouter/indoxrouter"
+Repository = "https://github.com/indoxrouter/indoxrouter"
+Issues = "https://github.com/indoxrouter/indoxrouter/issues"
 
-[tool.setuptools]
-packages = ["indoxrouter"]
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["indoxrouter*"]
+exclude = ["tests*"]