Coze TTS

Generate speech audio URLs from text using Coze TTS.

Quick start

node {skillDir}/scripts/tts.mjs --text "Hello, welcome to our service"
node {skillDir}/scripts/tts.mjs --texts "Chapter 1" "Chapter 2" --speaker zh_male_m191_uranus_bigtts
node {skillDir}/scripts/tts.mjs --text "Fast announcement" --speech-rate 30 --format mp3 --sample-rate 48000

Options

• --text <text> single text input. If both --text and --texts are provided, --text takes precedence.
• --texts <texts...> multiple text inputs. Values are read until the next --flag.
• --speaker <id> speaker id, default zhfemalexiaoheuranusbigtts
• --format <fmt> audio format: mp3, pcm, or ogg_opus. Default is SDK default (mp3).
• --sample-rate <hz> sample rate. Supported values: 8000, 16000, 22050, 24000, 32000, 44100, 48000. Default is SDK default (24000).
• --speech-rate <n> speech rate adjustment, range -50 to 100, default 0
• --loudness-rate <n> loudness adjustment, range -50 to 100, default 0

Behavior

• At least one of --text or --texts is required.
• This skill currently supports plain text input only. It does not expose ssml, --header, -H, or --mock.
• The CLI prints one audio URL per generated segment. It does not download audio files locally.
• Printed audio URLs must be kept exactly intact, complete, and accurate. All URL parameters must be preserved without truncation, rewriting, omission, or reordering; in particular, parameters inside the query string such as sign must not be dropped, otherwise the audio may be inaccessible.
• Unless the user explicitly asks to download the URL content, only return the complete URL link to the user.
• The CLI does not print audioSize, even though the underlying SDK returns it.
• Invalid ranges or unsupported values are passed through to the SDK and may fail there.

Sample Rates

Supported: 8000, 16000, 22050, 24000, 32000, 44100, 48000 Hz

• 8000-16000: Phone quality
• 22050-24000: Standard quality (default)
• 32000-48000: High quality

Tuning

• speechRate: range -50 to 100, default 0. Negative values slow speech down, positive values speed it up.
• loudnessRate: range -50 to 100, default 0. Negative values make output quieter, positive values make it louder.

Voices

General

• zhfemalexiaoheuranusbigtts 小荷: 默认，通用女声
• zhfemalevvuranusbigtts Vivi: 中英双语女声
• zhmalem191uranusbigtts 云舟: 男声
• zhmaletaochenguranusbigtts 小天: 男声

Audiobook / Reading

• zhfemalexueayisaturnbigtts 雪阿姨: 儿童有声读物女声

Video Dubbing

• zhmaledayisaturnbigtts 大一: 男声
• zhfemalemizaisaturnbigtts 米仔: 女声
• zhfemalejitangnvsaturnbigtts 鸡汤女: 励志女声
• zhfemalemeilinvyousaturnbigtts 甜美女友: 甜美女友
• zhfemalesantongyongnssaturnbigtts 三通女声: 通用流畅女声
• zhmaleruyayichensaturnbigtts 儒雅一尘: 儒雅男声

Roleplay

• saturnzhfemalekeainvshengtob 可爱女生: 可爱女生
• saturnzhfemaletiaopigongzhutob 俏皮公主: 俏皮公主
• saturnzhmaleshuanglangshaoniantob 爽朗少年: 爽朗少年
• saturnzhmaletiancaitongzhuotob 天才同桌: 天才同桌
• saturnzhfemalecancantob 灿灿: 知性灿灿

Notes

• The skill runtime requires plugins.entries.coze-openclaw-plugin.config.apiKey.
• {skillDir} means the directory containing this SKILL.md.
• The script prints one audio URL per generated segment.
• The returned URL must be used as-is, in full, and with every parameter preserved exactly, especially query parameters such as sign, otherwise the audio may not be accessible.