跳到教程正文
画境使用教程
常见问题返回插件列表

画境插件 2.0.8 · 字字动画 9.x

在字字动画中使用画境

从安装到第一张图片、第一段视频,跟着下面的步骤完成。一个安装包同时包含图片和视频插件。

还没安装字字动画?可从字字动画官网下载。旧版软件建议先升级到 9.x。

01

先找到软件实际读取的插件目录

  1. 完全退出字字动画,解压上方下载的画境插件 ZIP。
  2. 找到你实际启动的那份字字动画。若有多份解压目录,先从桌面快捷方式的“打开文件所在的位置”核对。
  3. 找到软件实际使用的 user_resources/plugins 目录。部分 9.1.x 解压版在 _internal 中;本次在 9.1.50 本机验证使用下方位置。其他版本优先使用软件提供的插件目录入口或官方说明。
  4. 把包内 user_resources/plugins 下的 image_plugins 和 video_plugins 合并到这个目录,保留原配置和任务记录。
  5. 重启后,在图片/视频模型管理的“自定义插件”中分别选择画境图像插件和画境视频插件。设置页顶部应显示 v2.0.8。
9.1.50 解压版,本次验证使用的目录
字字动画安装目录/
├─ 字字动画.exe
└─ _internal/
   └─ user_resources/
      └─ plugins/
         ├─ image_plugins/huajing-image-plugin/
         │  ├─ main.py
         │  ├─ huajing_runtime.py
         │  ├─ info.json
         │  └─ ui/index.html
         └─ video_plugins/huajing-video-plugin/
            ├─ main.py
            ├─ huajing_runtime.py
            ├─ info.json
            └─ ui/index.html

部分版本使用程序目录下的 user_resources/plugins。判断依据是当前软件实际扫描的位置;只把文件放到另一份软件,或多套一层 user_resources,都可能导致列表里看不到插件。

已经装过,怎么升级?

先备份旧插件目录并完全退出软件,再合并本次程序文件。保留 config.json、huajing-account.json、huajing-tasks.sqlite。安装包不含你的密钥或任务数据库。重启后核对页面版本。

02

准备一把画境 API Key

  1. 登录画境,打开API 密钥页面。
  2. 创建一把供字字动画使用的密钥,名称可以填写“字字动画”。
  3. 如果图片和视频都要使用,选择不限模型、不限用途。只允许图片的密钥用于图片,只允许视频的密钥用于视频。
  4. 复制新建的 API Key,下一步粘贴到插件设置。

经典版入口:开发与帮助 → API 密钥。新版入口:左下角头像 → 开发者 → API 密钥。插件生成使用画境账户余额,可在充值页面补充额度。

密钥用于访问你的画境账户,请自行保存;反馈问题时隐藏密钥,避免发送填写过密钥的配置文件。

03

先查询到余额,再开始创作

  1. 打开画境插件的账号与网络。
  2. 粘贴自己的 API 密钥。网络不确定时,先保持直接连接。
  3. 点击测试连接,查询余额。这个按钮会先保存设置;只读取模型、配置和余额,不创建生成任务、不扣生成费用。
  4. 看到“已连接”和余额后,在生成设置选择模型、比例、清晰度,再回分镜生成。
生成设置模型、比例、清晰度、素材与时长
账号与网络密钥、余额和连接方式
任务记录查询并恢复原来的任务
使用帮助可搜索的安装和故障解答

参数更改后自动保存。接口地址已内置,填写自己的画境密钥即可。图片与视频共用时,确认密钥允许两类用途和模型。

↗

网络怎么选?看你的实际情况

先试这个

直接连接

平时不使用 VPN,或 VPN 已接管整个电脑网络。点击查询余额,成功就保持即可。

网页能打开,插件报错

帮我连接 VPN

让 VPN 显示“已连接”,点“检测这台电脑的 VPN 代理”。检测成功自动保存,再测试余额。

我知道代理端口

手动填写代理

到 VPN 设置找 HTTP/Mixed 端口,填入这台电脑的真实地址,例如 http://127.0.0.1:7890。7890 只是格式示例。

每台电脑自己检测,地址和端口以本机为准。换了电脑、VPN 或端口后重新检测。只开 TUN/虚拟网卡而检测不到代理时,先选“直接连接”测试。

查看完整网络教程和 10054 排查步骤 →

04

回到分镜,生成第一张图片

  1. 在字字动画中打开或创建作品,选中一个分镜。
  2. 把图片生成模型选为画境图像插件,填写这个分镜的图片提示词。
  3. 第一次可使用“自动选择当前密钥可用模型”,按作品需要选择画面比例和分辨率,并保存插件设置。
  4. 先选一个分镜执行图片生成。完成后,插件会把成品下载到原作品目录,供字字动画继续使用。
