📖 镜语马 · 用户使用指南

产品简介

镜语马批量分镜工具是一款专为短剧、动漫、短视频创作者设计的SaaS服务。您只需输入小说或剧本片段，系统即可自动将其拆解为结构化的分镜表格，包含以下信息：

• 镜头编号：按顺序排列的镜头序号
• 原句：原文片段
• 台词：提取出的对话（如有）
• 预估时长：基于内容自动计算的建议时长
• 分镜描述：为摄影或绘画提供的可视化描述

此外，每个镜头行都配有独立的 操作按钮（编辑 / 刷新 / 举报 / 复审），方便您对单个镜头进行精细化调整。

快速开始

1. 访问官网：打开 shotstory.cn 并完成注册。
2. 准备文本：复制您想要分镜的小说或剧本片段（建议不超过10000字符）。
3. 选择模式：根据创作需求，选择快速、情绪或题材模式。
4. 生成分镜：将文本粘贴到输入框，点击“生成分镜”按钮，系统将自动处理并返回结构化表格。
5. 查看与操作：生成结果直接显示在页面上，您可对每个镜头进行编辑、刷新、举报或申请复审。
6. 导出：支持复制、导出为 Midjourney / Stable Diffusion 提示词，或导出 ComfyUI 工作流 JSON 文件。

网页版 vs API 版

镜语马提供两种使用方式，满足不同场景需求：

🌐 网页版（适合个人创作者）

• 直接在浏览器中访问 shotstory.cn，注册后即可使用。
• 所见即所得，所有操作（生成、编辑、刷新、举报、复审）均通过图形界面完成。
• 适合快速创作、预览和微调。

🔌 API 版（适合开发者、批量处理）

• 通过 RESTful API 调用，支持 POST /api/v1/generate 生成分镜、POST /api/v1/rotate_variant 刷新变体、POST /api/v1/appeal 提交复审等接口。
• 您需要先在网页端生成 API Key，然后在请求头中携带 X-API-Key 进行认证。
• 适合集成到自己的工具链、批量处理大量文本或二次开发。

自动检测题材

在“题材模式”下，您无需手动输入题材类别。系统会根据您输入的文本内容，自动识别并推荐最匹配的题材（如“古风仙侠”、“都市言情”等），一键填充，省去手动选择的步骤。

若未检测到明确题材，系统会提示您手动选择。支持的题材列表详见下方说明。

模式介绍

模式	说明	适用场景
快速模式	直接拆分文本，生成中性描述	快速预览、草稿
情绪模式	根据指定情绪（如“孤独落寞”）调整分镜氛围	情感细腻的叙事
题材模式	根据指定题材（如“古风仙侠”）优化描述风格，支持自动检测	类型化创作

如何选择情绪和题材？

• 情绪可选值：治愈温暖、慵懒松弛、热血激昂、平静淡漠、绝望崩溃、紧张恐惧、孤独落寞、愤怒暴躁、悲伤压抑、暧昧心动
• 题材可选值：穿越系统、盗墓探险、都市言情、古风仙侠、军事战争、科幻赛博、历史权谋、末日废土、末世觉醒系统、末世丧尸、热血玄幻、田园乡土、无限流副本、武侠江湖、西方奇幻、校园青春、星际科幻、悬疑惊悚、游戏穿越、政务校园、都市重生系统

结果解读

生成的分镜表格包含五个核心字段，您可以直接在页面中查看、编辑或复制。例如：

镜头编号	原句	台词	时长	分镜描述
001	夜色如墨，他独自站在天台上...	无	3.0秒	夜景，城市天际线，孤独的人物剪影

按镜头操作

生成分镜表格后，您可以在每个镜头行对单个镜头进行精细化操作：

✏️ 编辑分镜

点击编辑按钮，可直接修改当前镜头的分镜描述文本。系统会保留您的修改记录，方便后续比对和微调。适合对 AI 生成结果进行人工润色的场景。

🔄 刷新描述

点击刷新按钮，系统会基于当前镜头原句、模式和情绪/题材重新生成一组新的分镜描述。在情绪模式或题材模式下，每次刷新都会消耗少量积分（约等于原句字数），但会轮换不同的表达方式。

💡 刷新次数不限，您可反复尝试直到满意为止。

🚩 举报与反馈

点击举报按钮，可提交该镜头的违规或不当内容举报。填写举报原因后，管理员会在后台审核。每个用户每天最多举报 3 次，请合理使用。

👁️ 申请复审

当您认为某个镜头被误判为违规时，可提交复审申请。管理员审核通过后，该原句将被加入释放库（白名单），后续不再被屏蔽，且可正常使用“刷新描述”功能。

导出与分享

生成的分镜表格支持多种导出方式：

• 复制：点击镜头行内的复制按钮，可单独复制该行的分镜描述。
• Midjourney / Stable Diffusion 提示词导出：在结果页面底部选择导出格式，系统将自动把分镜描述转换为对应的 AI 绘画提示词格式。
• ComfyUI 工作流：支持导出为 ComfyUI 可读取的 JSON 工作流文件，方便直接接入专业 AI 绘画管线。

计费与免费额度

• 每日签到：登录后点击“签到”按钮，每日可领取 300 免费积分。签到状态按自然日刷新，连续签到不影响奖励额度。
• 新用户注册即送 100 积分（约可生成 1 个常规镜头，配合签到可获得更多）。
• 付费充值可选择不同档位，详见官网充值页面。
• 每次生成消耗的积分约等于输入文本的字符数（违规内容会额外扣 10%）。
• 刷新描述会额外扣除对应镜头字数的积分，其他操作（编辑 / 举报 / 复审）不消耗积分。

常见问题

• 如何处理超过 10000 字符的文本？ → 请分段提交，或截取前 10000 字符。
• 生成的镜头数有限制吗？ → 根据您的套餐决定（免费版最多 10 个镜头，付费版更高）。
• 支持哪些导出格式？ → 目前页面直接显示表格，可复制到文本编辑器，且可一键导出多种格式。
• 积分用完了怎么办？ → 可访问官网充值，或等待次日免费额度刷新。
• 刷新描述消耗多少积分？ → 约等于当前镜头原句的字符数，情绪和题材模式下消耗相同。
• 举报后多久处理？ → 管理员将在 24 小时内审核并反馈处理结果。
• API 版如何获取 API Key？ → 登录网页版后，在“API 管理”页面生成和管理您的 API Key。