Skip to content

PRINTFILM: AI short-video marketing and AI short-drama creation platform

6.5 KB
Raw Blame
/** 独立创作工具 API:/api/tools/* */

import { throwApiError } from '../lib/apiError'
import { API_BASE, createJsonRequester } from './client'
import { apiErrorMessage } from './http'
import type { DramaAsset } from './drama'
import type { AssetDetailReference } from '../lib/assetDetailReferences'

/** 工具请求统一处理登录失效;仅生成入口沿用全局计费提示。 */
function requestToolJson<T>(
  path: string,
  fallback: string,
  init?: RequestInit,
  notifyBilling = false,
): Promise<T> {
  return createJsonRequester((response, detail) => {
    if (response.status === 401) throw new Error('未登录')
    if (notifyBilling) throwApiError(response.status, detail, fallback)
    throw new Error(apiErrorMessage(detail, fallback))
  })<T>(path, init)
}

export type ToolRunResult = {
  kind: string
  urls: string[]
  task_id?: string | null
  status: string
  preview_url?: string | null
  message?: string | null
}

export type ToolTaskResult = {
  status: string
  kind: string
  urls: string[]
  error?: string | null
}

export type ToolRunRecord = {
  id: number
  source?: 'task' | 'tool'
  record_key?: string
  domain?: string | null
  task_type?: string | null
  text_content?: string | null
  billing_status?: string | null
  tool_id: string
  kind: string
  status: string
  prompt: string
  preview_url?: string | null
  urls: string[]
  task_id?: string | null
  params?: Record<string, unknown> | null
  references?: AssetDetailReference[]
  error?: string | null
  created_at: string
  platform_task_id?: number | null
  provider_task_id?: string | null
  provider_name?: string | null
  provider_status?: string | null
  queue_type?: string | null
  started_at?: string | null
  finished_at?: string | null
  billing_charged_fen?: number | null
}

export type ToolRunList = {
  items: ToolRunRecord[]
  total: number
  page: number
  page_size: number
  counts?: Record<string, number>
}

// 将 /static 相对路径补全为可访问地址
export function resolveToolMediaUrl(url?: string | null): string {
  if (!url) return ''
  if (url.startsWith('http://') || url.startsWith('https://') || url.startsWith('data:')) {
    return url
  }
  if (url.startsWith('/')) return `${API_BASE}${url}`
  return url
}

export type ToolRunPayload = {
  modelId?: string
  resolution?: string
  toolId: string
  prompt?: string
  negative?: string
  ratio?: string
  strength?: string
  mode?: string
  pack?: string
  duration?: string
  motion?: string
  voice?: string
  files?: File[]
  videoMode?: 'text_to_video' | 'first_last_frame' | 'omni_reference'
  references?: ToolReferenceInput[]
  priceVersion?: number
}

/** 上传仅提交文件索引,资产仅提交 ID;媒体地址由服务端校验归属后读取。 */
export type ToolReferenceInput = {
  role: 'first_frame' | 'last_frame' | 'reference_image' | 'reference_video' | 'reference_audio'
  file_index?: number
  asset_id?: number
}

export type ToolReferenceAsset = DramaAsset & { media_kind: 'image' | 'video' | 'audio' }
export type StudioToolEstimatePayload = {
  tool_id: string
  model_id: string
  resolution: string
  ratio: string
  duration: string
  video_mode: NonNullable<ToolRunPayload['videoMode']>
  references: ToolReferenceInput[]
}
export type StudioToolEstimate = {
  estimate_fen: number
  estimate_yuan: number | string
  billing_enabled: boolean
  billing_mode: 'fixed_media' | 'legacy'
  price_version: number | null
}

/** 生成前只读报价,不上传媒体、不创建任务或冻结余额。 */
export function estimateStudioTool(payload: StudioToolEstimatePayload, signal?: AbortSignal): Promise<StudioToolEstimate> {
  return requestToolJson('/api/tools/estimate', '预计消耗暂不可用', { method: 'POST', body: JSON.stringify(payload), signal })
}

/** 服务端分页查询当前用户可引用的资产媒体。 */
export function listToolReferenceAssets({ kind, q = '', page = 1, pageSize = 24 }: {
  kind?: 'image' | 'video' | 'audio'; q?: string; page?: number; pageSize?: number
}, signal?: AbortSignal): Promise<{ items: ToolReferenceAsset[]; total: number; page: number; page_size: number }> {
  const qs = new URLSearchParams({ page: String(page), page_size: String(pageSize) })
  if (kind) qs.set('kind', kind)
  if (q) qs.set('q', q)
  return requestToolJson(`/api/tools/reference-assets?${qs}`, '加载资产库失败', { signal })
}

// 提交工具生成(multipart)
export async function runStudioTool(payload: ToolRunPayload): Promise<ToolRunResult> {
  const body = new FormData()
  body.append('tool_id', payload.toolId)
  body.append('model_id', payload.modelId || '')
  body.append('resolution', payload.resolution || '')
  body.append('prompt', payload.prompt || '')
  body.append('negative', payload.negative || '')
  body.append('ratio', payload.ratio || '')
  body.append('strength', payload.strength || '')
  body.append('mode', payload.mode || '')
  body.append('pack', payload.pack || '')
  body.append('duration', payload.duration || '')
  body.append('motion', payload.motion || '')
  body.append('voice', payload.voice || 'narrator_calm')
  if (payload.videoMode) body.append('video_mode', payload.videoMode)
  if (payload.references) body.append('references', JSON.stringify(payload.references))
  if (payload.priceVersion !== undefined) body.append('price_version', String(payload.priceVersion))
  for (const file of payload.files || []) {
    body.append('files', file)
  }
  return requestToolJson('/api/tools/run', '生成失败', { method: 'POST', body }, true)
}

// 查询视频任务状态
export async function pollStudioToolTask(taskId: string): Promise<ToolTaskResult> {
  return requestToolJson(`/api/tools/tasks/${encodeURIComponent(taskId)}`, '查询失败')
}

// 个人中心:分页拉取工具创作记录
export type ToolRunFilters = { kind?: string; status?: string; task_id?: string; created_from?: string; created_to?: string }

export async function listToolRuns(page = 1, pageSize = 8, filters: ToolRunFilters = {}): Promise<ToolRunList> {
  const qs = new URLSearchParams({ page: String(page), page_size: String(pageSize) })
  for (const [key, value] of Object.entries(filters)) if (value) qs.set(key, value)
  return requestToolJson(`/api/tools/runs?${qs}`, '加载失败')
}

export async function getGenerationConfig(): Promise<{ models: Record<string, string> }> {
  return requestToolJson('/api/tools/config', '加载模型配置失败')
}

// 个人中心:单条创作详情(含 OSS 结果地址)
export async function getToolRun(runId: number): Promise<ToolRunRecord> {
  return requestToolJson(`/api/tools/runs/${runId}`, '加载失败')
}