audiopod 1.5.0__tar.gz → 2.1.0__tar.gz

audiopod-2.1.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: audiopod
+Version: 2.1.0
+Summary: Official AudioPod SDK for Python - Professional Audio Processing powered by AI
+Author-email: AudioPod AI <support@audiopod.ai>
+License: MIT
+Project-URL: Homepage, https://audiopod.ai
+Project-URL: Documentation, https://docs.audiopod.ai
+Project-URL: Repository, https://github.com/AudiopodAI/audiopod-sdk-python
+Project-URL: Issues, https://github.com/AudiopodAI/audiopod-sdk-python/issues
+Keywords: audiopod,audio,ai,speech-to-text,transcription,text-to-speech,tts,voice-cloning,music-generation,stem-separation,denoiser,speaker-diarization
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: urllib3>=1.26.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-requests>=2.28.0; extra == "dev"
+Dynamic: license-file
+
+# AudioPod Python SDK
+
+Official Python SDK for [AudioPod AI](https://audiopod.ai) - Professional Audio Processing powered by AI.
+
+[![PyPI version](https://badge.fury.io/py/audiopod.svg)](https://pypi.org/project/audiopod/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+pip install audiopod
+```
+
+## Quick Start
+
+```python
+from audiopod import AudioPod
+
+# Initialize client
+client = AudioPod(api_key="ap_your_api_key")
+
+# Separate audio into 6 stems
+result = client.stems.separate(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="six"
+)
+
+# Download stems
+for stem, url in result["download_urls"].items():
+    print(f"{stem}: {url}")
+```
+
+## Stem Separation
+
+Extract individual audio components from mixed recordings.
+
+### Available Modes
+
+| Mode | Stems | Output |
+|------|-------|--------|
+| `single` | 1 | Specified stem only (vocals, drums, bass, guitar, piano, other) |
+| `two` | 2 | Vocals + Instrumental |
+| `four` | 4 | Vocals, Drums, Bass, Other |
+| `six` | 6 | Vocals, Drums, Bass, Guitar, Piano, Other |
+| `producer` | 8 | + Kick, Snare, Hihat |
+| `studio` | 12 | Full production toolkit |
+| `mastering` | 16 | Maximum detail |
+
+### Examples
+
+```python
+from audiopod import AudioPod
+
+client = AudioPod(api_key="ap_your_api_key")
+
+# Six-stem separation from YouTube
+job = client.stems.extract(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="six"
+)
+print(f"Job ID: {job['id']}")
+
+# Wait for completion
+result = client.stems.wait_for_completion(job["id"])
+print(result["download_urls"])
+
+# Or use the convenience method (extract + wait)
+result = client.stems.separate(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="six"
+)
+
+# From local file
+result = client.stems.separate(
+    file="./song.mp3",
+    mode="four"
+)
+
+# Extract only vocals
+result = client.stems.separate(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="single",
+    stem="vocals"
+)
+
+# Get available modes
+modes = client.stems.modes()
+for m in modes["modes"]:
+    print(f"{m['mode']}: {m['description']}")
+```
+
+## API Wallet
+
+Check balance and manage your wallet.
+
+```python
+# Check balance
+balance = client.wallet.balance()
+print(f"Balance: {balance['balance_usd']}")
+
+# Estimate cost
+estimate = client.wallet.estimate("stem_extraction", duration_seconds=180)
+print(f"Estimated cost: {estimate['cost_usd']}")
+
+# Get usage history
+usage = client.wallet.usage()
+for log in usage["logs"]:
+    print(f"{log['service_type']}: {log['amount_usd']}")
+```
+
+## Other Services
+
+```python
+# Transcription
+job = client.transcription.create(url="https://...")
+result = client.transcription.wait_for_completion(job["id"])
+
+# Voice cloning
+voice = client.voice.clone(file="./sample.wav", name="My Voice")
+
+# Music generation
+song = client.music.generate(prompt="upbeat electronic dance music")
+
+# Noise reduction
+clean = client.denoiser.denoise(file="./noisy.wav")
+
+# Speaker diarization
+speakers = client.speaker.diarize(url="https://...")
+```
+
+## Error Handling
+
+```python
+from audiopod import AudioPod, InsufficientBalanceError, AuthenticationError
+
+try:
+    client = AudioPod(api_key="ap_...")
+    result = client.stems.separate(url="...", mode="six")
+except AuthenticationError:
+    print("Invalid API key")
+except InsufficientBalanceError as e:
+    print(f"Need more credits. Required: {e.required_cents} cents")
+```
+
+## Environment Variables
+
+```bash
+export AUDIOPOD_API_KEY="ap_your_api_key"
+```
+
+```python
+# Client reads from env automatically
+client = AudioPod()
+```
+
+## Documentation
+
+- [API Documentation](https://docs.audiopod.ai)
+- [API Reference](https://docs.audiopod.ai/api-reference/stem-splitter)
+- [Get API Key](https://www.audiopod.ai/dashboard/account/api-keys)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

audiopod-2.1.0/README.md

@@ -0,0 +1,165 @@
+# AudioPod Python SDK
+
+Official Python SDK for [AudioPod AI](https://audiopod.ai) - Professional Audio Processing powered by AI.
+
+[![PyPI version](https://badge.fury.io/py/audiopod.svg)](https://pypi.org/project/audiopod/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+pip install audiopod
+```
+
+## Quick Start
+
+```python
+from audiopod import AudioPod
+
+# Initialize client
+client = AudioPod(api_key="ap_your_api_key")
+
+# Separate audio into 6 stems
+result = client.stems.separate(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="six"
+)
+
+# Download stems
+for stem, url in result["download_urls"].items():
+    print(f"{stem}: {url}")
+```
+
+## Stem Separation
+
+Extract individual audio components from mixed recordings.
+
+### Available Modes
+
+| Mode | Stems | Output |
+|------|-------|--------|
+| `single` | 1 | Specified stem only (vocals, drums, bass, guitar, piano, other) |
+| `two` | 2 | Vocals + Instrumental |
+| `four` | 4 | Vocals, Drums, Bass, Other |
+| `six` | 6 | Vocals, Drums, Bass, Guitar, Piano, Other |
+| `producer` | 8 | + Kick, Snare, Hihat |
+| `studio` | 12 | Full production toolkit |
+| `mastering` | 16 | Maximum detail |
+
+### Examples
+
+```python
+from audiopod import AudioPod
+
+client = AudioPod(api_key="ap_your_api_key")
+
+# Six-stem separation from YouTube
+job = client.stems.extract(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="six"
+)
+print(f"Job ID: {job['id']}")
+
+# Wait for completion
+result = client.stems.wait_for_completion(job["id"])
+print(result["download_urls"])
+
+# Or use the convenience method (extract + wait)
+result = client.stems.separate(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="six"
+)
+
+# From local file
+result = client.stems.separate(
+    file="./song.mp3",
+    mode="four"
+)
+
+# Extract only vocals
+result = client.stems.separate(
+    url="https://youtube.com/watch?v=VIDEO_ID",
+    mode="single",
+    stem="vocals"
+)
+
+# Get available modes
+modes = client.stems.modes()
+for m in modes["modes"]:
+    print(f"{m['mode']}: {m['description']}")
+```
+
+## API Wallet
+
+Check balance and manage your wallet.
+
+```python
+# Check balance
+balance = client.wallet.balance()
+print(f"Balance: {balance['balance_usd']}")
+
+# Estimate cost
+estimate = client.wallet.estimate("stem_extraction", duration_seconds=180)
+print(f"Estimated cost: {estimate['cost_usd']}")
+
+# Get usage history
+usage = client.wallet.usage()
+for log in usage["logs"]:
+    print(f"{log['service_type']}: {log['amount_usd']}")
+```
+
+## Other Services
+
+```python
+# Transcription
+job = client.transcription.create(url="https://...")
+result = client.transcription.wait_for_completion(job["id"])
+
+# Voice cloning
+voice = client.voice.clone(file="./sample.wav", name="My Voice")
+
+# Music generation
+song = client.music.generate(prompt="upbeat electronic dance music")
+
+# Noise reduction
+clean = client.denoiser.denoise(file="./noisy.wav")
+
+# Speaker diarization
+speakers = client.speaker.diarize(url="https://...")
+```
+
+## Error Handling
+
+```python
+from audiopod import AudioPod, InsufficientBalanceError, AuthenticationError
+
+try:
+    client = AudioPod(api_key="ap_...")
+    result = client.stems.separate(url="...", mode="six")
+except AuthenticationError:
+    print("Invalid API key")
+except InsufficientBalanceError as e:
+    print(f"Need more credits. Required: {e.required_cents} cents")
+```
+
+## Environment Variables
+
+```bash
+export AUDIOPOD_API_KEY="ap_your_api_key"
+```
+
+```python
+# Client reads from env automatically
+client = AudioPod()
+```
+
+## Documentation
+
+- [API Documentation](https://docs.audiopod.ai)
+- [API Reference](https://docs.audiopod.ai/api-reference/stem-splitter)
+- [Get API Key](https://www.audiopod.ai/dashboard/account/api-keys)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

{audiopod-1.5.0 → audiopod-2.1.0}/audiopod/__init__.py

@@ -1,33 +1,34 @@
 """
 AudioPod SDK for Python
 Professional Audio Processing powered by AI
+
+Example:
+    from audiopod import AudioPod
+
+    client = AudioPod(api_key="ap_...")
+
+    # Transcribe audio
+    job = client.transcription.create(url="https://...")
+    result = client.transcription.wait_for_completion(job.id)
 """
 
-__version__ = "1.5.0"
+__version__ = "2.1.0"
 
-from .client import Client, AsyncClient
+from .client import AudioPod
 from .exceptions import (
     AudioPodError,
     AuthenticationError,
     APIError,
     RateLimitError,
-    ValidationError,
     InsufficientBalanceError,
 )
 
-# Alias for consistency with documentation and Node.js SDK
-AudioPod = Client
-
 __all__ = [
-    "Client",
-    "AsyncClient",
-    "AudioPod",  # Alias for Client
+    "AudioPod",
     "AudioPodError",
-    "AuthenticationError", 
+    "AuthenticationError",
     "APIError",
     "RateLimitError",
-    "ValidationError",
     "InsufficientBalanceError",
     "__version__",
 ]
-

audiopod-2.1.0/audiopod/client.py

@@ -0,0 +1,198 @@
+"""
+AudioPod API Client
+
+Clean, minimal API inspired by OpenAI's SDK design.
+"""
+
+import os
+from typing import Optional, Dict, Any, BinaryIO
+from urllib.parse import urljoin
+
+import requests
+from requests.adapters import HTTPAdapter
+from urllib3.util.retry import Retry
+
+from .exceptions import (
+    AuthenticationError,
+    APIError,
+    RateLimitError,
+    InsufficientBalanceError,
+)
+from .resources.transcription import Transcription
+from .resources.voice import Voice
+from .resources.music import Music
+from .resources.stems import StemExtraction
+from .resources.denoiser import Denoiser
+from .resources.speaker import Speaker
+from .resources.wallet import Wallet
+
+VERSION = "2.1.0"
+DEFAULT_BASE_URL = "https://api.audiopod.ai"
+DEFAULT_TIMEOUT = 60
+
+
+class AudioPod:
+    """
+    AudioPod API Client.
+
+    Args:
+        api_key: Your AudioPod API key (starts with 'ap_').
+                 If not provided, reads from AUDIOPOD_API_KEY env var.
+        base_url: Base URL for the API (default: https://api.audiopod.ai)
+        timeout: Request timeout in seconds (default: 60)
+        max_retries: Maximum retries for failed requests (default: 3)
+
+    Example:
+        >>> from audiopod import AudioPod
+        >>> client = AudioPod(api_key="ap_...")
+        >>> result = client.transcription.transcribe(url="https://...")
+    """
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        base_url: Optional[str] = None,
+        timeout: int = DEFAULT_TIMEOUT,
+        max_retries: int = 3,
+    ):
+        self.api_key = api_key or os.getenv("AUDIOPOD_API_KEY")
+
+        if not self.api_key:
+            raise AuthenticationError(
+                "API key is required. Pass api_key or set AUDIOPOD_API_KEY environment variable."
+            )
+
+        if not self.api_key.startswith("ap_"):
+            raise AuthenticationError(
+                "Invalid API key format. AudioPod API keys start with 'ap_'"
+            )
+
+        self.base_url = base_url or DEFAULT_BASE_URL
+        self.timeout = timeout
+
+        # Configure session with retries
+        self._session = requests.Session()
+        retry_strategy = Retry(
+            total=max_retries,
+            status_forcelist=[429, 500, 502, 503, 504],
+            allowed_methods=["HEAD", "GET", "OPTIONS", "POST", "DELETE"],
+            backoff_factor=1,
+        )
+        adapter = HTTPAdapter(max_retries=retry_strategy)
+        self._session.mount("http://", adapter)
+        self._session.mount("https://", adapter)
+
+        # Initialize services
+        self.transcription = Transcription(self)
+        self.voice = Voice(self)
+        self.music = Music(self)
+        self.stems = StemExtraction(self)
+        self.denoiser = Denoiser(self)
+        self.speaker = Speaker(self)
+        self.wallet = Wallet(self)
+
+    def _get_headers(self) -> Dict[str, str]:
+        return {
+            "Authorization": f"Bearer {self.api_key}",
+            "X-API-Key": self.api_key,
+            "Content-Type": "application/json",
+            "User-Agent": f"audiopod-python/{VERSION}",
+            "Accept": "application/json",
+        }
+
+    def _handle_response(self, response: requests.Response) -> Dict[str, Any]:
+        try:
+            response.raise_for_status()
+            if response.status_code == 204:
+                return {}
+            return response.json()
+        except requests.exceptions.HTTPError:
+            status = response.status_code
+            try:
+                data = response.json()
+                message = data.get("detail") or data.get("message") or str(data)
+            except Exception:
+                message = response.text or f"HTTP {status}"
+
+            if status == 401:
+                raise AuthenticationError(message)
+            elif status == 402:
+                try:
+                    data = response.json()
+                    raise InsufficientBalanceError(
+                        message,
+                        required_cents=data.get("required_cents"),
+                        available_cents=data.get("available_cents"),
+                    )
+                except (ValueError, KeyError):
+                    raise InsufficientBalanceError(message)
+            elif status == 429:
+                raise RateLimitError(message)
+            else:
+                raise APIError(message, status_code=status)
+
+    def get(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """Make a GET request."""
+        url = urljoin(self.base_url, endpoint)
+        headers = self._get_headers()
+        response = self._session.get(
+            url, headers=headers, params=params, timeout=self.timeout
+        )
+        return self._handle_response(response)
+
+    def post(
+        self,
+        endpoint: str,
+        data: Optional[Dict[str, Any]] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        """Make a POST request."""
+        url = urljoin(self.base_url, endpoint)
+        headers = self._get_headers()
+        response = self._session.post(
+            url, headers=headers, data=data, json=json_data, timeout=self.timeout
+        )
+        return self._handle_response(response)
+
+    def delete(self, endpoint: str) -> Dict[str, Any]:
+        """Make a DELETE request."""
+        url = urljoin(self.base_url, endpoint)
+        headers = self._get_headers()
+        response = self._session.delete(url, headers=headers, timeout=self.timeout)
+        return self._handle_response(response)
+
+    def upload(
+        self,
+        endpoint: str,
+        file_path: str,
+        field_name: str = "file",
+        additional_fields: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        """Upload a file."""
+        url = urljoin(self.base_url, endpoint)
+        headers = self._get_headers()
+        headers.pop("Content-Type", None)  # Let requests set multipart boundary
+
+        with open(file_path, "rb") as f:
+            files = {field_name: f}
+            data = {}
+            if additional_fields:
+                for key, value in additional_fields.items():
+                    if value is not None:
+                        data[key] = str(value) if not isinstance(value, str) else value
+
+            response = self._session.post(
+                url, headers=headers, files=files, data=data, timeout=self.timeout
+            )
+
+        return self._handle_response(response)
+
+    def close(self):
+        """Close the client session."""
+        self._session.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()

audiopod-2.1.0/audiopod/exceptions.py

@@ -0,0 +1,49 @@
+"""
+AudioPod SDK Exceptions
+"""
+
+from typing import Optional
+
+
+class AudioPodError(Exception):
+    """Base exception for AudioPod SDK."""
+
+    def __init__(self, message: str = "An error occurred"):
+        self.message = message
+        super().__init__(self.message)
+
+
+class AuthenticationError(AudioPodError):
+    """Raised when authentication fails."""
+
+    def __init__(self, message: str = "Authentication failed"):
+        super().__init__(message)
+
+
+class APIError(AudioPodError):
+    """Raised when an API request fails."""
+
+    def __init__(self, message: str = "API request failed", status_code: Optional[int] = None):
+        self.status_code = status_code
+        super().__init__(message)
+
+
+class RateLimitError(AudioPodError):
+    """Raised when rate limit is exceeded."""
+
+    def __init__(self, message: str = "Rate limit exceeded"):
+        super().__init__(message)
+
+
+class InsufficientBalanceError(AudioPodError):
+    """Raised when wallet balance is insufficient."""
+
+    def __init__(
+        self,
+        message: str = "Insufficient wallet balance",
+        required_cents: Optional[int] = None,
+        available_cents: Optional[int] = None,
+    ):
+        self.required_cents = required_cents
+        self.available_cents = available_cents
+        super().__init__(message)

audiopod-2.1.0/audiopod/resources/__init__.py

@@ -0,0 +1,23 @@
+"""AudioPod SDK Resources"""
+
+from .transcription import Transcription
+from .voice import Voice
+from .music import Music
+from .stems import StemExtraction
+from .denoiser import Denoiser
+from .speaker import Speaker
+from .wallet import Wallet
+
+__all__ = [
+    "Transcription",
+    "Voice",
+    "Music",
+    "StemExtraction",
+    "Denoiser",
+    "Speaker",
+    "Wallet",
+]
+
+
+
+