TTS-API

// adapter.go — TTS Provider 统一接口 type TTSAdapter interface { // 初始化：传入渠道配置（API Key / Resource ID / 默认音色等） Init(info *TTSRelayInfo) error // 构建上游请求 URL BuildRequestURL(info *TTSRelayInfo) (string, error) // 设置请求头（鉴权、Content-Type 等） SetupRequestHeader(c *gin.Context, req *http.Request, info *TTSRelayInfo) error // 核心：将 OpenAI 格式请求转为 Provider 原生请求体 ConvertRequest(info *TTSRelayInfo, req *dto.OpenAITTSRequest) (any, error) // 发送请求到上游 DoRequest(c *gin.Context, info *TTSRelayInfo, body io.Reader) (*http.Response, error) // 处理上游响应：提取音频、统计字符数/时长、返回标准结构 DoResponse(c *gin.Context, resp *http.Response, info *TTSRelayInfo) (*dto.TTSUsage, *dto.TTSError) // 返回此渠道支持的音色列表（用于音色映射表构建） GetVoiceList() []ProviderVoice // 渠道标识 GetChannelName() string // 是否支持流式 TTS SupportStreaming() bool } // ProviderVoice 各 Provider 的音色结构 type ProviderVoice struct { ProviderID string // Provider 内部音色 ID，如 "zh_female_qingxin" Language string // zh-CN / en-US / ja-JP Gender string // male / female Style string // 风格标签，如 "news" / "story" / "chat" Description string // 音色描述 }

// voice_mapping 表 (数据库) type VoiceMapping struct { ID uint StandardVoice string // "tts-1-gentle-male" ChannelID uint // 渠道 ID ProviderVoice string // Provider 原始音色 ID Priority int // 优先级（同一标准音色多渠道时，优先选谁） IsDefault bool // 是否为该标准音色的默认渠道 } // 示例数据： // standard_voice | channel | provider_voice | priority // tts-1-gentle-male | 火山引擎 | zh_male_qingxin | 1 // tts-1-gentle-male | Azure | zh-CN-YunxiNeural | 2 // tts-1-gentle-male | 阿里 | cosyvoice-v1-longxiaochun| 3

tts-api/ ├── main.go # 入口：初始化 DB、路由、启动服务 ├── go.mod / go.sum ├── .env.example # 环境变量示例 ├── Dockerfile # 多阶段构建 ├── docker-compose.yml │ ├── router/ # 路由层 │ ├── main.go # 路由聚合 │ ├── api-router.go # /api/* 管理接口 │ ├── relay-router.go # /v1/audio/speech TTS 代理 │ └── web-router.go # /web/* 管理后台静态资源 │ ├── middleware/ # 中间件 │ ├── auth.go # JWT + API Key 认证 │ ├── rate-limit.go # 用户/IP 级别限流 │ ├── cors.go # 跨域 │ └── logger.go # 请求日志 │ ├── controller/ # 控制器 │ ├── tts.go # TTS 合成入口（核心） │ ├── channel.go # 渠道 CRUD │ ├── user.go # 用户管理 │ ├── token.go # API Key 管理 │ ├── voice.go # 音色映射管理 │ └── billing.go # 计费统计 │ ├── service/ # 服务层 │ ├── voice_mapping/ # 音色映射服务（核心） │ │ └── matcher.go # 自动匹配 & 建议 │ ├── channel_scheduler/ # 渠道调度（权重/故障切换） │ │ └── scheduler.go │ ├── audio_cache/ # 音频缓存（相同文本+音色命中） │ │ └── cache.go │ ├── audio_convert/ # 音频格式转换（ffmpeg 封装） │ │ └── converter.go │ ├── billing/ # 计费服务 │ │ └── billing.go │ └── quota/ # 配额管理 │ └── quota.go │ ├── adapter/ # 适配器层（核心！） │ ├── adapter.go # TTSAdapter 接口定义 │ ├── volcano/ # 火山引擎 TTS │ │ └── volcano.go │ ├── aliyun/ # 阿里云 CosyVoice / 百炼 │ │ └── aliyun.go │ ├── azure/ # 微软 Azure TTS │ │ └── azure.go │ ├── tencent/ # 腾讯云 TTS │ │ └── tencent.go │ ├── xunfei/ # 讯飞 TTS │ │ └── xunfei.go │ ├── openai/ # OpenAI TTS（基准） │ │ └── openai.go │ ├── fish_audio/ # Fish Audio（开源） │ │ └── fish_audio.go │ └── bert_vits/ # Bert-VITS2（开源自建） │ └── bert_vits.go │ ├── model/ # 数据模型 (GORM) │ ├── user.go │ ├── channel.go # 渠道（Provider 配置） │ ├── token.go # API Key / Token │ ├── voice_mapping.go # 音色映射 │ ├── usage_record.go # 用量记录 │ └── audio_cache.go # 音频缓存记录 │ ├── dto/ # 请求/响应结构体 │ ├── openai_tts.go # OpenAI TTS 请求/响应格式 │ ├── relay_info.go # 中继上下文（TTSRelayInfo） │ └── common.go # 通用响应 │ ├── setting/ # 配置管理 (Viper) │ └── setting.go │ ├── common/ # 通用工具 │ ├── utils.go │ └── constants.go │ └── web/ # React 管理后台 ├── src/ │ ├── pages/ │ │ ├── Dashboard # 数据看板 │ │ ├── Channels # 渠道管理 │ │ ├── VoiceMapping # 音色映射配置 │ │ ├── Users # 用户管理 │ │ ├── Tokens # API Key │ │ ├── Billing # 计费 & 用量 │ │ └── Logs # 调用日志 │ └── ... └── package.json