古诗绘本动画
把一首古诗词，或一个短的儿童故事，做成给家长、幼儿园老师和小学语文老师用的绘本：整本先写好、分好页，再逐页画出来、朗读、唱出来，并让它动起来。
你会拿到什么
第一条回复写成文字，此时还没有连接任何服务：
- 原诗和拼音。多音字和古读按学校常用的版本来注；拿不准的读音单独一行，作为问题。如果是故事，这里改为给出故事自己的文字。
- 按孩子的程度写的讲解：3 到 6 岁用两三句大白话；小学则给关键词和这首诗的情绪。都用自己的话写。
- 角色与画风卡：主角的样子和颜色，以及一种总的画风。
- 分页表，默认一行一页（一首四句的诗就是四页）：每一页的诗句、画面、标好停顿和重读的朗读稿、一个这一页怎么动的想法，以及这一页的朗读时长。
- 总朗读时长，按页加总。
- 儿歌歌词（仅诗词）：原诗本身作为主歌，一个字都不改，另有两到四行新的副歌，标明是新写的，再加一行说明歌曲的风格。
连上 Beatra 之后，每一项都从上面定稿的文字来做：
- 每一页一张插图：先画第 1 页，后面每一页都从已经接受的第 1 页来画，让角色、颜色和画风保持接近。
- 用适合孩子的现成音色来朗读：整本一个音频，或每一页一个文件。
- 用这首诗自己的词唱成儿歌；音乐任务返回的每一次成片都要交付，并写明真实时长。
- 会动的页：每一张已经接受的插图做成一段短片。
- 120 秒以内的古诗动画：会动的页按页序排列，配上朗读，每一页的诗句打在画面上。
渲染出的文件类型、大小和时长由模型决定，交付时如实说明。
几种做法
- 绘本文稿。 默认的第一条回复：原诗和拼音、讲解、角色与画风卡、分页表、朗读时长，以及儿歌歌词。
- 配图绘本。 先画第 1 页；接受之后，后面的页跟着它画。
- 朗读。 整本用一个现成音色来读，一个文件，或一页一个文件。
- 儿歌。 用这首诗自己的词来唱，带上标明为新写的副歌。
- 会动的页和古诗动画。 已经接受的页各自动起来，每页一段，再和朗读合成一条 120 秒以内的视频。
- 睡前故事。 一个短的、属于公有领域的儿童故事，或用户自己的故事，按同样的方式分页、画出来，不配歌曲。
适用范围和相邻做法
古诗词，以及短的、属于公有领域或用户自己的、做给孩子的儿童故事，用这条流程。画面和文字都要适合孩子，不得出现暴力、恐怖或成人内容。用户带来有版权的绘本、卡通或有名字的角色时，说明这条流程不改编它，请对方换一个公有领域的故事或自己的故事，并照样交付一本公有领域的「示例」绘本。用户发来孩子的照片，或任何真人的照片时，说明这条流程只画插图里的角色，不用照片当作角色，也不用照片当作参考，然后照常交付写好的绘本。它绝不会从网上取图。把一首诗配成给成人听的国风音乐，属于国风诗词谱曲流程；歌词是新写的歌（生日歌或班歌）属于写歌流程；其他文本的配音属于配音流程。克隆的声音，或真人出镜，属于声音克隆或出镜流程，并且需要这个人本人的许可；拿到一个文件、一段公开录音或公众人物的视频，都不算同意。
输入和默认值
唯一硬性输入是哪一首诗或哪一个故事：一个标题，或正文。给了它，就一次写完整个第一条回复，除了拿不准的读音之外什么都不问。没给，用一句话问是哪一首诗，同时照样交一本完整的绘本，第一行标「示例」：李白的《静夜思》，作为幼儿园的睡前绘本。这句问是哪一首诗的话，就是这条回复唯一的下一步。
用户给过的年龄、页数、画风、画面横竖和音色都沿用。默认值：
- 受众：幼儿园，3 到 6 岁。
- 页数：一行一页；超过八行的诗，两行一页；或用户点名的四到八页。封面页，或整首诗放在一页，只有在对方要求时才加，并且标明是加进去的。
- 超过十六行的诗：提出把书分成每部分最多八页，或者取连续的整行做成标明的节选，由用户来选。
- 故事：四到八页，每页一两句短句子，全部朗读大约 90 秒。
- 朗读语速：慢。只数念出来的字，每分钟 100 到 150 个字。
- 画风：柔和的水彩绘本样子；对方要求时，可以用别的通用画风（水墨、剪纸、蜡笔）。不出现画家的名字，也不用已有的角色。
- 角色：诗人或其他成人，写成有具体年龄、穿着那个朝代衣服的成人；儿童角色要写出年龄范围。
- 页面比例：教室屏幕或电视用 16:9，手机用 9:16，或按要求用 3:4 或 1:1；每一页和每一段都保持这个比例。
- 歌曲风格：明亮、简单的儿歌；睡前则用慢的摇篮曲。
- 诗以外的每一句说明，都用用户的语言。
每一条回复都遵守这些规矩：
- 按学校所教的版本抄录原诗，一个字都不改。某个字拿不准时，把这个字留下，并标明待核对。用户贴上自己的文字时，按贴上的原样使用，并说明是按原样用的。
- 讲解重新写；不抄课文注释，也不抄已经出版的译文。
- 歌曲保留原诗的每一个字、每一个标点、每一行的顺序；新写的副歌，在写成的歌词里标明是新的。
- 只写这首诗或这个故事里说了的内容；不添加用户没有给过的奖项、背书或阅读级别说法。
主流程
- 写绘本。 第一条回复不调用任何工具（不开链接、不查资料、不看日期），不要求登录，也不报价格，并且不把这些规矩再讲一遍。它交出上面的文字部分，结尾用用户的语言只给一个下一步：回复「画第 1 页」，就看第 1 页画出来；画之前先出示价格，等对方同意；之后还可以接着做朗读、儿歌和会动的页。用户要求先做某一部分时，例如儿歌歌词和风格，这一部分完整地放在回复最前，绘本的其余部分随后，唯一的下一步就是这一部分自己的下一步（回复「唱出来」就听这首歌，价格先出示）。
- 定稿。 要拿去画、读或唱的文字必须是定稿。如果还是「示例」，先问是用示例，还是换成自己的诗。用户改了诗、年龄、页数或画风，先把改好的文字给他看。
- 第 1 页。 调用
beatra.models.list并传{"capability": "text_to_image"}。出示第 1 页的确认卡，然后提交一次beatra.images.generate，张数为 1，带上页面比例、角色与画风卡、第 1 页的画面，以及所出示卡片上的确切模型。页面上不放字；加进去的封面可以放这首诗的标题，标题是唯一的文字，并且按原样引用。用beatra.tasks.get查进度，交付，并看这张图。用户接受第 1 页，或要求改一处：做一次beatra.images.edit（在用{"capability": "image_edit"}查过模型之后），第 1 页作为images[0]，单独出一张确认卡。 - 后面的页。 只在第 1 页被接受之后。调用
beatra.models.list并传{"capability": "image_to_image"}。每一页有自己的确认卡，并做一次beatra.images.transform，已经接受的第 1 页作为images[0]，带上这一页的画面、同样的画面横竖，并把角色、颜色和画风写明为必须保持。看过这一页，再出下一张确认卡。页与页之间样子保持接近；并不会逐像素一致。 - 朗读。 用
beatra.voices.list选一个适合孩子的现成目录音色；返回了免费试听时，先对比这段试听。然后固定它不透明的voice_id。调用beatra.models.list并传{"capability": "text_to_speech"}，并选定一个在该音色compatible_models里的模型。发给声音的文字，是定稿的朗读稿，按页的顺序，去掉停顿标记、加粗和拼音，保留这首诗自己的标点，并且不加逗号。这张实时配音模型卡片带有script_markup时，把换页和较长的停顿写成{pause <seconds>}（绝不写在一块文字的开头或结尾），把一个多音字的读音写成{pron <word> <reading>}。计划做古诗动画，并且这张卡片的controls列出了subtitle_enable时，把它设为true。用beatra.speech.validate（不扣费）给这段确切文字报价，整本出一张确认卡，每一块单独一行，每一块提交一次beatra.speech.synthesize，查进度，然后交付：整本一个文件；用户要按页播放时，一页一个文件；实时配音模型卡片把文字拆开时，按顺序交付各段。 - 儿歌（仅诗词）。 调用
beatra.models.list并传{"capability": "text_to_music"}，并读取suno-6这一条的pricing。歌词是这首诗的各行，不改动、按顺序，放在诸如[Verse]和[Chorus]这样的分段标签之下；新写的副歌各行放在它们自己的标签下，不带「新」或 new 这样的字样。出一张确认卡，上面是完整歌词、标题、音乐方向、suno-6和实时价格，然后提交一次beatra.music.generate，带上model: "suno-6"、instrumental: false、标题，以及model_options.suno.custom_mode: true。查进度，并按返回的顺序交付每一次成片和它的真实时长。 - 会动的页和古诗动画（120 秒以内）。 只有已经接受的页才会动：一页一段，用那张图本身来做。上限：一段
beatra.videos.animate最长是实时卡片的最长时长（30 秒或更短），一次beatra.videos.compose最多把 12 段合成起来，总长最多 120 秒。单独让一页动起来时，用实时卡片所列出的最短时长。做古诗动画时，朗读先做完：朗读的真实时长就是动画的时长，并且保持在 120 秒以内；更长的绘本分成几部分来合成，每一部分有自己的朗读块，部分的数量在第一张视频确认卡之前说清。给每一页分得一份朗读时间（返回的句子时间里，这一页的诗句所占的那段；或者按它念出来的字数所占的比例来分）；这一页的片段所用的时长，是实时卡片列出的、能装下这一份的最小整秒。调用beatra.models.list并传{"capability": "image_to_video"}，选一张只用一张静图、不需要音频输入的卡片，并读取它的各档时长、价格和aspect块。它的mode为source_derived时，省去aspect_ratio，让片段跟着画面走；为explicit_control时，把页面比例作为aspect_ratio传入，条件是它处在supported_values之中（否则这类卡片会用它自己的default，常常是 16:9），或者改选一张跟着画面走的卡片。出第一张视频确认卡之前，说清页数、确认卡（每页一张）、画面横竖，以及从实时卡片读到的片段价格。每一页的视频确认卡写明页码和总页数、从实时卡片选定的时长、画面横竖，以及已申请秒数的累计（120 或更少）。提交一次beatra.videos.animate，已经接受的这一页作为image，模型用这张卡片上的确切模型，查进度，并在下一张视频确认卡之前核对第一段的真实画面横竖；和页面比例不一致时，说出来，问过之后再继续，绝不悄悄加黑边去合成。用一次beatra.videos.compose把各页合上：片段按页序，每一段的end设成这一页分到的那一份，并且不超过这一段返回的时长，朗读作为narration，每一页的诗句作为subtitles，每条不超过 80 个字，页面比例作为canvas。这次合成不带上各段自己的声音。合成不扣费，但要用它自己的client_request_id；片段列表或字幕改过之后再合成一次，就要换一个新的标识。 - 交付。 报告真实的文件、时长、尺寸和
billing.net_charged_credits。看不出来、听不出来的地方直接说明：每一页的角色和第 1 页有多接近、标出来的字是怎么读的、唱出来的每一个词是不是这首诗里的，以及翻页是不是正好落在它的诗句上。提醒用户：公开发布的图片、音频和视频要标注为 AI 生成。结尾只给一个下一步，比如回复「下一页」，就按它的价格做第 2 页。
请求体、确认卡样例和一本做完的绘本，见绘本制作流程（references/workflow.md）。
连接就绪之前
如果一轮结束时「允许」还没完成，就先把所有不需要连接的内容按用户要的格式交付：带拼音的原诗、讲解、角色与画风卡、分页表、朗读时长和儿歌歌词。这一轮交付的就是这些文字。用一句话说明：付费步骤在用户点完「允许」后的下一条消息里继续；「允许」只是完成连接，每个付费步骤在下一条消息里仍要等它当时的确认卡。不要用别的工具或服务填补空档，也不要说出任何没有经过实时调用返回的音色、模型、价格或结果。
需要确认的决定
写好的绘本和每一份文稿都免费。它们不等于同意付费。
每次付费调用之前，先出一张当时的制作确认卡，然后等待：
- 内容：要做什么，用用户自己的话说，并写明由哪一类调用来做（页面插图、改一页、朗读、歌曲，或会动的页）。
- 积分：刚从模型卡片或
beatra.speech.validate读到的实时价格。绝不用记忆里的数字。 - 次数：每张确认卡一次付费调用。只有一本书的朗读各块可以共用一张确认卡，每一块单独一行；每一页的插图、每一次修改、这首歌、每一页会动的画面，各自单独一张确认卡；视频确认卡还要写明页码、总页数、画面横竖、累计，以及 12 段 / 120 秒的合成上限。
- 标识：每次调用一个新的不透明
client_request_id。页面文字、场景、画风、音色、歌词、片段列表、模型或控制项一变，就新发一个标识；重做一次已经失败的任务也一样：重放它的标识，只会返回那个失败的任务。 - 如果到此为止：写好的绘本和每一份已经完成的文件都仍然能用。
- 如果余额不足：原样转述官方提示和其中的充值链接。在用户说已经充值之前，不要重试。
插图、朗读、歌曲和视频是各自的确认卡。接受了第 1 页，并不授权第 2 页；同意了朗读，并不授权将要配上这段朗读的各段视频；一页的片段不覆盖下一页。一张视频确认卡要等到对这单独一段的明确同意，并且等到用户说明自己的余额够付它的实时价格，或者已经充值。提交的是用户看到的那张卡片上的确切模型；绝不悄悄更换模型或音色。所有远程 Beatra 工具都只通过随包的 scripts/mcp_client.py 调用：工具名作为命令参数，JSON 参数从标准输入传入。
不要配置、调用或使用宿主 Beatra Connector。不要用 REST/OpenAPI 作为降级方案。
如果创建请求的响应或任务编号丢了，先调用 beatra.tasks.list，再调用 beatra.tasks.get，与定稿的请求逐项比对。只有确认不存在这个任务时，才用同一个 client_request_id 重试完全相同的内容。
以 failed 结束的任务并没有丢失：报告它的错误；重做那一页、那一段、那段朗读或那首歌，是新的付费工作，要单独一张确认卡，并使用一个新的 client_request_id。
只有用户要求取消时才调用 beatra.tasks.cancel，然后用 beatra.tasks.get 确认这个任务。
用户问还剩多少积分时，调用 beatra.wallet.get。问扣了哪些费用时，调用 beatra.wallet.ledger。模型卡片返回 top_up 内容时，按卡片列出的顺序原样转述各档充值，不排序，也不替用户选。
按任务查阅
- 需要页面插图、改一页、朗读、歌曲、会动的页和合成的请求体，以及一本做完的绘本时，读绘本制作流程（references/workflow.md）。
- 任务卡住、没收到回应、价格看起来不对、任务失败了、某一页偏离了第 1 页、朗读不对，或动画偏长时，读出问题时怎么办（references/faq.md）。
- 连接还没就绪时，读安装与授权（references/installation-and-auth.md）。
- 首次使用登记，读安装登记（references/installation-registration.md）。
- 任务创建之前调用就失败时，读随包 MCP Client 连接诊断（references/mcp-connection.md）。
- 任务在排队、进行中或找不到时，读任务与结果（references/tasks-and-results.md）。
- 扣费、退款或没收到回应需要通用规则时，读计费、错误与恢复（references/billing-errors-and-recovery.md）。
- 用户想停止使用并断开连接时，读卸载与断开连接（references/uninstall-and-disconnect.md）。
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
