代码初始化

model/dto/audio/audio_dto.go

@@ -1,11 +1,15 @@
 package audio
 
+import "github.com/gogf/gf/v2/frame/g"
+
 // TranscribeReq 语音转文字请求（JSON body / URL 方式）
 type TranscribeReq struct {
-	VideoURLs []string `json:"video_urls" v:"required#视频URL列表不能为空" dc:"视频URL列表"`
-	Model     string   `json:"model" dc:"whisper模型(tiny/base/small/medium)" d:"medium"`
-	Language  string   `json:"language" dc:"语言(zh/en/ja)" d:"zh"`
-	Threshold float64  `json:"threshold" dc:"场景检测阈值(0.1-0.5)" d:"0.3"`
+	g.Meta      `path:"/transcribe" method:"post" tags:"音频转写" summary:"语音转文字(异步)" dc:"创建异步语音转文字任务,返回taskId"`
+	VideoURLs   []string `json:"video_urls" v:"required#视频URL列表不能为空" dc:"视频URL列表"`
+	Model       string   `json:"model" dc:"whisper模型(tiny/base/small/medium)" d:"medium"`
+	Language    string   `json:"language" dc:"语言(zh/en/ja)" d:"zh"`
+	Threshold   float64  `json:"threshold" dc:"场景检测阈值(0.1-0.5)" d:"0.3"`
+	CallbackURL string   `json:"callback_url" dc:"任务完成后的回调地址(可选)，成功后POST结果到此URL"`
 }
 
 // TranscribeRes 语音转文字响应