fix(#1195): 我的音色页面试听按钮对接/voice-clones/{id}/preview接口

- API层新增VoiceClonePreviewResponse类型和getVoiceClonePreview函数
- useMyVoices hook播放逻辑改为先调接口获取音频URL再播放
- 新增loadingPreviewId状态，试听合成中显示加载态
- VoiceCard增加isLoading prop，加载时按钮显示"合成中…"并禁用
- 错误处理：接口失败Toast提示，播放失败友好提示

apps/web/src/api/voice-clone/clones.ts

@@ -11,6 +11,7 @@ import type {
   VoiceCloneListParams,
   ListVoiceCloneResponse,
   VoiceCloneStatusResponse,
+  VoiceClonePreviewResponse,
 } from "./types"
 
 /** 获取克隆音色列表（返回前端兼容数组） */
@@ -85,3 +86,17 @@ export const retryVoiceClone = async (id: string): Promise<VoiceCloneProfile> =>
   const response = await apiClient.post<VoiceCloneProfile>(`/voice-clones/${id}/retry`)
   return response.data
 }
+
+/** 获取克隆音色试听音频（实时 TTS 合成） */
+export const getVoiceClonePreview = async (
+  cloneId: string,
+  text?: string,
+): Promise<VoiceClonePreviewResponse> => {
+  const searchParams = new URLSearchParams()
+  if (text) searchParams.set("text", text)
+  const qs = searchParams.toString()
+  const response = await apiClient.get<VoiceClonePreviewResponse>(
+    `/voice-clones/${cloneId}/preview${qs ? `?${qs}` : ""}`,
+  )
+  return response.data
+}

apps/web/src/api/voice-clone/index.ts

@@ -14,6 +14,7 @@ export type {
   VoiceCloneStatusResponse,
   CreateVoiceCloneRequestFull,
   VoiceCloneListParams,
+  VoiceClonePreviewResponse,
 } from "./types"
 
 // 工具函数
@@ -29,4 +30,5 @@ export {
   updateVoiceClone,
   getVoiceCloneStatus,
   retryVoiceClone,
+  getVoiceClonePreview,
 } from "./clones"

apps/web/src/api/voice-clone/types.ts

@@ -90,3 +90,24 @@ export interface VoiceCloneListParams {
   skip?: number
   limit?: number
 }
+
+/** 克隆音色试听响应 */
+export interface VoiceClonePreviewResponse {
+  clone_id: string
+  /** 音色克隆档案 ID */
+
+  voice_id: string
+  /** CosyVoice 音色 ID */
+
+  audio_url: string
+  /** 试听音频 URL */
+
+  text: string
+  /** 试听文本 */
+
+  duration: number
+  /** 音频时长（秒） */
+
+  file_size: number
+  /** 文件大小（字节） */
+}