cartesia 1.0.7__py2.py3-none-any.whl → 1.0.9__py2.py3-none-any.whl

cartesia/__init__.py

@@ -1,3 +1,3 @@
-from cartesia.client import Cartesia, AsyncCartesia
+from cartesia.client import AsyncCartesia, Cartesia
 
 __all__ = ["Cartesia", "AsyncCartesia"]

cartesia/_types.py

@@ -1,4 +1,5 @@
 from typing import List, TypedDict
+
 from cartesia.utils.deprecated import deprecated
 
 

cartesia/client.py

@@ -1,41 +1,47 @@
 import asyncio
 import base64
-from collections import defaultdict
 import json
+import logging
 import os
 import uuid
+from collections import defaultdict
 from types import TracebackType
 from typing import (
     Any,
     AsyncGenerator,
-    Iterator,
+    Callable,
     Dict,
     Generator,
+    Iterator,
     List,
     Optional,
+    Set,
     Tuple,
     Union,
-    Callable,
-    Set,
 )
 
 import aiohttp
 import httpx
-import logging
 import requests
-from websockets.sync.client import connect
-from iterators import TimeoutIterator
 
-from cartesia.utils.retry import retry_on_connection_error, retry_on_connection_error_async
+try:
+    from websockets.sync.client import connect
+
+    IS_WEBSOCKET_SYNC_AVAILABLE = True
+except ImportError:
+    IS_WEBSOCKET_SYNC_AVAILABLE = False
+
 from cartesia._types import (
+    DeprecatedOutputFormatMapping,
     EventType,
     OutputFormat,
     OutputFormatMapping,
-    DeprecatedOutputFormatMapping,
     VoiceControls,
     VoiceMetadata,
 )
-
+from cartesia.utils.retry import retry_on_connection_error, retry_on_connection_error_async
+from iterators import TimeoutIterator
+from websockets.sync.client import connect
 
 DEFAULT_MODEL_ID = "sonic-english"  # latest default model
 MULTILINGUAL_MODEL_ID = "sonic-multilingual"  # latest multilingual model
@@ -207,38 +213,27 @@ class Voices(Resource):
 
         return response.json()
 
-    def clone(self, filepath: Optional[str] = None, link: Optional[str] = None) -> List[float]:
-        """Clone a voice from a clip or a URL.
+    def clone(self, filepath: Optional[str] = None, enhance: str = True) -> List[float]:
+        """Clone a voice from a clip.
 
         Args:
             filepath: The path to the clip file.
-            link: The URL to the clip
+            enhance: Whether to enhance the clip before cloning the voice (highly recommended). Defaults to True.
 
         Returns:
             The embedding of the cloned voice as a list of floats.
         """
-        # TODO: Python has a bytes object, use that instead of a filepath
-        if not filepath and not link:
-            raise ValueError("At least one of 'filepath' or 'link' must be specified.")
-        if filepath and link:
-            raise ValueError("Only one of 'filepath' or 'link' should be specified.")
-        if filepath:
-            url = f"{self._http_url()}/voices/clone/clip"
-            with open(filepath, "rb") as file:
-                files = {"clip": file}
-                headers = self.headers.copy()
-                headers.pop("Content-Type", None)
-                response = httpx.post(url, headers=headers, files=files, timeout=self.timeout)
-                if not response.is_success:
-                    raise ValueError(f"Failed to clone voice from clip. Error: {response.text}")
-        elif link:
-            url = f"{self._http_url()}/voices/clone/url"
-            params = {"link": link}
+        if not filepath:
+            raise ValueError("Filepath must be specified.")
+        url = f"{self._http_url()}/voices/clone/clip"
+        with open(filepath, "rb") as file:
+            files = {"clip": file}
+            files["enhance"] = str(enhance).lower()
             headers = self.headers.copy()
-            headers.pop("Content-Type")  # The content type header is not required for URLs
-            response = httpx.post(url, headers=self.headers, params=params, timeout=self.timeout)
+            headers.pop("Content-Type", None)
+            response = httpx.post(url, headers=headers, files=files, timeout=self.timeout)
             if not response.is_success:
-                raise ValueError(f"Failed to clone voice from URL. Error: {response.text}")
+                raise ValueError(f"Failed to clone voice from clip. Error: {response.text}")
 
         return response.json()["embedding"]
 
@@ -469,6 +464,10 @@ class _WebSocket:
         Raises:
             RuntimeError: If the connection to the WebSocket fails.
         """
