64 lines
3.4 KiB
Go
64 lines
3.4 KiB
Go
|
package volcano
|
||
|
|
|
||
|
|
// Options 是火山 v3 TTS 适配器的完整调用参数集合。
|
||
|
|
// 由 setting 包从环境变量构造,controller 直接透传,不做 OpenAI 侧映射。
|
||
|
|
//
|
||
|
|
// 字段顺序与文档 3.x 节一致,便于对照。
|
||
|
|
type Options struct {
|
||
|
|
// --- 鉴权 / 路由 ---
|
||
|
|
APIKey string // X-Api-Key
|
||
|
|
ResourceID string // X-Api-Resource-Id,决定模型版本与计费,如 seed-icl-2.0
|
||
|
|
|
||
|
|
// --- req_params 核心字段 ---
|
||
|
|
Text string
|
||
|
|
Speaker string
|
||
|
|
Model string // 可空,仅复刻 2.0 生效;env 默认 seed-tts-2.0-standard
|
||
|
|
UID string // user.uid,默认 "uid"
|
||
|
|
|
||
|
|
// --- audio_params ---
|
||
|
|
Format string // 上游实际请求的 format:mp3 / pcm / ogg_opus
|
||
|
|
SampleRate int // 8000/16000/22050/24000/32000/44100/48000
|
||
|
|
BitRate int // 可选,仅 MP3 生效
|
||
|
|
SpeechRate int // [-50, 100]
|
||
|
|
LoudnessRate int // [-50, 100]
|
||
|
|
EnableSubtitle bool // 复刻 2.0 生效,返回 TTSSubtitle
|
||
|
|
EnableTimestamp bool // 复刻 1.0 生效,内嵌字级时间戳
|
||
|
|
|
||
|
|
// --- additions(扩展参数,JSON 字符串承载)---
|
||
|
|
// 文档明确 additions 在请求体里必须是 string,内容是 JSON。
|
||
|
|
// 这里直接存结构体,序列化时由 MarshalJSON 输出为 string。
|
||
|
|
Additions *Additions
|
||
|
|
}
|
||
|
|
|
||
|
|
// Additions 对应文档 3.4 节的扩展参数。
|
||
|
|
// 注意:在请求体里 additions 是 JSON 字符串,所以 MarshalJSON 序列化为 string。
|
||
|
|
type Additions struct {
|
||
|
|
ModelType *int `json:"model_type,omitempty"` // 复刻 2.0 推荐显式指定,4=ICL V2、5=ICL V3
|
||
|
|
ContextTexts []string `json:"context_texts,omitempty"` // 语音指令
|
||
|
|
UseTagParser *bool `json:"use_tag_parser,omitempty"` // 复刻 2.0 expressive 启用语音标签 Cot
|
||
|
|
ExplicitLanguage string `json:"explicit_language,omitempty"` // 明确语种
|
||
|
|
ContextLanguage string `json:"context_language,omitempty"` // 参考语种
|
||
|
|
SilenceDuration *int `json:"silence_duration,omitempty"` // 0~30000ms
|
||
|
|
EnableLanguageDetector *bool `json:"enable_language_detector,omitempty"` // 自动识别语种
|
||
|
|
DisableMarkdownFilter *bool `json:"disable_markdown_filter,omitempty"` // 是否解析 markdown
|
||
|
|
DisableEmojiFilter *bool `json:"disable_emoji_filter,omitempty"` // 是否过滤 emoji
|
||
|
|
MaxLengthFilterParenthesis *int `json:"max_length_to_filter_parenthesis,omitempty"`
|
||
|
|
UnsupportedCharRatio *float64 `json:"unsupported_char_ratio_thresh,omitempty"`
|
||
|
|
AIGCWatermark *bool `json:"aigc_watermark,omitempty"`
|
||
|
|
AIGCMetadata any `json:"aigc_metadata,omitempty"`
|
||
|
|
CacheConfig any `json:"cache_config,omitempty"`
|
||
|
|
PostProcess any `json:"post_process,omitempty"`
|
||
|
|
}
|
||
|
|
|
||
|
|
// IsZero 报告 Additions 是否为空(没有任何字段设置),用于在序列化前跳过 additions。
|
||
|
|
func (a *Additions) IsZero() bool {
|
||
|
|
if a == nil {
|
||
|
|
return true
|
||
|
|
}
|
||
|
|
return a.ModelType == nil && a.ContextTexts == nil && a.UseTagParser == nil &&
|
||
|
|
a.ExplicitLanguage == "" && a.ContextLanguage == "" && a.SilenceDuration == nil &&
|
||
|
|
a.EnableLanguageDetector == nil && a.DisableMarkdownFilter == nil && a.DisableEmojiFilter == nil &&
|
||
|
|
a.MaxLengthFilterParenthesis == nil && a.UnsupportedCharRatio == nil &&
|
||
|
|
a.AIGCWatermark == nil && a.AIGCMetadata == nil && a.CacheConfig == nil && a.PostProcess == nil
|
||
|
|
}
|