camb-sdk 1.0.0__tar.gz

camb_sdk-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Camb AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

camb_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: camb-sdk
+Version: 1.0.0
+Summary: Camb AI Python SDK for Text-to-Speech, Voice Generation, and Audio APIs
+Author-email: Camb AI <support@camb.ai>
+License: MIT
+Project-URL: Repository, https://github.com/Camb-ai/cambai-python-sdk
+Project-URL: Documentation, https://docs.camb.ai
+Keywords: AI,Dubbing,Text-to-Speech,Voice,Audio,SDK
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2
+Requires-Dist: typing-extensions>=4.7.1
+Dynamic: license-file
+
+# Camb AI Python SDK 🎙️
+
+[![PyPI version](https://img.shields.io/pypi/v/camb-ai-sdk.svg?style=flat-square)](https://pypi.org/project/camb-ai-sdk/)  
+[![License](https://img.shields.io/pypi/l/camb-ai-sdk.svg?style=flat-square)](https://github.com/your-org/camb-ai-python-sdk/blob/main/LICENSE)  
+[![Build Status](https://img.shields.io/github/actions/workflow/status/your-org/camb-ai-python-sdk/ci.yml?branch=main&style=flat-square)](https://github.com/your-org/camb-ai-python-sdk/actions)
+
+The official Python SDK for interacting with Camb AI's powerful voice and audio generation APIs. Create expressive speech, unique voices, and rich soundscapes with just a few lines of Python.
+
+---
+
+## ✨ Features
+- **Dubbing**: Dub your videos into multiple languages with voice cloning!
+- **Expressive Text-to-Speech**: Convert text into natural-sounding speech using a wide range of pre-existing voices.  
+- **Generative Voices**: Create entirely new, unique voices from text prompts and descriptions.  
+- **Soundscapes from Text**: Generate ambient audio and sound effects from textual descriptions.  
+- Access to voice cloning, translation, and more (refer to full API documentation).
+
+---
+
+## 📦 Installation
+
+Install the SDK using pip, ensure **Python 3.9+**:
+
+```bash
+pip install camb-sdk
+````
+
+Or through
+
+```bash
+pip install git+https://github.com/Camb-ai/cambai-python-sdk
+```
+
+---
+
+## 🔑 Authentication
+
+To use the Camb AI SDK, you'll need an API key. You can authenticate in either of the following ways:
+
+### 1. Pass the API key directly
+
+```python
+from cambai import CambAI
+
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+```
+
+### 2. Use an environment variable
+Set your API key as an environment variable named `CAMB_API_KEY`:
+
+   ```bash
+   export CAMB_API_KEY="your_actual_api_key_here"
+   ```
+---
+
+## 🚀 Getting Started: Examples
+
+### 1. Text-to-Speech (TTS)
+
+Convert text into spoken audio using one of Camb AI's high-quality voices.
+
+#### a) Get an Audio URL
+
+This is useful if you want to play the audio in a web application or share a link.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client (ensure API key is set)
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+try:
+    print("Generating speech and getting audio URL...")
+    audio_url = client.text_to_speech(
+        text="Hello from Camb AI! This is a test of our Text-to-Speech API.",
+        voice_id=20303  # Example voice ID, find more with client.list_voices()
+    )
+    print(f"Success! Your audio is ready at: {audio_url}")
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_speech: {e}\n")
+```
+
+#### b) Save Audio Directly to a File
+
+Generate speech and save it as an MP3 file (or other supported formats).
+
+```python
+from cambai import CambAI
+from cambai.models.output_type import OutputType 
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+file_path = "my_generated_speech.mp3"
+
+try:
+    print(f"Generating speech and saving to {file_path}...")
+
+    client.text_to_speech(
+        text="This is another test, saving directly to a file.",
+        voice_id=20303,                # Example voice ID
+        output_type=OutputType.RAW_BYTES,  # Specify raw bytes for direct saving
+        save_to_file=file_path,
+        verbose=True                   # For more detailed logging from the SDK
+    )
+    print(f"Success! Audio saved to {file_path}")
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_speech (save to file): {e}\n")
+```
+
+#### c) List Available Voices
+
+You can list available voices to find a `voice_id` that suits your needs:
+
+```python
+try:
+    voices = client.list_voices()
+    print(f"Found {len(voices)} voices:")
+    for voice in voices[:5]:  # Print first 5 as an example
+        print(f"  - ID: {voice.id}, Name: {voice.voice_name}, Gender: {voice.gender}, Language: {voice.language}")
+except ApiException as e:
+    print(f"Could not list voices: {e}")
+```
+
+---
+
+### 2. Text-to-Voice (Generative Voice)
+
+Create completely new and unique voices from a textual description of the desired voice characteristics.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+output_file = "generated_voice_output.mp3"
+
+try:
+    print("Generating a new voice and speech...")
+    # The 'text_to_voice' method returns a dict consisting of 3 sample URLs
+    result = client.text_to_voice(
+        text="Crafting a unique voice with a hint of mystery and warmth.",
+        voice_description="A smooth, baritone voice with a slight echo, perfect for storytelling.",
+        verbose=True
+    )
+    print(result)
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_voice: {e}\n")
+```
+
+---
+### 3. Text-to-Audio (Sound Generation)
+
+Generate sound effects or ambient audio from a descriptive prompt.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+output_file = "generated_sound_effect.mp3"
+
+try:
+    print(f"Generating sound effect and saving to {output_file}...")
+
+    client.text_to_audio(
+        prompt="A gentle breeze rustling through autumn leaves in a quiet forest.",
+        duration=10,       
+        save_to_file=output_file,
+        verbose=True
+    )
+    print(f"Success! Sound effect saved to {output_file}")
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_audio: {e}\n")
+```
+
+---
+### 4. End-to-End Dubbing
+
+Dub videos into different languages with voice cloning and translation capabilities.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+# Call all target languages
+print("Listing target languages...")
+target_languages = clinet.get_target_languages()
+print(f"Found {len(target_languages)} target languages:")
+for language in target_languages:
+    print(f"  - {language}")
+
+try:
+    print("Starting end-to-end dubbing process...")
+    
+    result = client.end_to_end_dubbing(
+        video_url="your_accesible_video_url",
+        source_language=cambai.Languages.NUMBER_1,  # English
+        target_languages=[cambai.Languages.NUMBER_81],  # Add more target languages as needed
+        verbose=True
+    )
+    
+    print("Dubbing completed successfully!")
+    # The result contains output_video_url, output_audio_url, and transcript information with timing and speaker details
+    print(f"Result: {result}")
+
+except ApiException as e:
+    print(f"API Exception when calling end_to_end_dubbing: {e}\n")
+```
+
+---
+
+## ⚙️ Advanced Usage & Other Features
+
+The Camb AI SDK offers a wide range of capabilities beyond these examples, including:
+
+* Voice Cloning
+* Translated TTS
+* Audio Dubbing
+* Transcription
+* And more!
+
+Please refer to the [**Official Camb AI API Documentation**](https://docs.camb.ai/introduction) for a comprehensive list of features and advanced usage patterns.
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+
+
+

camb_sdk-1.0.0/README.md

@@ -0,0 +1,248 @@
+# Camb AI Python SDK 🎙️
+
+[![PyPI version](https://img.shields.io/pypi/v/camb-ai-sdk.svg?style=flat-square)](https://pypi.org/project/camb-ai-sdk/)  
+[![License](https://img.shields.io/pypi/l/camb-ai-sdk.svg?style=flat-square)](https://github.com/your-org/camb-ai-python-sdk/blob/main/LICENSE)  
+[![Build Status](https://img.shields.io/github/actions/workflow/status/your-org/camb-ai-python-sdk/ci.yml?branch=main&style=flat-square)](https://github.com/your-org/camb-ai-python-sdk/actions)
+
+The official Python SDK for interacting with Camb AI's powerful voice and audio generation APIs. Create expressive speech, unique voices, and rich soundscapes with just a few lines of Python.
+
+---
+
+## ✨ Features
+- **Dubbing**: Dub your videos into multiple languages with voice cloning!
+- **Expressive Text-to-Speech**: Convert text into natural-sounding speech using a wide range of pre-existing voices.  
+- **Generative Voices**: Create entirely new, unique voices from text prompts and descriptions.  
+- **Soundscapes from Text**: Generate ambient audio and sound effects from textual descriptions.  
+- Access to voice cloning, translation, and more (refer to full API documentation).
+
+---
+
+## 📦 Installation
+
+Install the SDK using pip, ensure **Python 3.9+**:
+
+```bash
+pip install camb-sdk
+````
+
+Or through
+
+```bash
+pip install git+https://github.com/Camb-ai/cambai-python-sdk
+```
+
+---
+
+## 🔑 Authentication
+
+To use the Camb AI SDK, you'll need an API key. You can authenticate in either of the following ways:
+
+### 1. Pass the API key directly
+
+```python
+from cambai import CambAI
+
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+```
+
+### 2. Use an environment variable
+Set your API key as an environment variable named `CAMB_API_KEY`:
+
+   ```bash
+   export CAMB_API_KEY="your_actual_api_key_here"
+   ```
+---
+
+## 🚀 Getting Started: Examples
+
+### 1. Text-to-Speech (TTS)
+
+Convert text into spoken audio using one of Camb AI's high-quality voices.
+
+#### a) Get an Audio URL
+
+This is useful if you want to play the audio in a web application or share a link.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client (ensure API key is set)
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+try:
+    print("Generating speech and getting audio URL...")
+    audio_url = client.text_to_speech(
+        text="Hello from Camb AI! This is a test of our Text-to-Speech API.",
+        voice_id=20303  # Example voice ID, find more with client.list_voices()
+    )
+    print(f"Success! Your audio is ready at: {audio_url}")
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_speech: {e}\n")
+```
+
+#### b) Save Audio Directly to a File
+
+Generate speech and save it as an MP3 file (or other supported formats).
+
+```python
+from cambai import CambAI
+from cambai.models.output_type import OutputType 
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+file_path = "my_generated_speech.mp3"
+
+try:
+    print(f"Generating speech and saving to {file_path}...")
+
+    client.text_to_speech(
+        text="This is another test, saving directly to a file.",
+        voice_id=20303,                # Example voice ID
+        output_type=OutputType.RAW_BYTES,  # Specify raw bytes for direct saving
+        save_to_file=file_path,
+        verbose=True                   # For more detailed logging from the SDK
+    )
+    print(f"Success! Audio saved to {file_path}")
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_speech (save to file): {e}\n")
+```
+
+#### c) List Available Voices
+
+You can list available voices to find a `voice_id` that suits your needs:
+
+```python
+try:
+    voices = client.list_voices()
+    print(f"Found {len(voices)} voices:")
+    for voice in voices[:5]:  # Print first 5 as an example
+        print(f"  - ID: {voice.id}, Name: {voice.voice_name}, Gender: {voice.gender}, Language: {voice.language}")
+except ApiException as e:
+    print(f"Could not list voices: {e}")
+```
+
+---
+
+### 2. Text-to-Voice (Generative Voice)
+
+Create completely new and unique voices from a textual description of the desired voice characteristics.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+output_file = "generated_voice_output.mp3"
+
+try:
+    print("Generating a new voice and speech...")
+    # The 'text_to_voice' method returns a dict consisting of 3 sample URLs
+    result = client.text_to_voice(
+        text="Crafting a unique voice with a hint of mystery and warmth.",
+        voice_description="A smooth, baritone voice with a slight echo, perfect for storytelling.",
+        verbose=True
+    )
+    print(result)
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_voice: {e}\n")
+```
+
+---
+### 3. Text-to-Audio (Sound Generation)
+
+Generate sound effects or ambient audio from a descriptive prompt.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+output_file = "generated_sound_effect.mp3"
+
+try:
+    print(f"Generating sound effect and saving to {output_file}...")
+
+    client.text_to_audio(
+        prompt="A gentle breeze rustling through autumn leaves in a quiet forest.",
+        duration=10,       
+        save_to_file=output_file,
+        verbose=True
+    )
+    print(f"Success! Sound effect saved to {output_file}")
+
+except ApiException as e:
+    print(f"API Exception when calling text_to_audio: {e}\n")
+```
+
+---
+### 4. End-to-End Dubbing
+
+Dub videos into different languages with voice cloning and translation capabilities.
+
+```python
+from cambai import CambAI
+from cambai.rest import ApiException
+
+# Initialize client
+client = CambAI(api_key="YOUR_CAMB_API_KEY")
+
+# Call all target languages
+print("Listing target languages...")
+target_languages = clinet.get_target_languages()
+print(f"Found {len(target_languages)} target languages:")
+for language in target_languages:
+    print(f"  - {language}")
+
+try:
+    print("Starting end-to-end dubbing process...")
+    
+    result = client.end_to_end_dubbing(
+        video_url="your_accesible_video_url",
+        source_language=cambai.Languages.NUMBER_1,  # English
+        target_languages=[cambai.Languages.NUMBER_81],  # Add more target languages as needed
+        verbose=True
+    )
+    
+    print("Dubbing completed successfully!")
+    # The result contains output_video_url, output_audio_url, and transcript information with timing and speaker details
+    print(f"Result: {result}")
+
+except ApiException as e:
+    print(f"API Exception when calling end_to_end_dubbing: {e}\n")
+```
+
+---
+
+## ⚙️ Advanced Usage & Other Features
+
+The Camb AI SDK offers a wide range of capabilities beyond these examples, including:
+
+* Voice Cloning
+* Translated TTS
+* Audio Dubbing
+* Transcription
+* And more!
+
+Please refer to the [**Official Camb AI API Documentation**](https://docs.camb.ai/introduction) for a comprehensive list of features and advanced usage patterns.
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+
+
+