可以试试这条图片提示词

一只白色小猫坐在窗边,午后柔和的阳光,干净的室内背景,写实摄影。

想用参考图,应该放在哪里?

把参考图添加到字字动画分镜的参考素材中。在插件“参考素材”里选择自动使用分镜素材(推荐);仅文字生成时,可选择仅按文字生成。参考图数量按当前账户和软件限制处理。

05

选择视频插件,生成一段视频

  1. 把视频生成模型选为画境视频插件,在分镜中填写视频提示词。
  2. 在插件设置中选择当前密钥可用的模型、画面比例和分辨率。
  3. 第一次可把“视频时长”设为自己指定秒数,先选择 5 秒。其他时长和参数以连接时读取的配置为准。
  4. 保存设置,回到分镜执行视频生成。等待任务完成并下载,成品会保存到原作品目录。
可以试试这条视频提示词

镜头缓慢推进,窗边的白色小猫轻轻转头,阳光在毛发上移动,动作自然,画面稳定。

参考素材怎么选
想要的效果在字字动画与插件中操作
只按文字生成填写视频提示词;参考素材选择“仅按文字生成”。
让图片动起来给分镜添加参考图;参考素材选择“自动使用分镜素材(推荐)”。
指定开头或结尾画面设置首帧或首尾帧,插件选择“首帧 / 首尾帧”。
使用音频或视频参考添加到分镜参考素材,选择自动模式。音频参考需搭配图片或视频;首尾帧模式与音视频参考分开使用。

普通图片全能参考请保持“声音设置 → 同时生成声音”关闭;首尾帧、视频或音频参考时再按需开启。当前包支持 MiniMax H3。可用时长、清晰度、参考数量与声音开关,以插件连接后显示的配置为准。生成费用以画境实时价格和账单为准。

06

批量创作,或接着取回已有任务

视频提交中断后继续原任务

2.0.3 起会保存提交编号,连接中断后自动核对。再次运行同一次分镜任务或在任务记录中点击“检查并继续”,会恢复原提交,避免重复创建和扣费。本地参考素材会逐个上传并自动复用。

旧版没有提交编号的记录,请先核对画境任务:已有任务可关联编号恢复;确认没有对应云端任务后,可在任务记录中解除旧版未提交记录,再批量重试。

先跑通一个分镜,再批量生成

确认单个分镜正常后,使用字字动画已有的多分镜、批量生成功能。插件“批量与高级设置”中可调整同时处理几个分镜;建议先保持默认值,实际同时运行数量还受软件和账户限制。

断网或下载中断后,查询原任务

  1. 打开插件的任务记录。
  2. 点击刷新任务记录,找到对应任务。
  3. 点击查询并恢复到原作品,继续查询或下载原任务。

恢复查询不会重新发起生成。新版首次提交断线时,可在任务记录点“检查并继续”,按原提交编号核对。旧版没有编号的记录,先到画境生成历史核对,再关联或确认未提交后解除。

下载完成后可继续在原作品中使用。若字字动画已结束原来的生成位置,可从原项目目录导入文件。云端作品与素材有保存期限,请及时取回并保管本地文件。

打开完整常见问题解答 →

?

遇到问题,先看这里

重启后还是找不到画境插件

核对启动的软件目录、实际使用的插件目录和页面版本。部分 9.1.x 的插件目录位于 _internal/user_resources/plugins。插件文件夹内应直接有 main.py 和 info.json,不要多套一层目录。按本页安装示意重新检查。

提示密钥错误、余额不足,或者没有可用模型

重新复制画境 API Key,检查前后是否多了空格,保存后再测试连接。到画境确认密钥仍有效、账户有余额,且密钥用途与所选图片或视频模型一致。想共用一把密钥时,检查是否设置为“不限模型、不限用途”。

测试连接成功,回到分镜还是用到了其他模型

测试连接只确认画境插件的设置。请在当前作品的图片或视频模型选择处,明确选中对应的画境插件,并保存设置后再生成。

插件设置页面打开后提示要在软件中使用

请从字字动画的模型插件设置中打开。直接在浏览器打开安装包里的 ui/index.html,不会接入软件的分镜与任务功能。

任务等待很久,应该再点一次生成吗?

先查看“任务记录”或画境生成历史。任务已有编号时,优先查询并恢复原任务;新版会按固定提交编号核对已有记录;优先从任务记录继续。旧版记录先核对网页历史。