xiaoxia-saas/apps/web/src/api/generation/finalize.ts

import apiClient from "../client"

/** #2024 Step5 「完成」入库 —— 将 awaiting_cover 任务正式写入成品库 */
export interface FinalizeGenerationRequest {
  /** 用户选定的封面图片 URL；为空则使用任务默认封面（自动截帧/智能封面） */
  cover_url?: string
  /** 用户自定义成片标题，非空时覆盖 rendered_output.name */
  custom_title?: string
}

export interface FinalizeGenerationResponse {
  video_id: string
  project_id: string
  name: string
  file_size: number
  duration: number
  thumbnail_url: string
  cover_url: string
  file_url: string
  width: number
  height: number
  fps: number
  /** success=新建成功；already_finalized=幂等返回已有记录 */
  status: string
  is_duplicate: boolean
}

export const finalizeGeneration = async (
  taskId: string,
  params: FinalizeGenerationRequest = {},
): Promise<FinalizeGenerationResponse> => {
  const response = await apiClient.post<FinalizeGenerationResponse>(
    `/generation/tasks/${taskId}/finalize`,
    params,
  )
  return response.data
}