audiopod 1.1.0__py3-none-any.whl → 1.1.1__py3-none-any.whl

audiopod/__init__.py

@@ -47,7 +47,7 @@ from .models import (
     TranslationResult
 )
 
-__version__ = "1.1.0"
+__version__ = "1.1.1"
 __author__ = "AudioPod AI"
 __email__ = "support@audiopod.ai"
 __license__ = "MIT"

audiopod/models.py

@@ -151,13 +151,18 @@ class MusicGenerationResult:
 
 @dataclass
 class TranslationResult:
-    """Translation job result"""
+    """Speech translation job result"""
     job: Job
     source_language: Optional[str] = None
     target_language: Optional[str] = None
-    audio_output_url: Optional[str] = None
-    video_output_url: Optional[str] = None
+    display_name: Optional[str] = None
+    audio_output_path: Optional[str] = None
+    video_output_path: Optional[str] = None
     transcript_path: Optional[str] = None
+    translated_audio_url: Optional[str] = None
+    video_output_url: Optional[str] = None
+    transcript_urls: Optional[Dict[str, str]] = None
+    is_video: bool = False
     
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> 'TranslationResult':
@@ -166,10 +171,20 @@ class TranslationResult:
             job=Job.from_dict(data),
             source_language=data.get('source_language'),
             target_language=data.get('target_language'),
-            audio_output_url=data.get('audio_output_path'),
-            video_output_url=data.get('video_output_path'),
-            transcript_path=data.get('transcript_path')
+            display_name=data.get('display_name'),
+            audio_output_path=data.get('audio_output_path'),
+            video_output_path=data.get('video_output_path'),
+            transcript_path=data.get('transcript_path'),
+            translated_audio_url=data.get('translated_audio_url'),
+            video_output_url=data.get('video_output_url'),
+            transcript_urls=data.get('transcript_urls'),
+            is_video=data.get('is_video', False)
         )
+    
+    @property
+    def audio_output_url(self) -> Optional[str]:
+        """Backward compatibility property - returns translated_audio_url"""
+        return self.translated_audio_url
 
 
 @dataclass

audiopod/services/translation.py

@@ -1,42 +1,59 @@
 """
-Translation Service - Audio/video translation operations
+Translation Service - Speech-to-speech translation operations
 """
 
 from typing import Optional, Union
 from .base import BaseService
 from ..models import Job, TranslationResult
+from ..exceptions import ValidationError
 
 
 class TranslationService(BaseService):
-    """Service for audio and video translation operations"""
+    """Service for speech-to-speech translation operations"""
     
     def translate_audio(
         self,
-        audio_file: str,
-        target_language: str,
+        audio_file: Optional[str] = None,
+        url: Optional[str] = None,
+        target_language: str = "en",
         source_language: Optional[str] = None,
         wait_for_completion: bool = False,
         timeout: int = 900
     ) -> Union[Job, TranslationResult]:
         """
-        Translate audio to another language
+        Translate speech from audio/video file to another language while preserving voice characteristics
         
         Args:
-            audio_file: Path to audio file
-            target_language: Target language code
-            source_language: Source language (auto-detect if None)
+            audio_file: Path to audio/video file (required if no URL)
+            url: Direct media URL (required if no file)
+            target_language: Target language code (ISO 639-1, e.g., 'es' for Spanish)
+            source_language: Source language code (auto-detect if None)
             wait_for_completion: Whether to wait for completion
             timeout: Maximum time to wait
             
         Returns:
             Job object or translation result
         """
+        if not audio_file and not url:
+            raise ValidationError("Either audio_file or url must be provided")
+        
+        if audio_file and url:
+            raise ValidationError("Provide either audio_file or url, not both")
+            
         target_language = self._validate_language_code(target_language)
         if source_language:
             source_language = self._validate_language_code(source_language)
             
-        files = self._prepare_file_upload(audio_file, "file")
+        # Prepare request data
+        files = {}
         data = {"target_language": target_language}
+        
+        if audio_file:
+            files = self._prepare_file_upload(audio_file, "file")
+        
+        if url:
+            data["url"] = url
+            
         if source_language:
             data["source_language"] = source_language
             
@@ -44,7 +61,10 @@ class TranslationService(BaseService):
             return self._async_translate_audio(files, data, wait_for_completion, timeout)
         else:
             response = self.client.request(
-                "POST", "/api/v1/translation/translate", data=data, files=files
+                "POST", 
+                "/api/v1/translation/translate/speech",  # FIXED: Use correct speech-to-speech endpoint
+                data=data, 
+                files=files if files else None
             )
             job = Job.from_dict(response)
             
@@ -53,11 +73,35 @@ class TranslationService(BaseService):
                 return TranslationResult.from_dict(completed_job.result or completed_job.__dict__)
                 
             return job
