校验 API Key 或打开本机登录页。未配置 Key 时浏览器访问本机 /auth，验证码与登录由 MCP 转发到 FLASH_CAST_API_BASE（默认 https://share.skyxhome.com）。联调本机后端时设置 FLASH_CAST_API_BASE=http://localhost:8080。登录成功后自动创建并保存 API Key。

（可选）列出平台内置 HTML 视频模板，供需要「参考版式」时使用。用户也可完全不用模板、自行提供任意符合闪映规范的 HTML。

（可选）获取某个内置模板的规范与示例，仅在用户希望基于模板生成 HTML 时调用；非流程必需步骤。

创建一个新的视频项目，返回 projectId。后续所有操作都基于此 projectId。触发会员/试用检查。

上传 HTML 内容到项目。支持直接传入 HTML 字符串或本地文件路径。返回幻灯片数量、每页文本摘要和结构性警告。

上传图片或视频到 OSS，返回 ossKey、signedUrl（默认可为公网直链，字段名不变）、时长与「时间轴/原声」提示。视频在后端会转码为 H.264 MP4（便于录屏解码），写入 HTML 时 src 用返回的 URL；不写入 FFmpeg overlay。视频建议 5–15 秒；时长硬上限 10 分钟，单文件上限见 get_material_guidelines。

读取平台对嵌入 HTML 的素材时长、pageMarks 与「视频原声」的约定说明（无需上传）。生成 HTML / 划分 pageMarks 前应先调用。

返回所有可用配音音色，含 id、name、gender、trait（特质描述）、description、tags、suggestedFor 等元数据。AI 据此自动匹配最适合内容调性的音色。

设置项目的配音配置、解说文案与声画同步 pageMarks；可选 page_holds：在某段 TTS 结束后插入「画面停留 + 可选旁白或静音」。若某项含可读 narration：对该文案单独 TTS，音长以实测为准（用于解说演示）；若无 narration 或仅空白：用 durationMs 纯静音停留。afterChar 必须等于某段口播结束下标（charEnd）；纯静音时 durationMs 建议 ≥ 嵌入视频时长（200~120000）；整段 TTS+holds 粗估上限 10 分钟。多页口播前须自行划分 page_marks。渲染前须让用户在本机预览页核对，请调用 get_render_preview。

渲染前必须：拉取当前项目的 HTML 与配音文案等摘要，并返回本机只读预览页 URL。请先让用户在浏览器打开 previewUrl 核对；用户口头确认无误后，再在 render_video 中传入 user_confirmed_content: true。

触发视频渲染（TTS + 录屏 + 混音，约 2-10 分钟）。必须先 get_render_preview 并由用户确认；user_confirmed_content 必须为 true。返回 progressUrl 与本机进度页。

强制重新渲染视频（会扣除额度）。当用户修改了 HTML 素材、配音文案或音色后需要重新生成，或者对上一次渲染结果不满意想要重做时使用。调用前必须明确告知用户：此操作将消耗 1 次渲染额度。如果项目当前正在渲染中则拒绝（须等渲染完成或失败后才能重新触发）。

查询渲染状态。渲染中返回进度百分比和步骤描述；完成后返回视频下载链接。建议每 15 秒轮询一次。

分析抖音视频：输入分享链接，提取口播文案 + 爆款结构解析。结果存入项目。消耗 AI 算力，非订阅会员每项目上限 3 次。耗时约 35-130 秒。