cartesia 1.4.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

cartesia/voices/requests/__init__.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .create_voice_request import CreateVoiceRequestParams
+from .embedding_response import EmbeddingResponseParams
+from .embedding_specifier import EmbeddingSpecifierParams
+from .get_voices_response import GetVoicesResponseParams
+from .id_specifier import IdSpecifierParams
+from .localize_dialect import LocalizeDialectParams
+from .localize_voice_request import LocalizeVoiceRequestParams
+from .mix_voice_specifier import MixVoiceSpecifierParams
+from .mix_voices_request import MixVoicesRequestParams
+from .update_voice_request import UpdateVoiceRequestParams
+from .voice import VoiceParams
+from .voice_metadata import VoiceMetadataParams
+
+__all__ = [
+    "CreateVoiceRequestParams",
+    "EmbeddingResponseParams",
+    "EmbeddingSpecifierParams",
+    "GetVoicesResponseParams",
+    "IdSpecifierParams",
+    "LocalizeDialectParams",
+    "LocalizeVoiceRequestParams",
+    "MixVoiceSpecifierParams",
+    "MixVoicesRequestParams",
+    "UpdateVoiceRequestParams",
+    "VoiceMetadataParams",
+    "VoiceParams",
+]

cartesia/voices/requests/create_voice_request.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ...embedding.types.embedding import Embedding
+import typing_extensions
+from ...tts.types.supported_language import SupportedLanguage
+from ..types.base_voice_id import BaseVoiceId
+
+
+class CreateVoiceRequestParams(typing_extensions.TypedDict):
+    name: str
+    """
+    The name of the voice.
+    """
+
+    description: str
+    """
+    The description of the voice.
+    """
+
+    embedding: Embedding
+    language: typing_extensions.NotRequired[SupportedLanguage]
+    base_voice_id: typing_extensions.NotRequired[BaseVoiceId]

cartesia/voices/requests/embedding_response.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ...embedding.types.embedding import Embedding
+
+
+class EmbeddingResponseParams(typing_extensions.TypedDict):
+    embedding: Embedding

cartesia/voices/requests/embedding_specifier.py

@@ -0,0 +1,10 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ...embedding.types.embedding import Embedding
+from ..types.weight import Weight
+
+
+class EmbeddingSpecifierParams(typing_extensions.TypedDict):
+    embedding: Embedding
+    weight: Weight

cartesia/voices/requests/get_voices_response.py

@@ -0,0 +1,24 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+import typing
+from .voice import VoiceParams
+import typing_extensions
+from ..types.voice_id import VoiceId
+
+
+class GetVoicesResponseParams(typing_extensions.TypedDict):
+    data: typing.Sequence[VoiceParams]
+    """
+    The paginated list of Voices.
+    """
+
+    has_more: bool
+    """
+    Whether there are more Voices to fetch (using `starting_after=id`, where id is the ID of the last Voice in the current response).
+    """
+
+    next_page: typing_extensions.NotRequired[VoiceId]
+    """
+    (Deprecated - use the id of the last Voice in the current response instead.) An ID that can be passed as `starting_after` to get the next page of Voices.
+    """

cartesia/voices/requests/id_specifier.py

@@ -0,0 +1,10 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ..types.voice_id import VoiceId
+from ..types.weight import Weight
+
+
+class IdSpecifierParams(typing_extensions.TypedDict):
+    id: VoiceId
+    weight: Weight

cartesia/voices/requests/localize_dialect.py

@@ -0,0 +1,11 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ..types.localize_english_dialect import LocalizeEnglishDialect
+from ..types.localize_spanish_dialect import LocalizeSpanishDialect
+from ..types.localize_portuguese_dialect import LocalizePortugueseDialect
+from ..types.localize_french_dialect import LocalizeFrenchDialect
+
+LocalizeDialectParams = typing.Union[
+    LocalizeEnglishDialect, LocalizeSpanishDialect, LocalizePortugueseDialect, LocalizeFrenchDialect
+]

cartesia/voices/requests/localize_voice_request.py

@@ -0,0 +1,28 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ..types.localize_target_language import LocalizeTargetLanguage
+from ..types.gender import Gender
+import typing_extensions
+from .localize_dialect import LocalizeDialectParams
+
+
+class LocalizeVoiceRequestParams(typing_extensions.TypedDict):
+    voice_id: str
+    """
+    The ID of the voice to localize.
+    """
+
+    name: str
+    """
+    The name of the new localized voice.
+    """
+
+    description: str
+    """
+    The description of the new localized voice.
+    """
+
+    language: LocalizeTargetLanguage
+    original_speaker_gender: Gender
+    dialect: typing_extensions.NotRequired[LocalizeDialectParams]

cartesia/voices/requests/mix_voice_specifier.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .id_specifier import IdSpecifierParams
+from .embedding_specifier import EmbeddingSpecifierParams
+
+MixVoiceSpecifierParams = typing.Union[IdSpecifierParams, EmbeddingSpecifierParams]

