Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
TypeScript agent-skillscodex-clideskop-appdubbingimage-generationlocalizationskillsttsvideo-editingvideo-generationvideo-transcriptionvideo-translation
feat: list tts voices from cli
wulien79af13644585
diff --git a/cmd/cli/main.go b/cmd/cli/main.goindex 0282f0bb..dffe7111 100644--- a/cmd/cli/main.go+++ b/cmd/cli/main.go@@ -25,6 +25,13 @@ func main() {fmt.Print(cli.Help(cmd))return}+ if cmd.Name == "voices" {+ if cmd.Voices.Provider == "" {+ _ = config.LoadConfig()+ }+ writeAndExit(cli.Execute(context.Background(), nil, cmd))+ return+ }if cmd.DryRun {writeAndExit(cli.Execute(context.Background(), nil, cmd))returndiff --git a/docs/zh/cli.md b/docs/zh/cli.mdindex e0cdfd9d..09bbefb7 100644--- a/docs/zh/cli.md+++ b/docs/zh/cli.md@@ -8,6 +8,7 @@ KrillinAI 提供一套阶段化命令行工具,适用于脚本编排、CI/CD|---|---|---|| `subtitle` | 字幕生成 | 视频 → 语音识别 → 翻译 → 双语字幕文件 || `tts` | 语音合成 | SRT 字幕 → TTS 配音音频 |+| `voices` | 音色查询 | 查看 TTS provider 可用的 `--voice` 代码 || `render-horizontal` | 横屏视频合成 | 视频 + 字幕/音频 → 横屏成品视频 || `render-vertical` | 竖屏视频合成 | 视频 + 字幕/音频 → 竖屏成品视频 || `pipeline` | 全流程编排 | 多阶段组合输出(subtitle/tts/render/cover) |@@ -204,12 +205,36 @@ krillinai tts \--workdir tasks/demo \--input-srt tasks/demo/target_language_srt.srt \--video tasks/demo/origin_video.mp4 \- --voice cosyvoice_zh_female_01+ --voice longxiaochun_v2```----### 3. render-horizontal / render-vertical — 视频合成+### 3. voices — 查看 TTS 音色++列出 TTS provider 可用的音色代码,用于 `tts --voice`。++```bash+krillinai voices [flags]+```++| 参数 | 类型 | 必填 | 默认值 | 说明 |+|---|---|---|---|---|+| `--provider` | string | 否 | 当前配置 | TTS provider,可选 `aliyun`、`openai`、`edge-tts` |+| `--dry-run` | bool | 否 | `false` | 返回本地音色清单,不执行外部调用 |++**示例:**++```bash+# 查看阿里云 TTS 常用音色代码+krillinai voices --provider aliyun+```++输出中的 `voices[].code` 可直接传给 `tts --voice`。++---++### 4. render-horizontal / render-vertical — 视频合成将字幕或配音合成到视频中,生成横屏或竖屏成品。@@ -263,7 +288,7 @@ krillinai render-vertical \----### 4. pipeline — 全流程编排+### 5. pipeline — 全流程编排一键串联多个阶段,按序执行。@@ -307,7 +332,7 @@ krillinai pipeline \----### 5. cover — 封面生成+### 6. cover — 封面生成基于视频内容和翻译信息,生成 AI 封面图。@@ -319,7 +344,7 @@ krillinai cover [flags]----### 6. status — 状态查询+### 7. status — 状态查询查询任务的当前状态和进度。diff --git a/internal/cli/commands.go b/internal/cli/commands.goindex 95e38f58..83816fe4 100644--- a/internal/cli/commands.go+++ b/internal/cli/commands.go@@ -6,9 +6,11 @@ import ("flag""fmt""io"+ "krillin-ai/config""krillin-ai/internal/pipeline"subtitlestyle "krillin-ai/internal/subtitle_style""krillin-ai/internal/updater"+ "krillin-ai/internal/voices""os""path/filepath""runtime"@@ -52,6 +54,7 @@ type Command struct {Cover pipeline.CoverRequestPipeline pipeline.PipelineRequestUpdate UpdateRequest+ Voices VoicesRequest}type UpdateRequest struct {@@ -61,6 +64,10 @@ type UpdateRequest struct {Force bool}+type VoicesRequest struct {+ Provider string+}+func Parse(args []string) (Command, error) {if len(args) == 0 {return Command{}, errors.New("missing command")@@ -84,6 +91,8 @@ func Parse(args []string) (Command, error) {return parseCover(name, args[1:])case "update":return parseUpdate(name, args[1:])+ case "voices":+ return parseVoices(name, args[1:])case "status":if hasHelpArg(args[1:]) {return Command{Name: name, Help: true}, nil@@ -193,6 +202,15 @@ Flags:--force Reinstall even when current version matches latest--dry-run Validate command without downloading or replacing files-h, --help Show this help+`+ case "voices":+ return `Usage:+ krillinai-cli voices [flags]++Flags:+ --provider <name> TTS provider to list voices for: aliyun, openai, or edge-tts; default current config+ --dry-run Return the same local voice list without external calls+ -h, --help Show this help`case "status":return `Usage:@@ -212,6 +230,7 @@ Commands:pipeline Plan or run multi-stage workflows when supportedcover Generate a cover image from a promptupdate Update krillinai-cli from GitHub releases+ voices List available TTS voice codesstatus Reserved status query surfaceRun "krillinai-cli <command> --help" for command-specific flags.@@ -248,6 +267,8 @@ func Execute(ctx context.Context, svc pipeline.StageService, cmd Command) pipelireturn responseWithError(resp, err)case "update":return executeUpdate(ctx, cmd.Update)+ case "voices":+ return executeVoices(cmd.Voices)default:return pipeline.Response{OK: false,@@ -260,6 +281,58 @@ func Execute(ctx context.Context, svc pipeline.StageService, cmd Command) pipeli}}+func parseVoices(name string, args []string) (Command, error) {+ if hasHelpArg(args) {+ return Command{Name: name, Help: true}, nil+ }+ fs := newFlagSet(name)+ provider := fs.String("provider", "", "tts provider")+ dryRun := fs.Bool("dry-run", false, "return local voice list without external calls")+ if err := fs.Parse(args); err != nil {+ return Command{}, err+ }+ if fs.NArg() != 0 {+ return Command{}, errors.New("voices does not accept positional arguments")+ }+ return Command{+ Name: name,+ DryRun: *dryRun,+ Voices: VoicesRequest{+ Provider: *provider,+ },+ }, nil+}++func executeVoices(req VoicesRequest) pipeline.Response {+ provider := strings.TrimSpace(req.Provider)+ if provider == "" {+ provider = currentTTSProvider()+ }+ list, err := voices.List(provider)+ if err != nil {+ return pipeline.Response{+ OK: false,+ Stage: pipeline.StageVoices,+ Inputs: map[string]string{+ "provider": provider,+ },+ Error: &pipeline.Error{+ Kind: pipeline.ErrorKindUsage,+ Code: "list_voices_failed",+ Message: err.Error(),+ },+ }+ }+ return pipeline.Response{+ OK: true,+ Stage: pipeline.StageVoices,+ Inputs: map[string]string{+ "provider": provider,+ },+ Voices: list,+ }+}+func parseUpdate(name string, args []string) (Command, error) {if hasHelpArg(args) {return Command{Name: name, Help: true}, nil@@ -540,6 +613,8 @@ func dryRun(cmd Command) pipeline.Response {Stage: pipeline.StageUpdate,Inputs: inputs,}+ case "voices":+ return executeVoices(cmd.Voices)default:return pipeline.Response{OK: false,@@ -552,6 +627,10 @@ func dryRun(cmd Command) pipeline.Response {}}+var currentTTSProvider = func() string {+ return config.Conf.Tts.Provider+}+func dryRunResponse(stage pipeline.Stage, workdir, taskID string) pipeline.Response {return pipeline.Response{OK: true,diff --git a/internal/cli/commands_test.go b/internal/cli/commands_test.goindex 7d2951c9..5799df5c 100644--- a/internal/cli/commands_test.go+++ b/internal/cli/commands_test.go@@ -122,6 +122,36 @@ func TestParseUpdateCommand(t *testing.T) {}}+func TestParseVoicesCommand(t *testing.T) {+ cmd, err := Parse([]string{+ "voices",+ "--provider", "aliyun",+ })+ if err != nil {+ t.Fatalf("Parse() error = %v", err)+ }+ if cmd.Name != "voices" {+ t.Fatalf("Name = %q, want voices", cmd.Name)+ }+ if cmd.Voices.Provider != "aliyun" {+ t.Fatalf("Provider = %q, want aliyun", cmd.Voices.Provider)+ }+}++func TestVoicesHelp(t *testing.T) {+ cmd, err := Parse([]string{"voices", "--help"})+ if err != nil {+ t.Fatalf("Parse() error = %v", err)+ }+ if !cmd.Help || cmd.Name != "voices" {+ t.Fatalf("Command = %#v, want voices help", cmd)+ }+ help := Help(cmd)+ if !strings.Contains(help, "krillinai-cli voices") || !strings.Contains(help, "--provider") {+ t.Fatalf("Help() = %q, want voices usage", help)+ }+}+func TestUpdateHelp(t *testing.T) {cmd, err := Parse([]string{"update", "--help"})if err != nil {@@ -151,6 +181,9 @@ func TestParseRootHelp(t *testing.T) {if !strings.Contains(help, "update") {t.Fatalf("Help() = %q, want update command", help)}+ if !strings.Contains(help, "voices") {+ t.Fatalf("Help() = %q, want voices command", help)+ }}func TestParseSubcommandHelp(t *testing.T) {@@ -265,6 +298,63 @@ func TestExecuteDryRunUpdateReturnsJSONReadyResponse(t *testing.T) {}}+func TestExecuteDryRunVoicesReturnsAliyunVoiceList(t *testing.T) {+ cmd, err := Parse([]string{"voices", "--provider", "aliyun", "--dry-run"})+ if err != nil {+ t.Fatalf("Parse() error = %v", err)+ }+ resp := Execute(context.Background(), nil, cmd)+ if !resp.OK {+ t.Fatalf("OK = false, error = %#v", resp.Error)+ }+ if resp.Stage != pipeline.StageVoices {+ t.Fatalf("Stage = %s, want voices", resp.Stage)+ }+ if resp.Inputs["provider"] != "aliyun" {+ t.Fatalf("provider input = %q", resp.Inputs["provider"])+ }+ if len(resp.Voices) == 0 {+ t.Fatal("Voices is empty, want aliyun voice list")+ }+ if !containsVoiceCode(resp.Voices, "longxiaochun_v2") {+ t.Fatalf("Voices = %#v, want aliyun voice code longxiaochun_v2", resp.Voices)+ }+}++func TestExecuteVoicesUsesConfiguredProviderWhenProviderMissing(t *testing.T) {+ original := currentTTSProvider+ currentTTSProvider = func() string {+ return "openai"+ }+ t.Cleanup(func() {+ currentTTSProvider = original+ })++ cmd, err := Parse([]string{"voices"})+ if err != nil {+ t.Fatalf("Parse() error = %v", err)+ }+ resp := Execute(context.Background(), nil, cmd)+ if !resp.OK {+ t.Fatalf("OK = false, error = %#v", resp.Error)+ }+ if resp.Inputs["provider"] != "openai" {+ t.Fatalf("provider input = %q, want openai", resp.Inputs["provider"])+ }+ if !containsVoiceCode(resp.Voices, "alloy") {+ t.Fatalf("Voices = %#v, want openai voice code alloy", resp.Voices)+ }+}++func containsVoiceCode(voices []pipeline.Voice, code string) bool {+ for _, voice := range voices {+ if voice.Code == code {+ return true+ }+ }+ return false+}+func TestExecuteDryRunRenderRejectsInvalidSubtitleStyleFile(t *testing.T) {cmd, err := Parse([]string{"render-horizontal",diff --git a/internal/pipeline/types.go b/internal/pipeline/types.goindex 696f5d3c..887ba16c 100644--- a/internal/pipeline/types.go+++ b/internal/pipeline/types.go@@ -12,6 +12,7 @@ const (StageCover Stage = "cover"StagePipeline Stage = "pipeline"StageUpdate Stage = "update"+ StageVoices Stage = "voices")type CaptionSource string@@ -90,6 +91,15 @@ type Outputs struct {TargetText string `json:"target_text,omitempty"`}+type Voice struct {+ Code string `json:"code"`+ Name string `json:"name,omitempty"`+ Language string `json:"language,omitempty"`+ Gender string `json:"gender,omitempty"`+ Provider string `json:"provider,omitempty"`+ Scenario string `json:"scenario,omitempty"`+}+type Response struct {OK bool `json:"ok"`Stage Stage `json:"stage"`@@ -97,6 +107,7 @@ type Response struct {TaskID string `json:"task_id,omitempty"`CaptionSource CaptionSource `json:"caption_source,omitempty"`Inputs map[string]string `json:"inputs,omitempty"`+ Voices []Voice `json:"voices,omitempty"`Outputs Outputs `json:"outputs,omitempty"`Warnings []string `json:"warnings,omitempty"`FailedIndexes []int `json:"failed_indexes,omitempty"`diff --git a/internal/voices/voices.go b/internal/voices/voices.gonew file mode 100644index 00000000..13b1fb98--- /dev/null+++ b/internal/voices/voices.go@@ -0,0 +1,70 @@+package voices++import (+ "fmt"+ "sort"+ "strings"++ "krillin-ai/internal/pipeline"+)++const (+ ProviderAliyun = "aliyun"+ ProviderOpenAI = "openai"+ ProviderEdge = "edge-tts"+)++func List(provider string) ([]pipeline.Voice, error) {+ provider = strings.TrimSpace(strings.ToLower(provider))+ switch provider {+ case ProviderAliyun:+ return cloneVoices(aliyunVoices), nil+ case ProviderOpenAI:+ return cloneVoices(openaiVoices), nil+ case ProviderEdge:+ return nil, fmt.Errorf("edge-tts voice listing is not supported yet; use edge-tts --list-voices")+ default:+ return nil, fmt.Errorf("unsupported tts provider: %s", provider)+ }+}++func Providers() []string {+ return []string{ProviderAliyun, ProviderOpenAI, ProviderEdge}+}++func cloneVoices(in []pipeline.Voice) []pipeline.Voice {+ out := append([]pipeline.Voice(nil), in...)+ sort.SliceStable(out, func(i, j int) bool {+ if out[i].Provider != out[j].Provider {+ return out[i].Provider < out[j].Provider+ }+ return out[i].Code < out[j].Code+ })+ return out+}++var aliyunVoices = []pipeline.Voice{+ {Provider: ProviderAliyun, Code: "longxiaochun_v2", Name: "龙小淳", Language: "zh-CN", Gender: "female", Scenario: "通用女声"},+ {Provider: ProviderAliyun, Code: "longxiaoxia_v2", Name: "龙小夏", Language: "zh-CN", Gender: "female", Scenario: "自然女声"},+ {Provider: ProviderAliyun, Code: "longxiaocheng_v2", Name: "龙小诚", Language: "zh-CN", Gender: "male", Scenario: "通用男声"},+ {Provider: ProviderAliyun, Code: "longxiaobai_v2", Name: "龙小白", Language: "zh-CN", Gender: "female", Scenario: "甜美女声"},+ {Provider: ProviderAliyun, Code: "longlaotie_v2", Name: "龙老铁", Language: "zh-CN", Gender: "male", Scenario: "东北口音"},+ {Provider: ProviderAliyun, Code: "longshu_v2", Name: "龙叔", Language: "zh-CN", Gender: "male", Scenario: "沉稳男声"},+ {Provider: ProviderAliyun, Code: "longshuo_v2", Name: "龙硕", Language: "zh-CN", Gender: "male", Scenario: "朗读男声"},+ {Provider: ProviderAliyun, Code: "longjing_v2", Name: "龙婧", Language: "zh-CN", Gender: "female", Scenario: "新闻女声"},+ {Provider: ProviderAliyun, Code: "longmiao_v2", Name: "龙妙", Language: "zh-CN", Gender: "female", Scenario: "客服女声"},+ {Provider: ProviderAliyun, Code: "longyue_v2", Name: "龙悦", Language: "zh-CN", Gender: "female", Scenario: "温柔女声"},+}++var openaiVoices = []pipeline.Voice{+ {Provider: ProviderOpenAI, Code: "alloy", Language: "multi", Scenario: "balanced"},+ {Provider: ProviderOpenAI, Code: "ash", Language: "multi", Scenario: "calm"},+ {Provider: ProviderOpenAI, Code: "ballad", Language: "multi", Scenario: "expressive"},+ {Provider: ProviderOpenAI, Code: "coral", Language: "multi", Scenario: "warm"},+ {Provider: ProviderOpenAI, Code: "echo", Language: "multi", Scenario: "clear"},+ {Provider: ProviderOpenAI, Code: "fable", Language: "multi", Scenario: "narration"},+ {Provider: ProviderOpenAI, Code: "nova", Language: "multi", Scenario: "bright"},+ {Provider: ProviderOpenAI, Code: "onyx", Language: "multi", Scenario: "deep"},+ {Provider: ProviderOpenAI, Code: "sage", Language: "multi", Scenario: "neutral"},+ {Provider: ProviderOpenAI, Code: "shimmer", Language: "multi", Scenario: "soft"},+}diff --git a/internal/voices/voices_test.go b/internal/voices/voices_test.gonew file mode 100644index 00000000..9410ec0d--- /dev/null+++ b/internal/voices/voices_test.go@@ -0,0 +1,39 @@+package voices++import (+ "krillin-ai/internal/pipeline"+ "strings"+ "testing"+)++func TestListAliyunVoicesIncludesCosyVoiceCodes(t *testing.T) {+ got, err := List(ProviderAliyun)+ if err != nil {+ t.Fatalf("List() error = %v", err)+ }+ if !hasVoice(got, "longxiaochun_v2") {+ t.Fatalf("aliyun voices = %#v, want longxiaochun_v2", got)+ }+ if !hasVoice(got, "longxiaocheng_v2") {+ t.Fatalf("aliyun voices = %#v, want longxiaocheng_v2", got)+ }+}++func TestListRejectsUnsupportedProvider(t *testing.T) {+ _, err := List("unknown")+ if err == nil {+ t.Fatal("List() error = nil, want unsupported provider error")+ }+ if !strings.Contains(err.Error(), "unsupported tts provider") {+ t.Fatalf("error = %q, want unsupported provider", err.Error())+ }+}++func hasVoice(voices []pipeline.Voice, code string) bool {+ for _, voice := range voices {+ if voice.Code == code {+ return true+ }+ }+ return false+}