feat: support cloned voice deletion

apps/api/internal/httpapi/voice_clone_handlers.go

@@ -36,3 +36,41 @@ func (s *Server) listClonedVoices(w http.ResponseWriter, r *http.Request) {
 	}
 	writeJSON(w, http.StatusOK, map[string]any{"items": items})
 }
+
+// deleteClonedVoice godoc
+// @Summary 删除当前用户克隆音色
+// @Description 先从上游供应商删除音色，成功后再将网关数据库中的音色记录标记为 deleted。
+// @Tags voice-clone
+// @Produce json
+// @Security BearerAuth
+// @Param voiceID path string true "克隆音色记录 ID 或上游 voice_id"
+// @Success 200 {object} map[string]any
+// @Failure 400 {object} ErrorEnvelope
+// @Failure 401 {object} ErrorEnvelope
+// @Failure 403 {object} ErrorEnvelope
+// @Failure 404 {object} ErrorEnvelope
+// @Failure 502 {object} ErrorEnvelope
+// @Router /api/v1/voice_clone/voices/{voiceID} [delete]
+// @Router /v1/voice_clone/voices/{voiceID} [delete]
+// @Router /voice_clone/voices/{voiceID} [delete]
+func (s *Server) deleteClonedVoice(w http.ResponseWriter, r *http.Request) {
+	user, ok := auth.UserFromContext(r.Context())
+	if !ok {
+		writeError(w, http.StatusUnauthorized, "unauthorized")
+		return
+	}
+	if !apiKeyScopeAllowed(user, "voice.clone") {
+		writeError(w, http.StatusForbidden, "api key scope does not allow this capability")
+		return
+	}
+	result, err := s.runner.DeleteClonedVoice(r.Context(), user, r.PathValue("voiceID"))
+	if err != nil {
+		writeErrorWithDetails(w, statusFromRunError(err), runErrorMessage(err), runErrorDetails(err), runErrorCode(err))
+		return
+	}
+	writeJSON(w, http.StatusOK, map[string]any{
+		"data":      result.Voice,
+		"upstream":  result.Upstream,
+		"requestId": result.RequestID,
+	})
+}