orbitalsai 1.0.0__tar.gz → 1.1.0__tar.gz

{orbitalsai-1.0.0/orbitalsai.egg-info → orbitalsai-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orbitalsai
-Version: 1.0.0
+Version: 1.1.0
 Summary: A simple and powerful Python SDK for the OrbitalsAI API
 Home-page: https://github.com/orbitalsai/orbitalsai-python-sdk
 Author: OrbitalsAI
@@ -138,27 +138,61 @@ print(transcript.text)
 print(transcript.srt_content)  # SRT subtitle content
 ```
 
-### Don't Wait (Advanced)
+## 🤖 AI Model Selection
+
+Choose which AI model to use for transcription. Different models may have different pricing and capabilities.
+
+### List Available Models
 
 ```python
 import orbitalsai
 
 client = orbitalsai.Client(api_key="your_api_key_here")
 
-# Start transcription without waiting
-task = client.transcribe("audio.mp3", wait=False)
-print(f"Task started: {task.task_id}")
+# Get all available models
+models = client.get_models()
+
+for model in models:
+    print(f"{model.model_name}: ${model.transcription_rate_per_hour:.2f}/hour")
+```
+
+### Transcribe with Specific Model
 
-# Check status later
-status = client.get_task(task.task_id)
-if status.status == "completed":
-    print(status.result_text)
+```python
+import orbitalsai
+
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Transcribe with Perigee-1 model
+transcript = client.transcribe(
+    "audio.mp3",
+    language="hausa",
+    model_name="Perigee-1"  # Specify the model
+)
 
-# Or wait for completion
-transcript = client.wait_for_task(task.task_id)
 print(transcript.text)
 ```
 
+### Choose Model Based on Budget
+
+```python
+import orbitalsai
+
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Get the cheapest available model
+models = client.get_models()
+cheapest_model = min(models, key=lambda m: m.transcription_rate_per_hour)
+
+print(f"Using {cheapest_model.model_name} at ${cheapest_model.transcription_rate_per_hour:.2f}/hour")
+
+transcript = client.transcribe(
+    "audio.mp3",
+    language="english",
+    model_name=cheapest_model.model_name
+)
+```
+
 ## 🔄 Async Usage
 
 Perfect for processing multiple files or building web applications.
@@ -169,11 +203,15 @@ import orbitalsai
 
 async def main():
     async with orbitalsai.AsyncClient(api_key="your_api_key_here") as client:
+        # List available models
+        models = await client.get_models()
+        print(f"Available models: {[m.model_name for m in models]}")
+        
         # Transcribe multiple files concurrently
         tasks = await asyncio.gather(
-            client.transcribe("audio1.mp3"),
-            client.transcribe("audio2.wav"),
-            client.transcribe("audio3.m4a")
+            client.transcribe("audio1.mp3", model_name="Perigee-1"),
+            client.transcribe("audio2.wav", model_name="Perigee-1"),
+            client.transcribe("audio3.m4a", model_name="Perigee-1")
         )
         
         for transcript in tasks:
@@ -202,7 +240,7 @@ print(f"Last updated: {balance.last_updated}")
 import orbitalsai
 from datetime import date, timedelta
 
-client = orbitalsai.Client(api_key="QDOBQ2PJ.4ThV4fwk-27hpBvh8pYVvAdOOQlA4Lk1fJQdI6EL9Yk")
+client = orbitalsai.Client(api_key="your_api_key_here")
 
 # Get last 7 days of usage
 end_date = date.today()
@@ -280,7 +318,13 @@ except Exception as e:
 
 ### Client Methods
 
-#### `transcribe(file_path, language="english", generate_srt=False, wait=True, timeout=300, poll_interval=5)`
+#### `get_models()`
+
+Get all available AI models with their pricing information.
+
+**Returns:** List of `Model` objects
+
+#### `transcribe(file_path, language="english", generate_srt=False, model_name="Perigee-1", wait=True, timeout=300, poll_interval=5)`
 
 Transcribe an audio file.
 
@@ -288,6 +332,7 @@ Transcribe an audio file.
 - `file_path` (str): Path to the audio file
 - `language` (str): Language code (default: "english")
 - `generate_srt` (bool): Generate SRT subtitles (default: False)
+- `model_name` (str): AI model to use (default: "Perigee-1")
 - `wait` (bool): Wait for completion (default: True)
 - `timeout` (int): Maximum wait time in seconds (default: 300)
 - `poll_interval` (int): Seconds between status checks (default: 5)
@@ -367,6 +412,13 @@ Get current user details.
 - `balance` (float): Current balance in credits
 - `last_updated` (datetime): Last update timestamp
 
+#### `Model`
+- `id` (int): Model ID
+- `model_name` (str): Name of the model (e.g., "Perigee-1")
+- `transcription_rate_per_second` (float): Cost per second of audio
+- `transcription_rate_per_hour` (float): Cost per hour of audio
+- `is_active` (bool): Whether the model is currently available
+
 ## 🌍 Supported Languages
 
 - **English** (`english`)

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/README.md

@@ -95,27 +95,61 @@ print(transcript.text)
 print(transcript.srt_content)  # SRT subtitle content
 ```
 
-### Don't Wait (Advanced)
+## 🤖 AI Model Selection
+
+Choose which AI model to use for transcription. Different models may have different pricing and capabilities.
+
+### List Available Models
 
 ```python
 import orbitalsai
 
 client = orbitalsai.Client(api_key="your_api_key_here")
 
-# Start transcription without waiting
-task = client.transcribe("audio.mp3", wait=False)
-print(f"Task started: {task.task_id}")
+# Get all available models
+models = client.get_models()
+
+for model in models:
+    print(f"{model.model_name}: ${model.transcription_rate_per_hour:.2f}/hour")
+```
+
+### Transcribe with Specific Model
 
-# Check status later
-status = client.get_task(task.task_id)
-if status.status == "completed":
-    print(status.result_text)
+```python
+import orbitalsai
+
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Transcribe with Perigee-1 model
+transcript = client.transcribe(
+    "audio.mp3",
+    language="hausa",
+    model_name="Perigee-1"  # Specify the model
+)
 
-# Or wait for completion
-transcript = client.wait_for_task(task.task_id)
 print(transcript.text)
 ```
 
+### Choose Model Based on Budget
+
+```python
+import orbitalsai
+
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Get the cheapest available model
+models = client.get_models()
+cheapest_model = min(models, key=lambda m: m.transcription_rate_per_hour)
+
+print(f"Using {cheapest_model.model_name} at ${cheapest_model.transcription_rate_per_hour:.2f}/hour")
+
+transcript = client.transcribe(
+    "audio.mp3",
+    language="english",
+    model_name=cheapest_model.model_name
+)
+```
+
 ## 🔄 Async Usage
 
 Perfect for processing multiple files or building web applications.
@@ -126,11 +160,15 @@ import orbitalsai
 
 async def main():
     async with orbitalsai.AsyncClient(api_key="your_api_key_here") as client:
+        # List available models
+        models = await client.get_models()
+        print(f"Available models: {[m.model_name for m in models]}")
+        
         # Transcribe multiple files concurrently
         tasks = await asyncio.gather(
-            client.transcribe("audio1.mp3"),
-            client.transcribe("audio2.wav"),
-            client.transcribe("audio3.m4a")
+            client.transcribe("audio1.mp3", model_name="Perigee-1"),
+            client.transcribe("audio2.wav", model_name="Perigee-1"),
+            client.transcribe("audio3.m4a", model_name="Perigee-1")
         )
         
         for transcript in tasks:
@@ -159,7 +197,7 @@ print(f"Last updated: {balance.last_updated}")
 import orbitalsai
 from datetime import date, timedelta
 
-client = orbitalsai.Client(api_key="QDOBQ2PJ.4ThV4fwk-27hpBvh8pYVvAdOOQlA4Lk1fJQdI6EL9Yk")
+client = orbitalsai.Client(api_key="your_api_key_here")
 
 # Get last 7 days of usage
 end_date = date.today()
@@ -237,7 +275,13 @@ except Exception as e:
 
 ### Client Methods
 
-#### `transcribe(file_path, language="english", generate_srt=False, wait=True, timeout=300, poll_interval=5)`
+#### `get_models()`
+
+Get all available AI models with their pricing information.
+
+**Returns:** List of `Model` objects
+
+#### `transcribe(file_path, language="english", generate_srt=False, model_name="Perigee-1", wait=True, timeout=300, poll_interval=5)`
 
 Transcribe an audio file.
 
@@ -245,6 +289,7 @@ Transcribe an audio file.
 - `file_path` (str): Path to the audio file
 - `language` (str): Language code (default: "english")
 - `generate_srt` (bool): Generate SRT subtitles (default: False)
+- `model_name` (str): AI model to use (default: "Perigee-1")
 - `wait` (bool): Wait for completion (default: True)
 - `timeout` (int): Maximum wait time in seconds (default: 300)
 - `poll_interval` (int): Seconds between status checks (default: 5)
@@ -324,6 +369,13 @@ Get current user details.
 - `balance` (float): Current balance in credits
 - `last_updated` (datetime): Last update timestamp
 
+#### `Model`
+- `id` (int): Model ID
+- `model_name` (str): Name of the model (e.g., "Perigee-1")
+- `transcription_rate_per_second` (float): Cost per second of audio
+- `transcription_rate_per_hour` (float): Cost per hour of audio
+- `is_active` (bool): Whether the model is currently available
+
 ## 🌍 Supported Languages
 
 - **English** (`english`)

orbitalsai-1.1.0/examples/model_selection.py

@@ -0,0 +1,81 @@
+"""
+Example: AI Model Selection
+
+This example demonstrates how to:
+1. List available AI models
+2. View model pricing
+3. Select a specific model for transcription
+"""
+
+import orbitalsai
+
+# Initialize client
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Example 1: List all available models
+print("=" * 60)
+print("Available AI Models")
+print("=" * 60)
+
+models = client.get_models()
+for model in models:
+    print(f"\nModel: {model.model_name}")
+    print(f"  Active: {model.is_active}")
+    print(f"  Pricing per second: ${model.transcription_rate_per_second:.9f}")
+    print(f"  Pricing per hour: ${model.transcription_rate_per_hour:.2f}")
+
+# Example 2: Transcribe with default model (Perigee-1)
+print("\n" + "=" * 60)
+print("Transcribing with Default Model")
+print("=" * 60)
+
+transcript = client.transcribe(
+    "audio.mp3",
+    language="english"
+)
+print(f"Transcription: {transcript.text}")
+
+# Example 3: Transcribe with a specific model
+print("\n" + "=" * 60)
+print("Transcribing with Specific Model")
+print("=" * 60)
+
+transcript = client.transcribe(
+    "audio.mp3",
+    language="hausa",
+    model_name="Perigee-1"  # Explicitly specify model
+)
+print(f"Transcription: {transcript.text}")
+
+# Example 4: Choose model based on pricing
+print("\n" + "=" * 60)
+print("Choosing Model Based on Budget")
+print("=" * 60)
+
+# Get models and sort by price
+models = client.get_models()
+cheapest_model = min(models, key=lambda m: m.transcription_rate_per_hour)
+
+print(f"Using cheapest model: {cheapest_model.model_name}")
+print(f"Cost: ${cheapest_model.transcription_rate_per_hour:.2f}/hour")
+
+transcript = client.transcribe(
+    "audio.mp3",
+    language="english",
+    model_name=cheapest_model.model_name
+)
+print(f"Transcription: {transcript.text}")
+
+# Example 5: Estimate transcription cost
+print("\n" + "=" * 60)
+print("Estimating Transcription Cost")
+print("=" * 60)
+
+# Get audio duration (in seconds) - you would get this from your audio file
+audio_duration_seconds = 120  # 2 minutes
+
+for model in models:
+    estimated_cost = model.transcription_rate_per_second * audio_duration_seconds
+    print(f"\n{model.model_name}:")
+    print(f"  For {audio_duration_seconds}s audio: ${estimated_cost:.4f}")
+

orbitalsai-1.1.0/examples/model_selection_async.py

@@ -0,0 +1,52 @@
+"""
+Example: AI Model Selection (Async)
+
+This example demonstrates how to use AI model selection asynchronously.
+"""
+
+import asyncio
+import orbitalsai
+
+async def main():
+    async with orbitalsai.AsyncClient(api_key="your_api_key_here") as client:
+        # List all available models
+        print("=" * 60)
+        print("Available AI Models")
+        print("=" * 60)
+        
+        models = await client.get_models()
+        for model in models:
+            print(f"\nModel: {model.model_name}")
+            print(f"  Active: {model.is_active}")
+            print(f"  Pricing per second: ${model.transcription_rate_per_second:.9f}")
+            print(f"  Pricing per hour: ${model.transcription_rate_per_hour:.2f}")
+        
+        # Transcribe with specific model
+        print("\n" + "=" * 60)
+        print("Transcribing with Specific Model")
+        print("=" * 60)
+        
+        transcript = await client.transcribe(
+            "audio.mp3",
+            language="hausa",
+            model_name="Perigee-1"
+        )
+        print(f"Transcription: {transcript.text}")
+        
+        # Process multiple files with different models concurrently
+        print("\n" + "=" * 60)
+        print("Processing Multiple Files")
+        print("=" * 60)
+        
+        tasks = await asyncio.gather(
+            client.transcribe("audio1.mp3", language="english", model_name="Perigee-1"),
+            client.transcribe("audio2.mp3", language="hausa", model_name="Perigee-1"),
+            client.transcribe("audio3.mp3", language="yoruba", model_name="Perigee-1")
+        )
+        
+        for i, transcript in enumerate(tasks, 1):
+            print(f"\nFile {i}: {transcript.text[:100]}...")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/examples/simple_transcribe.py

@@ -8,11 +8,11 @@ import orbitalsai
 
 def main():
     # Initialize the client
-    client = orbitalsai.Client(api_key="your_api_key_here")
+    client = orbitalsai.Client(api_key="543EFX45.hwcUuaF2qnQCg4eDG-m7ebphGQErO1XGxe_gSUtGTZg")
     
     # Transcribe an audio file (waits automatically)
     print("Transcribing audio file...")
-    transcript = client.transcribe("path/to/your/audio.mp3")
+    transcript = client.transcribe("/home/azureuser/orbitalsai-python-sdk/f8302363-ee30-4ab2-8f69-216fe0ca08ed.wav", model_name="Perigee-1")
     
     # Print the result
     print(f"Transcription: {transcript.text}")

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/orbitalsai/__init__.py

@@ -20,7 +20,7 @@ Example:
 from .client import Client
 from .async_client import AsyncClient
 from .models import (
-    TranscriptTask, Transcript, Balance, UsageHistory, DailyUsage, User,
+    TranscriptTask, Transcript, Balance, UsageHistory, DailyUsage, User, Model,
     SUPPORTED_LANGUAGES, SUPPORTED_AUDIO_FORMATS, SUPPORTED_AUDIO_MIMETYPES
 )
 from .exceptions import (
@@ -45,6 +45,7 @@ __all__ = [
     "UsageHistory",
     "DailyUsage",
     "User",
+    "Model",
     
     # Constants
     "SUPPORTED_LANGUAGES",

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/orbitalsai/async_client.py

@@ -11,7 +11,7 @@ from datetime import datetime, date
 
 from .models import (
     TranscriptTask, Transcript, Balance, UsageHistory, DailyUsage, 
-    User, APIKey, UsageRecord, DailyUsageRecord
+    User, APIKey, UsageRecord, DailyUsageRecord, Model
 )
 from .exceptions import (
     OrbitalsAIError, AuthenticationError, InsufficientBalanceError,
@@ -101,11 +101,33 @@ class AsyncClient:
         except aiohttp.ClientError as e:
             raise OrbitalsAIError(f"Request failed: {str(e)}")
     
+    async def get_models(self) -> List[Model]:
+        """
+        Get all available AI models with their pricing information.
+        
+        Returns:
+            List of Model objects with pricing details
+        """
+        response = await self._make_request("GET", "/models")
+        
+        models = []
+        for model_data in response:
+            models.append(Model(
+                id=model_data["id"],
+                model_name=model_data["model_name"],
+                transcription_rate_per_second=model_data["transcription_rate_per_second"],
+                transcription_rate_per_hour=model_data["transcription_rate_per_hour"],
+                is_active=model_data["is_active"]
+            ))
+        
+        return models
+    
     async def transcribe(
         self, 
         file_path: str, 
         language: str = "english", 
         generate_srt: bool = False,
+        model_name: str = "Perigee-1",
         wait: bool = True,
         timeout: int = 300,
         poll_interval: int = 5
@@ -117,6 +139,7 @@ class AsyncClient:
             file_path: Path to the audio file
             language: Language of the audio (default: "english")
             generate_srt: Whether to generate SRT subtitles (default: False)
+            model_name: AI model to use for transcription (default: "Perigee-1")
             wait: Whether to wait for completion (default: True)
             timeout: Maximum time to wait in seconds (default: 300)
             poll_interval: Seconds to wait between status checks (default: 5)
@@ -141,6 +164,7 @@ class AsyncClient:
             data.add_field('file', f, filename=file_path.split('/')[-1], content_type='audio/mpeg')
             data.add_field('language', language)
             data.add_field('generate_srt', str(generate_srt).lower())
+            data.add_field('model_name', model_name)
             
             # Upload file
             response = await self._make_request("POST", "/audio/upload", data=data)

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/orbitalsai/client.py

@@ -12,7 +12,7 @@ from pathlib import Path
 
 from .models import (
     TranscriptTask, Transcript, Balance, UsageHistory, DailyUsage, 
-    User, APIKey, UsageRecord, DailyUsageRecord
+    User, APIKey, UsageRecord, DailyUsageRecord, Model
 )
 from .exceptions import (
     OrbitalsAIError, AuthenticationError, InsufficientBalanceError,
@@ -89,11 +89,33 @@ class Client:
         except requests.exceptions.RequestException as e:
             raise OrbitalsAIError(f"Request failed: {str(e)}")
     
+    def get_models(self) -> List[Model]:
+        """
+        Get all available AI models with their pricing information.
+        
+        Returns:
+            List of Model objects with pricing details
+        """
+        response = self._make_request("GET", "/models")
+        
+        models = []
+        for model_data in response:
+            models.append(Model(
+                id=model_data["id"],
+                model_name=model_data["model_name"],
+                transcription_rate_per_second=model_data["transcription_rate_per_second"],
+                transcription_rate_per_hour=model_data["transcription_rate_per_hour"],
+                is_active=model_data["is_active"]
+            ))
+        
+        return models
+    
     def transcribe(
         self, 
         file_path: str, 
         language: str = "english", 
         generate_srt: bool = False,
+        model_name: str = "Perigee-1",
         wait: bool = True,
         timeout: int = 300,
         poll_interval: int = 5
@@ -105,6 +127,7 @@ class Client:
             file_path: Path to the audio file
             language: Language of the audio (default: "english")
             generate_srt: Whether to generate SRT subtitles (default: False)
+            model_name: AI model to use for transcription (default: "Perigee-1")
             wait: Whether to wait for completion (default: True)
             timeout: Maximum time to wait in seconds (default: 300)
             poll_interval: Seconds to wait between status checks (default: 5)
@@ -128,7 +151,8 @@ class Client:
             files = {"file": (Path(file_path).name, f, "audio/mpeg")}
             data = {
                 "language": language,
-                "generate_srt": str(generate_srt).lower()
+                "generate_srt": str(generate_srt).lower(),
+                "model_name": model_name
             }
             
             # Upload file
@@ -249,54 +273,6 @@ class Client:
             last_updated=datetime.fromisoformat(response["last_updated"].replace('Z', '+00:00'))
         )
     
-    def get_usage_history(
-        self, 
-        start_date: Optional[datetime] = None, 
-        end_date: Optional[datetime] = None,
-        page: int = 1,
-        page_size: int = 50
-    ) -> UsageHistory:
-        """
-        Get usage history for the current user.
-        
-        Args:
-            start_date: Start date for the history (default: 30 days ago)
-            end_date: End date for the history (default: now)
-            page: Page number (default: 1)
-            page_size: Number of records per page (default: 50)
-            
-        Returns:
-            UsageHistory object with usage records
-        """
-        params = {"page": page, "page_size": page_size}
-        if start_date:
-            params["start_date"] = start_date.isoformat()
-        if end_date:
-            params["end_date"] = end_date.isoformat()
-        
-        response = self._make_request("GET", "/billing/usage-history", params=params)
-        
-        records = []
-        for record_data in response["records"]:
-            records.append(UsageRecord(
-                id=record_data["id"],
-                service_type=record_data["service_type"],
-                usage_amount=record_data["total_audio_usage"],
-                cost=record_data["cost"],
-                timestamp=datetime.fromisoformat(record_data["timestamp"].replace('Z', '+00:00')),
-                api_key_id=record_data.get("api_key_id")
-            ))
-        
-        return UsageHistory(
-            records=records,
-            total_records=response["total_records"],
-            total_pages=response["total_pages"],
-            current_page=response["current_page"],
-            start_date=datetime.fromisoformat(response["start_date"].replace('Z', '+00:00')),
-            end_date=datetime.fromisoformat(response["end_date"].replace('Z', '+00:00')),
-            period_summary=response["period_summary"]
-        )
-    
     def get_daily_usage(
         self, 
         start_date: Optional[date] = None, 

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/orbitalsai/models.py

@@ -114,6 +114,16 @@ class APIKey:
     last_used: Optional[datetime] = None
 
 
+@dataclass
+class Model:
+    """Represents an AI model with pricing information."""
+    id: int
+    model_name: str
+    transcription_rate_per_second: float
+    transcription_rate_per_hour: float
+    is_active: bool
+
+
 # Supported languages and file formats
 SUPPORTED_LANGUAGES = [
     "english", "hausa", "igbo", "yoruba", "swahili", "pidgin", "kinyarwanda"

{orbitalsai-1.0.0 → orbitalsai-1.1.0/orbitalsai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orbitalsai
-Version: 1.0.0
+Version: 1.1.0
 Summary: A simple and powerful Python SDK for the OrbitalsAI API
 Home-page: https://github.com/orbitalsai/orbitalsai-python-sdk
 Author: OrbitalsAI
@@ -138,27 +138,61 @@ print(transcript.text)
 print(transcript.srt_content)  # SRT subtitle content
 ```
 
-### Don't Wait (Advanced)
+## 🤖 AI Model Selection
+
+Choose which AI model to use for transcription. Different models may have different pricing and capabilities.
+
+### List Available Models
 
 ```python
 import orbitalsai
 
 client = orbitalsai.Client(api_key="your_api_key_here")
 
-# Start transcription without waiting
-task = client.transcribe("audio.mp3", wait=False)
-print(f"Task started: {task.task_id}")
+# Get all available models
+models = client.get_models()
+
+for model in models:
+    print(f"{model.model_name}: ${model.transcription_rate_per_hour:.2f}/hour")
+```
+
+### Transcribe with Specific Model
 
-# Check status later
-status = client.get_task(task.task_id)
-if status.status == "completed":
-    print(status.result_text)
+```python
+import orbitalsai
+
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Transcribe with Perigee-1 model
+transcript = client.transcribe(
+    "audio.mp3",
+    language="hausa",
+    model_name="Perigee-1"  # Specify the model
+)
 
-# Or wait for completion
-transcript = client.wait_for_task(task.task_id)
 print(transcript.text)
 ```
 
+### Choose Model Based on Budget
+
+```python
+import orbitalsai
+
+client = orbitalsai.Client(api_key="your_api_key_here")
+
+# Get the cheapest available model
+models = client.get_models()
+cheapest_model = min(models, key=lambda m: m.transcription_rate_per_hour)
+
+print(f"Using {cheapest_model.model_name} at ${cheapest_model.transcription_rate_per_hour:.2f}/hour")
+
+transcript = client.transcribe(
+    "audio.mp3",
+    language="english",
+    model_name=cheapest_model.model_name
+)
+```
+
 ## 🔄 Async Usage
 
 Perfect for processing multiple files or building web applications.
@@ -169,11 +203,15 @@ import orbitalsai
 
 async def main():
     async with orbitalsai.AsyncClient(api_key="your_api_key_here") as client:
+        # List available models
+        models = await client.get_models()
+        print(f"Available models: {[m.model_name for m in models]}")
+        
         # Transcribe multiple files concurrently
         tasks = await asyncio.gather(
-            client.transcribe("audio1.mp3"),
-            client.transcribe("audio2.wav"),
-            client.transcribe("audio3.m4a")
+            client.transcribe("audio1.mp3", model_name="Perigee-1"),
+            client.transcribe("audio2.wav", model_name="Perigee-1"),
+            client.transcribe("audio3.m4a", model_name="Perigee-1")
         )
         
         for transcript in tasks:
@@ -202,7 +240,7 @@ print(f"Last updated: {balance.last_updated}")
 import orbitalsai
 from datetime import date, timedelta
 
-client = orbitalsai.Client(api_key="QDOBQ2PJ.4ThV4fwk-27hpBvh8pYVvAdOOQlA4Lk1fJQdI6EL9Yk")
+client = orbitalsai.Client(api_key="your_api_key_here")
 
 # Get last 7 days of usage
 end_date = date.today()
@@ -280,7 +318,13 @@ except Exception as e:
 
 ### Client Methods
 
-#### `transcribe(file_path, language="english", generate_srt=False, wait=True, timeout=300, poll_interval=5)`
+#### `get_models()`
+
+Get all available AI models with their pricing information.
+
+**Returns:** List of `Model` objects
+
+#### `transcribe(file_path, language="english", generate_srt=False, model_name="Perigee-1", wait=True, timeout=300, poll_interval=5)`
 
 Transcribe an audio file.
 
@@ -288,6 +332,7 @@ Transcribe an audio file.
 - `file_path` (str): Path to the audio file
 - `language` (str): Language code (default: "english")
 - `generate_srt` (bool): Generate SRT subtitles (default: False)
+- `model_name` (str): AI model to use (default: "Perigee-1")
 - `wait` (bool): Wait for completion (default: True)
 - `timeout` (int): Maximum wait time in seconds (default: 300)
 - `poll_interval` (int): Seconds between status checks (default: 5)
@@ -367,6 +412,13 @@ Get current user details.
 - `balance` (float): Current balance in credits
 - `last_updated` (datetime): Last update timestamp
 
+#### `Model`
+- `id` (int): Model ID
+- `model_name` (str): Name of the model (e.g., "Perigee-1")
+- `transcription_rate_per_second` (float): Cost per second of audio
+- `transcription_rate_per_hour` (float): Cost per hour of audio
+- `is_active` (bool): Whether the model is currently available
+
 ## 🌍 Supported Languages
 
 - **English** (`english`)

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/orbitalsai.egg-info/SOURCES.txt

@@ -3,9 +3,12 @@ LICENSE
 README.md
 pyproject.toml
 setup.py
+test_model_update.py
 examples/async_transcribe.py
 examples/error_handling.py
 examples/manage_balance.py
+examples/model_selection.py
+examples/model_selection_async.py
 examples/simple_transcribe.py
 examples/with_srt.py
 orbitalsai/__init__.py

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "orbitalsai"
-version = "1.0.0"
+version = "1.1.0"
 description = "A simple and powerful Python SDK for the OrbitalsAI API"
 readme = "README.md"
 license = {text = "MIT"}

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/setup.py

@@ -9,7 +9,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="orbitalsai",
-    version="1.0.0",
+    version="1.1.0",
     author="OrbitalsAI",
     author_email="support@orbitalsai.com",
     description="A simple and powerful Python SDK for the OrbitalsAI API",

orbitalsai-1.1.0/test_model_update.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+"""
+Quick test script to verify model selection updates
+
+This script tests:
+1. Model dataclass can be imported
+2. Client has get_models method
+3. AsyncClient has get_models method  
+4. transcribe method accepts model_name parameter
+"""
+
+import sys
+
+def test_imports():
+    """Test that all imports work"""
+    print("Testing imports...")
+    try:
+        from orbitalsai import Client, AsyncClient, Model
+        from orbitalsai.models import Model as ModelDirect
+        print("✅ All imports successful")
+        return True
+    except ImportError as e:
+        print(f"❌ Import failed: {e}")
+        return False
+
+def test_model_dataclass():
+    """Test Model dataclass"""
+    print("\nTesting Model dataclass...")
+    try:
+        from orbitalsai import Model
+        
+        model = Model(
+            id=1,
+            model_name="Perigee-1",
+            transcription_rate_per_second=0.000069444,
+            transcription_rate_per_hour=0.25,
+            is_active=True
+        )
+        
+        assert model.model_name == "Perigee-1"
+        assert model.transcription_rate_per_hour == 0.25
+        assert model.is_active is True
+        
+        print("✅ Model dataclass works correctly")
+        return True
+    except Exception as e:
+        print(f"❌ Model dataclass test failed: {e}")
+        return False
+
+def test_client_methods():
+    """Test that Client has new methods"""
+    print("\nTesting Client methods...")
+    try:
+        from orbitalsai import Client
+        import inspect
+        
+        # Check get_models method exists
+        assert hasattr(Client, 'get_models')
+        print("  ✅ Client.get_models() method exists")
+        
+        # Check transcribe accepts model_name
+        sig = inspect.signature(Client.transcribe)
+        params = sig.parameters
+        assert 'model_name' in params
+        assert params['model_name'].default == "Perigee-1"
+        print("  ✅ Client.transcribe() accepts model_name parameter")
+        
+        return True
+    except Exception as e:
+        print(f"❌ Client method test failed: {e}")
+        return False
+
+def test_async_client_methods():
+    """Test that AsyncClient has new methods"""
+    print("\nTesting AsyncClient methods...")
+    try:
+        from orbitalsai import AsyncClient
+        import inspect
+        
+        # Check get_models method exists
+        assert hasattr(AsyncClient, 'get_models')
+        print("  ✅ AsyncClient.get_models() method exists")
+        
+        # Check transcribe accepts model_name
+        sig = inspect.signature(AsyncClient.transcribe)
+        params = sig.parameters
+        assert 'model_name' in params
+        assert params['model_name'].default == "Perigee-1"
+        print("  ✅ AsyncClient.transcribe() accepts model_name parameter")
+        
+        return True
+    except Exception as e:
+        print(f"❌ AsyncClient method test failed: {e}")
+        return False
+
+def main():
+    """Run all tests"""
+    print("=" * 60)
+    print("OrbitalsAI SDK - Model Selection Update Tests")
+    print("=" * 60)
+    
+    tests = [
+        test_imports,
+        test_model_dataclass,
+        test_client_methods,
+        test_async_client_methods,
+    ]
+    
+    results = []
+    for test in tests:
+        results.append(test())
+    
+    print("\n" + "=" * 60)
+    print("Test Summary")
+    print("=" * 60)
+    passed = sum(results)
+    total = len(results)
+    print(f"Passed: {passed}/{total}")
+    
+    if passed == total:
+        print("\n✅ All tests passed! SDK update is working correctly.")
+        return 0
+    else:
+        print(f"\n❌ {total - passed} test(s) failed. Please review the errors above.")
+        return 1
+
+if __name__ == "__main__":
+    sys.exit(main())
+

{orbitalsai-1.0.0 → orbitalsai-1.1.0}/tests/test_client.py

@@ -5,7 +5,7 @@ Basic tests for the OrbitalsAI SDK
 import pytest
 from unittest.mock import Mock, patch
 from orbitalsai import Client, AsyncClient
-from orbitalsai.exceptions import AuthenticationError, UnsupportedFileError
+from orbitalsai.exceptions import AuthenticationError
 
 
 class TestClient: