Text-to-speech - AgentKit 文档

Overview

Tool identifier text_to_speech. text_to_speech synthesizes text into speech and saves the audio locally. Import path: from veadk.tools.builtin_tools.tts import text_to_speech

Environment & prerequisites

Requirements:

Configure the API key for the agent’s reasoning model.
Configure the VeSpeech service App ID and API key.

Environment variables:

MODEL_AGENT_API_KEY: API key for the agent’s reasoning model
TOOL_VESPEECH_APP_ID: VeSpeech service App ID
TOOL_VESPEECH_API_KEY: VeSpeech service API key
TOOL_VESPEECH_SPEAKER: voice, defaults to zh_female_vv_uranus_bigtts
TOOL_VESPEECH_AUDIO_OUTPUT_PATH: audio output directory, defaults to the system temp directory

Usage

examples/tools/tts/agent.py

import asyncio

from veadk import Agent, Runner
from veadk.memory.short_term_memory import ShortTermMemory
from veadk.tools.builtin_tools.tts import text_to_speech

agent = Agent(
    name="tts_agent",
    model_name="doubao-seed-1-8-251228",
    description="An agent that speaks text aloud.",
    instruction="Use the text_to_speech tool to synthesize the user's text into speech.",
    tools=[text_to_speech],
)

runner = Runner(agent=agent, short_term_memory=ShortTermMemory())


async def main():
    response = await runner.run("Read this aloud: Hello, welcome to VeADK")
    print(response)


if __name__ == "__main__":
    asyncio.run(main())

Last modified on September 19, 2026