sdk-python/src/speechify/models/client.py at main · Speechify-AI/sdk-python · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
# This file was auto-generated by Fern from our API Definition.

import typing

from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ..core.request_options import RequestOptions
from ..types.models_response import ModelsResponse
from .raw_client import AsyncRawModelsClient, RawModelsClient


class ModelsClient:
    def __init__(self, *, client_wrapper: SyncClientWrapper):
        self._raw_client = RawModelsClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> RawModelsClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        RawModelsClient
        """
        return self._raw_client

    def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ModelsResponse:
        """
        List the text-to-speech models available for synthesis. Drive a model
        picker from this response, then pass a model `id` as the `model`
        parameter to POST /v1/audio/speech or /v1/audio/stream. The response
        marks the default model (used when a request omits `model`), the
        routes each model may be passed to, and which voices it accepts.
        Multi-speaker models arrive in a separate `dialogue_models` array
        because they are valid only on POST /v1/audio/dialogue. Returns
        the full set in a single response: the model catalog is static
        platform reference data, so it is intentionally not paginated.

        Parameters
        ----------
        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ModelsResponse
            The available text-to-speech models.

        Examples
        --------
        from speechify import Speechify

        client = Speechify(
            "2026-09-13",
            token="YOUR_TOKEN",
        )
        client.models.list()
        """
        _response = self._raw_client.list(request_options=request_options)
        return _response.data


class AsyncModelsClient:
    def __init__(self, *, client_wrapper: AsyncClientWrapper):
        self._raw_client = AsyncRawModelsClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> AsyncRawModelsClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        AsyncRawModelsClient
        """
        return self._raw_client

    async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ModelsResponse:
        """
        List the text-to-speech models available for synthesis. Drive a model
        picker from this response, then pass a model `id` as the `model`
        parameter to POST /v1/audio/speech or /v1/audio/stream. The response
        marks the default model (used when a request omits `model`), the
        routes each model may be passed to, and which voices it accepts.
        Multi-speaker models arrive in a separate `dialogue_models` array
        because they are valid only on POST /v1/audio/dialogue. Returns
        the full set in a single response: the model catalog is static
        platform reference data, so it is intentionally not paginated.

        Parameters
        ----------
        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ModelsResponse
            The available text-to-speech models.

        Examples
        --------
        import asyncio

        from speechify import AsyncSpeechify

        client = AsyncSpeechify(
            "2026-09-13",
            token="YOUR_TOKEN",
        )


        async def main() -> None:
            await client.models.list()


        asyncio.run(main())
        """
        _response = await self._raw_client.list(request_options=request_options)
        return _response.data