first commit

model/dto/model_dto.go

@@ -0,0 +1,71 @@
+package dto
+
+import (
+	"gitea.com/red-future/common/beans"
+	"github.com/gogf/gf/v2/frame/g"
+)
+
+// CreateModelReq 添加模型配置
+type CreateModelReq struct {
+	g.Meta           `path:"/createModel" method:"post" tags:"模型管理" summary:"创建模型配置" dc:"添加新的模型配置"`
+	ModelName        string `p:"modelName" json:"modelName" v:"required#modelName不能为空" dc:"模型名称（唯一标识）"`
+	BaseURL          string `p:"baseUrl" json:"baseUrl" v:"required#baseUrl不能为空" dc:"模型服务基础地址（如 http(s)://host:port）"`
+	Route            string `p:"route" json:"route" dc:"路由/路径（拼接到 BaseURL 之后的可选路径）"`
+	HttpMethod       string `p:"httpMethod" json:"httpMethod" dc:"请求方式：GET/POST（默认POST）"`
+	APIKey           string `p:"apiKey" json:"apiKey" dc:"请求密钥绑定（请求头），示例：TTS_API_KEY:your-key"`
+	Enabled          int    `p:"enabled" json:"enabled" dc:"是否启用：0-禁用，1-启用"`
+	MaxConcurrency   int    `p:"maxConcurrency" json:"maxConcurrency" dc:"最大并发数"`
+	QueueLimit       int    `p:"queueLimit" json:"queueLimit" dc:"排队队列上限（超过则拒绝/限流）"`
+	TimeoutMs        int    `p:"timeoutMs" json:"timeoutMs" dc:"请求超时时间（毫秒）"`
+	RetryTimes       int    `p:"retryTimes" json:"retryTimes" dc:"失败重试次数"`
+	AutoCleanSeconds int    `p:"autoCleanSeconds" json:"autoCleanSeconds" dc:"自动清理间隔（秒）（如清理超时任务/队列）"`
+	Remark           string `p:"remark" json:"remark" dc:"备注说明"`
+}
+
+type CreateModelRes struct {
+	ID int64 `json:"id,string" dc:"配置ID"`
+}
+
+// UpdateModelReq 更新模型配置
+type UpdateModelReq struct {
+	g.Meta           `path:"/updateModel" method:"put" tags:"模型管理" summary:"更新模型配置" dc:"更新指定ID的模型配置"`
+	ID               int64   `p:"id" json:"id,string" v:"required#id不能为空" dc:"配置ID"`
+	BaseURL          string  `p:"baseUrl" json:"baseUrl" dc:"模型服务基础地址"`
+	Route            string  `p:"route" json:"route" dc:"路由/路径"`
+	HttpMethod       *string `p:"httpMethod" json:"httpMethod" dc:"请求方式：GET/POST（可选更新）"`
+	APIKey           *string `p:"apiKey" json:"apiKey" dc:"请求密钥绑定（请求头）（可选更新）"`
+	Enabled          *int    `p:"enabled" json:"enabled" dc:"是否启用：0-禁用，1-启用（可选更新）"`
+	MaxConcurrency   *int    `p:"maxConcurrency" json:"maxConcurrency" dc:"最大并发数（可选更新）"`
+	QueueLimit       *int    `p:"queueLimit" json:"queueLimit" dc:"排队队列上限（可选更新）"`
+	TimeoutMs        *int    `p:"timeoutMs" json:"timeoutMs" dc:"请求超时时间（毫秒）（可选更新）"`
+	RetryTimes       *int    `p:"retryTimes" json:"retryTimes" dc:"失败重试次数（可选更新）"`
+	AutoCleanSeconds *int    `p:"autoCleanSeconds" json:"autoCleanSeconds" dc:"自动清理间隔（秒）（可选更新）"`
+	Remark           *string `p:"remark" json:"remark" dc:"备注说明（可选更新）"`
+}
+
+// DeleteModelReq 删除模型配置
+type DeleteModelReq struct {
+	g.Meta `path:"/deleteModel" method:"delete" tags:"模型管理" summary:"删除模型配置" dc:"删除指定ID的模型配置"`
+	ID     int64 `p:"id" json:"id,string" v:"required#id不能为空" dc:"配置ID"`
+}
+
+// GetModelReq 获取模型配置详情
+type GetModelReq struct {
+	g.Meta `path:"/getModel" method:"get" tags:"模型管理" summary:"获取模型配置" dc:"根据模型名称获取配置详情"`
+	ID     int64 `p:"id" json:"id,string" v:"required#id不能为空" dc:"配置ID"`
+}
+
+type GetModelRes struct {
+	Model any `json:"model" dc:"模型配置详情"`
+}
+
+// ListModelReq 配置列表
+type ListModelReq struct {
+	g.Meta `path:"/listModel" method:"post" tags:"模型管理" summary:"模型配置列表" dc:"分页获取模型配置列表"`
+	Page   *beans.Page `p:"page" json:"page" dc:"分页参数"`
+}
+
+type ListModelRes struct {
+	List  any   `json:"list" dc:"列表数据"`
+	Total int64 `json:"total" dc:"总数"`
+}

model/dto/task_dto.go

@@ -0,0 +1,42 @@
+package dto
+
+import "github.com/gogf/gf/v2/frame/g"
+
+// CreateTaskReq 创建异步任务
+type CreateTaskReq struct {
+	g.Meta         `path:"/createTask" method:"post" tags:"任务管理" summary:"创建异步任务" dc:"创建异步任务并返回任务ID"`
+	ModelName      string `p:"modelName" json:"modelName" v:"required#modelName不能为空" dc:"模型名称"`
+	InputRef       string `p:"inputRef" json:"inputRef" dc:"输入引用（如OSS/文件引用等）"`
+	RequestPayload any    `p:"requestPayload" json:"requestPayload" dc:"请求负载（透传给模型服务）"`
+}
+
+type CreateTaskRes struct {
+	TaskID string `json:"taskId" dc:"任务ID"`
+}
+
+// GetTaskResultReq 获取结果（只返回 oss 地址）
+type GetTaskResultReq struct {
+	g.Meta `path:"/getTaskResult" method:"get" tags:"任务管理" summary:"获取任务结果" dc:"根据任务ID获取结果（只返回OSS地址）"`
+	TaskID string `p:"taskId" json:"taskId" v:"required#taskId不能为空" dc:"任务ID"`
+}
+
+type GetTaskResultRes struct {
+	OssFile string `json:"ossFile" dc:"结果文件OSS地址"`
+	State   int    `json:"state" dc:"任务状态"`
+}
+
+// GetTaskBatchReq 批量查询任务（并对成功任务标记为已下载）
+type GetTaskBatchReq struct {
+	g.Meta  `path:"/getTaskBatch" method:"post" tags:"任务管理" summary:"批量查询任务" dc:"批量查询任务状态与OSS地址；对成功(state=2)的任务自动标记为已下载(state=4)，并写入保留到期时间"`
+	TaskIDs []string `p:"taskIds" json:"taskIds" v:"required#taskIds不能为空" dc:"任务ID列表"`
+}
+
+type GetTaskBatchItem struct {
+	TaskID  string `json:"taskId" dc:"任务ID"`
+	State   int    `json:"state" dc:"任务状态"`
+	OssFile string `json:"ossFile" dc:"结果文件OSS地址"`
+}
+
+type GetTaskBatchRes struct {
+	List []GetTaskBatchItem `json:"list" dc:"任务列表"`
+}