cartesia/voices/requests/mix_voices_request.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+import typing
+from .mix_voice_specifier import MixVoiceSpecifierParams
+
+
+class MixVoicesRequestParams(typing_extensions.TypedDict):
+    voices: typing.Sequence[MixVoiceSpecifierParams]

cartesia/voices/requests/update_voice_request.py

@@ -0,0 +1,15 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+
+
+class UpdateVoiceRequestParams(typing_extensions.TypedDict):
+    name: str
+    """
+    The name of the voice.
+    """
+
+    description: str
+    """
+    The description of the voice.
+    """

cartesia/voices/requests/voice.py

@@ -0,0 +1,43 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ..types.voice_id import VoiceId
+import datetime as dt
+import typing_extensions
+from ...embedding.types.embedding import Embedding
+from ...tts.types.supported_language import SupportedLanguage
+
+
+class VoiceParams(typing_extensions.TypedDict):
+    id: VoiceId
+    is_owner: bool
+    """
+    Whether the current user is the owner of the voice.
+    """
+
+    name: str
+    """
+    The name of the voice.
+    """
+
+    description: str
+    """
+    The description of the voice.
+    """
+
+    created_at: dt.datetime
+    """
+    The date and time the voice was created.
+    """
+
+    embedding: typing_extensions.NotRequired[Embedding]
+    """
+    The vector embedding of the voice. Only included when `expand` includes `embedding`.
+    """
+
+    is_starred: typing_extensions.NotRequired[bool]
+    """
+    Whether the current user has starred the voice. Only included when `expand` includes `is_starred`.
+    """
+
+    language: SupportedLanguage

cartesia/voices/requests/voice_metadata.py

@@ -0,0 +1,36 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing_extensions
+from ..types.voice_id import VoiceId
+import datetime as dt
+from ...tts.types.supported_language import SupportedLanguage
+
+
+class VoiceMetadataParams(typing_extensions.TypedDict):
+    id: VoiceId
+    user_id: str
+    """
+    The ID of the user who owns the voice.
+    """
+
+    is_public: bool
+    """
+    Whether the voice is publicly accessible.
+    """
+
+    name: str
+    """
+    The name of the voice.
+    """
+
+    description: str
+    """
+    The description of the voice.
+    """
+
+    created_at: dt.datetime
+    """
+    The date and time the voice was created.
+    """
+
+    language: SupportedLanguage

cartesia/voices/types/__init__.py

@@ -0,0 +1,53 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .base_voice_id import BaseVoiceId
+from .clone_mode import CloneMode
+from .create_voice_request import CreateVoiceRequest
+from .embedding_response import EmbeddingResponse
+from .embedding_specifier import EmbeddingSpecifier
+from .gender import Gender
+from .gender_presentation import GenderPresentation
+from .get_voices_response import GetVoicesResponse
+from .id_specifier import IdSpecifier
+from .localize_dialect import LocalizeDialect
+from .localize_english_dialect import LocalizeEnglishDialect
+from .localize_french_dialect import LocalizeFrenchDialect
+from .localize_portuguese_dialect import LocalizePortugueseDialect
+from .localize_spanish_dialect import LocalizeSpanishDialect
+from .localize_target_language import LocalizeTargetLanguage
+from .localize_voice_request import LocalizeVoiceRequest
+from .mix_voice_specifier import MixVoiceSpecifier
+from .mix_voices_request import MixVoicesRequest
+from .update_voice_request import UpdateVoiceRequest
+from .voice import Voice
+from .voice_expand_options import VoiceExpandOptions
+from .voice_id import VoiceId
+from .voice_metadata import VoiceMetadata
+from .weight import Weight
+
+__all__ = [
+    "BaseVoiceId",
+    "CloneMode",
+    "CreateVoiceRequest",
+    "EmbeddingResponse",
+    "EmbeddingSpecifier",
+    "Gender",
+    "GenderPresentation",
+    "GetVoicesResponse",
+    "IdSpecifier",
+    "LocalizeDialect",
+    "LocalizeEnglishDialect",
+    "LocalizeFrenchDialect",
+    "LocalizePortugueseDialect",
+    "LocalizeSpanishDialect",
+    "LocalizeTargetLanguage",
+    "LocalizeVoiceRequest",
+    "MixVoiceSpecifier",
+    "MixVoicesRequest",
+    "UpdateVoiceRequest",
+    "Voice",
+    "VoiceExpandOptions",
+    "VoiceId",
+    "VoiceMetadata",
+    "Weight",
+]

cartesia/voices/types/base_voice_id.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .voice_id import VoiceId
+
+BaseVoiceId = VoiceId

cartesia/voices/types/clone_mode.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+CloneMode = typing.Union[typing.Literal["similarity", "stability"], typing.Any]