+        if not IS_WEBSOCKET_SYNC_AVAILABLE:
+            raise ImportError(
+                "The synchronous WebSocket client is not available. Please ensure that you have 'websockets>=12.0' or compatible version installed."
+            )
         if self.websocket is None or self._is_websocket_closed():
             route = "tts/websocket"
             try:

cartesia/utils/retry.py

@@ -1,9 +1,9 @@
-import time
-
-from aiohttp.client_exceptions import ServerDisconnectedError
 import asyncio
+import time
 from functools import wraps
 from http.client import RemoteDisconnected
+
+from aiohttp.client_exceptions import ServerDisconnectedError
 from httpx import TimeoutException
 from requests.exceptions import ConnectionError
 

cartesia/version.py

@@ -1 +1 @@
-__version__ = "1.0.7"
+__version__ = "1.0.9"

{cartesia-1.0.7.dist-info → cartesia-1.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cartesia
-Version: 1.0.7
+Version: 1.0.9
 Summary: The official Python library for the Cartesia API.
 Home-page: 
 Author: Cartesia, Inc.
@@ -43,6 +43,22 @@ The official Cartesia Python library which provides convenient access to the Car
 > [!IMPORTANT]
 > The client library introduces breaking changes in v1.0.0, which was released on June 24th 2024. See the [release notes](https://github.com/cartesia-ai/cartesia-python/releases/tag/v1.0.0) and [migration guide](https://github.com/cartesia-ai/cartesia-python/discussions/44). Reach out to us on [Discord](https://discord.gg/ZVxavqHB9X) for any support requests!
 
+- [Cartesia Python API Library](#cartesia-python-api-library)
+  - [Documentation](#documentation)
+  - [Installation](#installation)
+  - [Voices](#voices)
+  - [Text-to-Speech](#text-to-speech)
+    - [Server-Sent Events (SSE)](#server-sent-events-sse)
+    - [WebSocket](#websocket)
+      - [Conditioning speech on previous generations using WebSocket](#conditioning-speech-on-previous-generations-using-websocket)
+    - [Generating timestamps using WebSocket](#generating-timestamps-using-websocket)
+    - [Multilingual Text-to-Speech \[Alpha\]](#multilingual-text-to-speech-alpha)
+    - [Speed and Emotion Control \[Experimental\]](#speed-and-emotion-control-experimental)
+    - [Jupyter Notebook Usage](#jupyter-notebook-usage)
+    - [Utility methods](#utility-methods)
+      - [Output Formats](#output-formats)
+
+
 ## Documentation
 
 Our complete API documentation can be found [on docs.cartesia.ai](https://docs.cartesia.ai).
@@ -268,7 +284,7 @@ async def send_transcripts(ctx):
 
     # You can check out our models at https://docs.cartesia.ai/getting-started/available-models
     model_id = "sonic-english"
-    
+
     # You can find the supported `output_format`s at https://docs.cartesia.ai/api-reference/endpoints/stream-speech-server-sent-events
     output_format = {
         "container": "raw",
@@ -284,7 +300,7 @@ async def send_transcripts(ctx):
         "As they near Eggman's lair, our heroes charge their abilities for an epic boss battle. ",
         "Get ready to spin, jump, and sound-blast your way to victory in this high-octane crossover!"
     ]
-    
+
     for transcript in transcripts:
         # Send text inputs as they become available
         await ctx.send(
@@ -296,7 +312,7 @@ async def send_transcripts(ctx):
         )
 
     # Indicate that no more inputs will be sent. Otherwise, the context will close after 5 seconds of inactivity.
-    await ctx.no_more_inputs() 
+    await ctx.no_more_inputs()
 
 async def receive_and_play_audio(ctx):
     p = pyaudio.PyAudio()
@@ -402,7 +418,7 @@ output_stream = ctx.send(
     voice_id=voice_id,
     output_format=output_format,
 )
-    
+
 for output in output_stream:
     buffer = output["audio"]
 

cartesia-1.0.9.dist-info/RECORD

@@ -0,0 +1,12 @@
+cartesia/__init__.py,sha256=E4w7psbAwx8X6Iri3W8jGeo11gIlhr3mSU33zChipmI,93
+cartesia/_types.py,sha256=rISSd6sfne6awLDoonqA9KlE0fVQZdIaGjxsvHTFBlE,4407
+cartesia/client.py,sha256=m6eVIr5AL0Xuwh7707jXMNIxx1CAseW03xvgbbuNNsU,51613
+cartesia/version.py,sha256=q2ACMkQx0Hm5xKo2YKJFBE7rTruciTSIN6AvWWL9nB8,22
+cartesia/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cartesia/utils/deprecated.py,sha256=2cXvGtrxhPeUZA5LWy2n_U5OFLDv7SHeFtzqhjSJGyk,1674
+cartesia/utils/retry.py,sha256=O6fyVWpH9Su8c0Fwupl57xMt6JrwJ52txBwP3faUL7k,3339
+cartesia-1.0.9.dist-info/LICENSE.md,sha256=PT2YG5wEtEX1TNDn5sXkUXqbn-neyr7cZenTxd40ql4,1074
+cartesia-1.0.9.dist-info/METADATA,sha256=C2htRYPEJuve-EhP1R7dazFxnBSJrCTnESIIDBx5vBk,21137
+cartesia-1.0.9.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
+cartesia-1.0.9.dist-info/top_level.txt,sha256=rTX4HnnCegMxl1FK9czpVC7GAvf3SwDzPG65qP-BS4w,9
+cartesia-1.0.9.dist-info/RECORD,,

cartesia-1.0.7.dist-info/RECORD

@@ -1,12 +0,0 @@
-cartesia/__init__.py,sha256=jMIf2O7dTGxvTA5AfXtmh1H_EGfMtQseR5wXrjNRbLs,93
-cartesia/_types.py,sha256=Lcp4GOot5UfI0EveDi2QdNALMo1rK4PwUrtMvW5P6vY,4406
-cartesia/client.py,sha256=1T_HboqHZO6wjUDYpuWI7igV-QF_cRL4DY7v4NDzApo,51871
-cartesia/version.py,sha256=BW7SWRpHoxuOQZ67pS20yog2LWYl-nK7-BEFBNrHGgA,22
-cartesia/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cartesia/utils/deprecated.py,sha256=2cXvGtrxhPeUZA5LWy2n_U5OFLDv7SHeFtzqhjSJGyk,1674
-cartesia/utils/retry.py,sha256=nuwWRfu3MOVTxIQMLjYf6WLaxSlnu_GdE3QjTV0zisQ,3339
-cartesia-1.0.7.dist-info/LICENSE.md,sha256=PT2YG5wEtEX1TNDn5sXkUXqbn-neyr7cZenTxd40ql4,1074
-cartesia-1.0.7.dist-info/METADATA,sha256=vvU7-K0raiw4hmotlST5wi6uSnGiXjMpHxd2CIzvbMc,20336
-cartesia-1.0.7.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
-cartesia-1.0.7.dist-info/top_level.txt,sha256=rTX4HnnCegMxl1FK9czpVC7GAvf3SwDzPG65qP-BS4w,9
-cartesia-1.0.7.dist-info/RECORD,,