+    
+    def translate_speech(
+        self,
+        audio_file: Optional[str] = None,
+        url: Optional[str] = None,
+        target_language: str = "en",
+        source_language: Optional[str] = None,
+        wait_for_completion: bool = False,
+        timeout: int = 900
+    ) -> Union[Job, TranslationResult]:
+        """
+        Alias for translate_audio - more descriptive method name for speech translation
+        """
+        return self.translate_audio(
+            audio_file=audio_file,
+            url=url,
+            target_language=target_language,
+            source_language=source_language,
+            wait_for_completion=wait_for_completion,
+            timeout=timeout
+        )
             
     async def _async_translate_audio(self, files, data, wait_for_completion, timeout):
         """Async version of translate_audio"""
         response = await self.client.request(
-            "POST", "/api/v1/translation/translate", data=data, files=files
+            "POST", 
+            "/api/v1/translation/translate/speech",  # FIXED: Use correct speech-to-speech endpoint
+            data=data, 
+            files=files if files else None
         )
         job = Job.from_dict(response)
         
@@ -79,3 +123,74 @@ class TranslationService(BaseService):
         """Async version of get_translation_job"""
         response = await self.client.request("GET", f"/api/v1/translation/translations/{job_id}")
         return TranslationResult.from_dict(response)
+    
+    def list_translation_jobs(
+        self,
+        skip: int = 0,
+        limit: int = 50
+    ) -> list:
+        """
+        List translation jobs
+        
+        Args:
+            skip: Number of jobs to skip (pagination offset)
+            limit: Maximum number of jobs to return (max 100)
+            
+        Returns:
+            List of translation jobs
+        """
+        params = {
+            "skip": skip,
+            "limit": min(limit, 100)  # API max is 100
+        }
+        
+        if self.async_mode:
+            return self._async_list_translation_jobs(params)
+        else:
+            response = self.client.request("GET", "/api/v1/translation/translations", params=params)
+            return [TranslationResult.from_dict(job_data) for job_data in response]
+    
+    async def _async_list_translation_jobs(self, params: dict) -> list:
+        """Async version of list_translation_jobs"""
+        response = await self.client.request("GET", "/api/v1/translation/translations", params=params)
+        return [TranslationResult.from_dict(job_data) for job_data in response]
+    
+    def retry_translation(self, job_id: int) -> Job:
+        """
+        Retry a failed translation job
+        
+        Args:
+            job_id: ID of the failed translation job to retry
+            
+        Returns:
+            New job object for the retry attempt
+        """
+        if self.async_mode:
+            return self._async_retry_translation(job_id)
+        else:
+            response = self.client.request("POST", f"/api/v1/translation/translations/{job_id}/retry")
+            return Job.from_dict(response)
+    
+    async def _async_retry_translation(self, job_id: int) -> Job:
+        """Async version of retry_translation"""
+        response = await self.client.request("POST", f"/api/v1/translation/translations/{job_id}/retry")
+        return Job.from_dict(response)
+    
+    def delete_translation_job(self, job_id: int) -> dict:
+        """
+        Delete a translation job
+        
+        Args:
+            job_id: ID of the translation job to delete
+            
+        Returns:
+            Deletion confirmation
+        """
+        if self.async_mode:
+            return self._async_delete_translation_job(job_id)
+        else:
+            return self.client.request("DELETE", f"/api/v1/translation/translations/{job_id}")
+    
+    async def _async_delete_translation_job(self, job_id: int) -> dict:
+        """Async version of delete_translation_job"""
+        return await self.client.request("DELETE", f"/api/v1/translation/translations/{job_id}")

{audiopod-1.1.0.dist-info → audiopod-1.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audiopod
-Version: 1.1.0
+Version: 1.1.1
 Summary: Professional Audio Processing API Client for Python
 Home-page: https://github.com/audiopod-ai/audiopod-python
 Author: AudioPod AI
@@ -142,17 +142,25 @@ print(f"Transcript: {transcript.transcript}")
 print(f"Detected {len(transcript.segments)} speakers")
 ```
 
-#### Audio Translation
+#### Speech-to-Speech Translation
 
 ```python
-# Translate audio to another language
-translation = client.translation.translate_audio(
+# Translate speech while preserving voice characteristics
+translation = client.translation.translate_speech(
     audio_file="path/to/english_audio.wav",
     target_language="es",  # Spanish
+    source_language="en",  # English (optional - auto-detect)
     wait_for_completion=True
 )
 
-print(f"Translated audio URL: {translation.audio_output_url}")
+print(f"Translated audio URL: {translation.translated_audio_url}")
+
+# Or translate from URL
+url_translation = client.translation.translate_speech(
+    url="https://example.com/audio.mp3",
+    target_language="fr",  # French
+    wait_for_completion=True
+)
 ```
 
 ### Async Support

{audiopod-1.1.0.dist-info → audiopod-1.1.1.dist-info}/RECORD

@@ -1,9 +1,9 @@
-audiopod/__init__.py,sha256=U12jbLmXps3-NP3yXcucGMQbr8b6VCoWAXZSitK1pp4,1790
+audiopod/__init__.py,sha256=UsB5ET6nUy1Upx8wCiB17mMErdF3RvEHfAr51-pPPGQ,1790
 audiopod/cli.py,sha256=ZYzAQ3UpoYuOEWivMwMneJUf2z8DGGYTx1Nb6yRfdVY,9339
 audiopod/client.py,sha256=67oPSInSNssJpTR00ZuYSdk9lbx5KiRnDQw8UYKNVsA,11742
 audiopod/config.py,sha256=fuGtbuES4tXdHwqQqoZa5izCH6nVfFRP06D8eK1Cg10,1683
 audiopod/exceptions.py,sha256=c3Ym2tWyRE1kemVkXDaXFcfP3h6AokhKcUcCBImwGes,2386
-audiopod/models.py,sha256=gAfQkufA_hZdYBkniFJ_EXETy9ts-wr-soUEbT7ZKFM,7827
+audiopod/models.py,sha256=R70iMqKDZfLtTB9FQ7KrFLBi-bFA5-FrS-5eMOtfK1o,8517
 audiopod/py.typed,sha256=ixa8YukDZ3kLo0WsFJRGohLMyHzbMur1ALmmASML2cs,64
 audiopod/services/__init__.py,sha256=9Ycl9VVscwwY42joBCSL67v8DrITW2T2QyuaokbpehM,653
 audiopod/services/base.py,sha256=mNbziYy2KsWWZrdHFlTl9pKLvoQUW-ZkkJuVWfCVP74,6731
@@ -14,11 +14,11 @@ audiopod/services/music.py,sha256=hDPjTSj-gAeEWBVB7PRPQrptMHJyQTz8e9p-p7yaRPI,20
 audiopod/services/speaker.py,sha256=OPSOwArfrGXVzRgciS13n1QsCJSK1PB-Mz6VgwxuHAA,1866
 audiopod/services/stem_extraction.py,sha256=3ibMFKFR25xKHpVs3WGMNriZ88sB5PriFNa_s2Bvon4,6026
 audiopod/services/transcription.py,sha256=HyH6WpGWZsggYxIvt2dhB6_5UHaigk3XwXsVgarWzcE,7565
-audiopod/services/translation.py,sha256=Gpxmom-ZSLMXBwSQlOL5PyqxQCwRYNT2IUp2ZD5QhYc,3177
+audiopod/services/translation.py,sha256=oUU82c61CeAt13lzlWx8S-9xEgYlskwX8bLMbQw2Ni8,7396
 audiopod/services/voice.py,sha256=_IHv3zU3k184kfijxr1QRBenrIpmhhPOBS96DddZ8yw,13456
-audiopod-1.1.0.dist-info/licenses/LICENSE,sha256=hqEjnOaGNbnLSBxbtbC7WQVREU2vQI8FmwecCiZlMfA,1068
-audiopod-1.1.0.dist-info/METADATA,sha256=ee2Zg4iwkglAgnk3xwNuYg11LFZbKJQeUcxgG8Z_Dw0,10931
-audiopod-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-audiopod-1.1.0.dist-info/entry_points.txt,sha256=uLcNDzXuOXnJAz9j91TDGayVjjZ7-ZiHBGDydqNUErU,47
-audiopod-1.1.0.dist-info/top_level.txt,sha256=M6yyOFFNpLdH4i1AMRqJZLRIgfpg1NvrQVmnPd8A6N8,9
-audiopod-1.1.0.dist-info/RECORD,,
+audiopod-1.1.1.dist-info/licenses/LICENSE,sha256=hqEjnOaGNbnLSBxbtbC7WQVREU2vQI8FmwecCiZlMfA,1068
+audiopod-1.1.1.dist-info/METADATA,sha256=UG_csntfzscrZTjy-2v-lCTlS7-VSEM6WEwUw26hSYc,11217
+audiopod-1.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+audiopod-1.1.1.dist-info/entry_points.txt,sha256=uLcNDzXuOXnJAz9j91TDGayVjjZ7-ZiHBGDydqNUErU,47
+audiopod-1.1.1.dist-info/top_level.txt,sha256=M6yyOFFNpLdH4i1AMRqJZLRIgfpg1NvrQVmnPd8A6N8,9
+audiopod-1.1.1.dist-info/RECORD,,