cartesia/voices/types/create_voice_request.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+import pydantic
+from ...embedding.types.embedding import Embedding
+import typing
+from ...tts.types.supported_language import SupportedLanguage
+from .base_voice_id import BaseVoiceId
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class CreateVoiceRequest(UniversalBaseModel):
+    name: str = pydantic.Field()
+    """
+    The name of the voice.
+    """
+
+    description: str = pydantic.Field()
+    """
+    The description of the voice.
+    """
+
+    embedding: Embedding
+    language: typing.Optional[SupportedLanguage] = None
+    base_voice_id: typing.Optional[BaseVoiceId] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/embedding_response.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+from ...embedding.types.embedding import Embedding
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class EmbeddingResponse(UniversalBaseModel):
+    embedding: Embedding
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/embedding_specifier.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+from ...embedding.types.embedding import Embedding
+from .weight import Weight
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class EmbeddingSpecifier(UniversalBaseModel):
+    embedding: Embedding
+    weight: Weight
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/gender.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+Gender = typing.Union[typing.Literal["male", "female"], typing.Any]

cartesia/voices/types/gender_presentation.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+GenderPresentation = typing.Union[typing.Literal["masculine", "feminine", "gender_neutral"], typing.Any]

cartesia/voices/types/get_voices_response.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+import typing
+from .voice import Voice
+import pydantic
+from .voice_id import VoiceId
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class GetVoicesResponse(UniversalBaseModel):
+    data: typing.List[Voice] = pydantic.Field()
+    """
+    The paginated list of Voices.
+    """
+
+    has_more: bool = pydantic.Field()
+    """
+    Whether there are more Voices to fetch (using `starting_after=id`, where id is the ID of the last Voice in the current response).
+    """
+
+    next_page: typing.Optional[VoiceId] = pydantic.Field(default=None)
+    """
+    (Deprecated - use the id of the last Voice in the current response instead.) An ID that can be passed as `starting_after` to get the next page of Voices.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/id_specifier.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+from .voice_id import VoiceId
+from .weight import Weight
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class IdSpecifier(UniversalBaseModel):
+    id: VoiceId
+    weight: Weight
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/localize_dialect.py

@@ -0,0 +1,11 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .localize_english_dialect import LocalizeEnglishDialect
+from .localize_spanish_dialect import LocalizeSpanishDialect
+from .localize_portuguese_dialect import LocalizePortugueseDialect
+from .localize_french_dialect import LocalizeFrenchDialect
+
+LocalizeDialect = typing.Union[
+    LocalizeEnglishDialect, LocalizeSpanishDialect, LocalizePortugueseDialect, LocalizeFrenchDialect
+]

cartesia/voices/types/localize_english_dialect.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+LocalizeEnglishDialect = typing.Union[typing.Literal["au", "in", "so", "uk", "us"], typing.Any]

cartesia/voices/types/localize_french_dialect.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+LocalizeFrenchDialect = typing.Union[typing.Literal["eu", "ca"], typing.Any]

cartesia/voices/types/localize_portuguese_dialect.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+LocalizePortugueseDialect = typing.Union[typing.Literal["br", "eu"], typing.Any]

cartesia/voices/types/localize_spanish_dialect.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+LocalizeSpanishDialect = typing.Union[typing.Literal["mx", "pe"], typing.Any]

cartesia/voices/types/localize_target_language.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+LocalizeTargetLanguage = typing.Union[
+    typing.Literal["en", "de", "es", "fr", "ja", "pt", "zh", "hi", "it", "ko", "nl", "pl", "ru", "sv", "tr"], typing.Any
+]

cartesia/voices/types/localize_voice_request.py

@@ -0,0 +1,39 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+import pydantic
+from .localize_target_language import LocalizeTargetLanguage
+from .gender import Gender
+import typing
+from .localize_dialect import LocalizeDialect
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LocalizeVoiceRequest(UniversalBaseModel):
+    voice_id: str = pydantic.Field()
+    """
+    The ID of the voice to localize.
+    """
+
+    name: str = pydantic.Field()
+    """
+    The name of the new localized voice.
+    """
+
+    description: str = pydantic.Field()
+    """
+    The description of the new localized voice.
+    """
+
+    language: LocalizeTargetLanguage
+    original_speaker_gender: Gender
+    dialect: typing.Optional[LocalizeDialect] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/mix_voice_specifier.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .id_specifier import IdSpecifier
+from .embedding_specifier import EmbeddingSpecifier
+
+MixVoiceSpecifier = typing.Union[IdSpecifier, EmbeddingSpecifier]

cartesia/voices/types/mix_voices_request.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+import typing
+from .mix_voice_specifier import MixVoiceSpecifier
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class MixVoicesRequest(UniversalBaseModel):
+    voices: typing.List[MixVoiceSpecifier]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

cartesia/voices/types/update_voice_request.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.pydantic_utilities import UniversalBaseModel
+import pydantic
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+
+
+class UpdateVoiceRequest(UniversalBaseModel):
+    name: str = pydantic.Field()
+    """
+    The name of the voice.
+    """
+
+    description: str = pydantic.Field()
+    """
+    The description of the voice.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow