OpenAI TTS

OpenAITTSModel

基础类: TTSModel

OpenAI 的文本转语音模型。

源代码位于 src/agents/voice/models/openai_tts.py

class OpenAITTSModel(TTSModel):
    """A text-to-speech model for OpenAI."""

    def __init__(
        self,
        model: str,
        openai_client: AsyncOpenAI,
    ):
        """Create a new OpenAI text-to-speech model.

        Args:
            model: The name of the model to use.
            openai_client: The OpenAI client to use.
        """
        self.model = model
        self._client = openai_client

    @property
    def model_name(self) -> str:
        return self.model

    async def run(self, text: str, settings: TTSModelSettings) -> AsyncIterator[bytes]:
        """Run the text-to-speech model.

        Args:
            text: The text to convert to speech.
            settings: The settings to use for the text-to-speech model.

        Returns:
            An iterator of audio chunks.
        """
        response = self._client.audio.speech.with_streaming_response.create(
            model=self.model,
            voice=settings.voice or DEFAULT_VOICE,
            input=text,
            response_format="pcm",
            extra_body={
                "instructions": settings.instructions,
            },
        )

        async with response as stream:
            async for chunk in stream.iter_bytes(chunk_size=1024):
                yield chunk

__init__

__init__(model: str, openai_client: AsyncOpenAI)

创建一个新的 OpenAI 文本转语音模型。

参数

名称	类型	描述	默认
model	str	要使用的模型名称。	required
openai_client	AsyncOpenAI	要使用的 OpenAI 客户端。	required

源代码位于 src/agents/voice/models/openai_tts.py

def __init__(
    self,
    model: str,
    openai_client: AsyncOpenAI,
):
    """Create a new OpenAI text-to-speech model.

    Args:
        model: The name of the model to use.
        openai_client: The OpenAI client to use.
    """
    self.model = model
    self._client = openai_client

run async

run(
    text: str, settings: TTSModelSettings
) -> AsyncIterator[bytes]

运行文本转语音模型。

参数

名称	类型	描述	默认
文本	str	要转换为语音的文本。	required
settings	TTSModelSettings	用于文本转语音模型的设置。	required

返回值

类型	描述
AsyncIterator[bytes]	音频块的迭代器。

源代码位于 src/agents/voice/models/openai_tts.py

async def run(self, text: str, settings: TTSModelSettings) -> AsyncIterator[bytes]:
    """Run the text-to-speech model.

    Args:
        text: The text to convert to speech.
        settings: The settings to use for the text-to-speech model.

    Returns:
        An iterator of audio chunks.
    """
    response = self._client.audio.speech.with_streaming_response.create(
        model=self.model,
        voice=settings.voice or DEFAULT_VOICE,
        input=text,
        response_format="pcm",
        extra_body={
            "instructions": settings.instructions,
        },
    )

    async with response as stream:
        async for chunk in stream.iter_bytes(chunk_size=1024):
            yield chunk