字字动画插件
装两个插件、填一个 Key，就能在字字动画里直接选型号、填描述、出片出图。
插件只连本站（xyjingyuapi.com），按条 / 按张计费，失败自动退款。
下载插件包（视频 + 出图）
↓ 下载字字动画插件包 （含说明书）压缩包里：两个插件文件夹 + 说明书.md。 把它们复制到字字动画的插件目录即可（步骤见下面第一节），装完重启字字动画就能在插件下拉里看到。
一、安装
- 下载上面的压缩包，解压到任意目录（不要在压缩包里直接双击）。
- 把这两个文件夹分别复制过去（是文件夹里直接放
main.py，不要多套一层）：video_plugin_jingyu→<字字动画安装目录>\_internal\plugins\video_plugins\image_plugin_jingyu→<字字动画安装目录>\_internal\plugins\image_plugins\ - 重启字字动画。视频：右侧「视频模型管理」→ 插件下拉里选 鲸鱼AI 视频生成插件（API 站）；图片：生图引擎那一栏 → 鲸鱼AI 出图插件（API 站）。
- 在插件设置里填 API Key（
sk-开头，到 控制台 → 令牌 创建）， 点「测试连接」——会告诉你「能看到几个型号、其中视频/图片几个」。
0.15 变了什么（装过旧版的请务必换一次）：
治「选完型号根本没保存」（假选中）：以前选好型号、关掉面板再打开，会变回列表第一个 —— 因为插件用旧的内置型号表去认你选的型号，认不出就把配置改成第一个。现在认不出也保留你选的原值，下拉始终显示你选的那个，不会被悄悄换掉。
报错也说人话了：以前会看到
顺带修了根因：空的参考视频/音频字段会被上游判成「不支持的字段」（哪怕你没传视频），现在这三个字段有内容才发。
0.13 的「提交前核对型号」也在这个包里：提交前会用你自己的 Key 核一次在售清单 —— 型号不在清单里就当场拦下、不提交、不扣费，并告诉你该怎么改；同时把「提交型号」写进运行日志，以后能查是面板传错还是我们发错。
下拉也改了：以前线上清单没带显示名，下拉里全是
0.12 的「上传前压图（41.9 秒 → 2.3 秒）」也在这个包里：真机实测 4.2MB 的图 41.9 秒 → 2.3 秒（省 95%），9 张从约 6 分钟降到 20 秒。上传前先在本地把图压小（长边 1280、JPEG q85）——慢的真因是体积：参考图常是 1.5~4MB 的 PNG，而上传接口只收 base64（再涨 1/3）。
透明图和动图不碰（转 JPEG 会把透明背景压成黑色）、压不小就发原图、压不动也能用（自动退回原图上传，只是慢一点）。日志里能看到
0.11 的「大图并行挤断上行 → 按体积自适应」和 0.10 的「选型不生效 / 上传不重试」也都包在里面。 ① 「选什么型号都生成同一个型号」：以前面板拉完线上清单会重建下拉， 而重建只改了界面显示、没把选择写回配置 —— 界面显示你选的，实际提交用的是打开面板时的旧型号。 现在重建之后会把当前选中的型号写回去，看到什么就发什么。 ② 上传参考图快了、也不会一次抖动就整批失败：以前一张一张排队传、而且完全不重试， 一条连接被掐断就整批报错（英文栈
报错也说人话了：以前会看到
提交失败（HTTP 400）：{"code":"invalid_request","message":"unsupported request field: videos"} 这种英文加转义引号，现在会显示「这个型号不收参考视频……请去掉再提交，或换一个支持的型号」，并给出下一步。顺带修了根因：空的参考视频/音频字段会被上游判成「不支持的字段」（哪怕你没传视频），现在这三个字段有内容才发。
0.13 的「提交前核对型号」也在这个包里：提交前会用你自己的 Key 核一次在售清单 —— 型号不在清单里就当场拦下、不提交、不扣费，并告诉你该怎么改；同时把「提交型号」写进运行日志，以后能查是面板传错还是我们发错。
下拉也改了：以前线上清单没带显示名，下拉里全是
mj-2.0-720p-tj 这种内部代号，现在会显示描述并始终带上型号名，看到的名字就是写进代码的名字。0.12 的「上传前压图（41.9 秒 → 2.3 秒）」也在这个包里：真机实测 4.2MB 的图 41.9 秒 → 2.3 秒（省 95%），9 张从约 6 分钟降到 20 秒。上传前先在本地把图压小（长边 1280、JPEG q85）——慢的真因是体积：参考图常是 1.5~4MB 的 PNG，而上传接口只收 base64（再涨 1/3）。
透明图和动图不碰（转 JPEG 会把透明背景压成黑色）、压不小就发原图、压不动也能用（自动退回原图上传，只是慢一点）。日志里能看到
4242.9KB → 199.8KB。0.11 的「大图并行挤断上行 → 按体积自适应」和 0.10 的「选型不生效 / 上传不重试」也都包在里面。 ① 「选什么型号都生成同一个型号」：以前面板拉完线上清单会重建下拉， 而重建只改了界面显示、没把选择写回配置 —— 界面显示你选的，实际提交用的是打开面板时的旧型号。 现在重建之后会把当前选中的型号写回去，看到什么就发什么。 ② 上传参考图快了、也不会一次抖动就整批失败：以前一张一张排队传、而且完全不重试， 一条连接被掐断就整批报错（英文栈
Connection aborted / SSLError EOF）。
现在 3 张并行传、连接类错误自动重试 2 次、同一张图传过一次就不再重复传，
顺序仍按你给的顺序，@图片1 的编号不会乱。
③ 报错说人话：彻底传不上时会告诉你"网络连接被中断，已重试 N 次"，不再甩英文栈。
Key 和设置一个字节都没动，换上新包自动读回来。0.09 变了什么：
修的是"取不回片子"：以前把成片下载到本地时，只判断"写进了一点东西"——
片子一共 8MB，网断在中途只下了 2MB，插件也当成下好了，把文件交给字字动画。
那片 mp4 是半截的、没有索引，字字动画就是打不开、拉不进来；
而插件日志写着"成片已保存"、API 那边也写着成功，你完全看不出是哪一步坏的。
现在下载完会核对字节数、确认真的是视频、检查能不能播放，
任何一项不过都会接着下（支持断点续传，不用从头再来），实在下不下来会明确告诉你
"片子是好的，只是没下完"，并给出不重复扣费的处理办法。
Key 和设置一个字节都没动，0.09 装上去自动读回来。
0.08 变了什么（装过 0.07 的请换一次）：
参考图的大小限制放宽了：以前一镜超过 8MB 就提醒你压图，现在不用了 ——
我们在服务器上自动把每张压到长边 1920（一般 100~250KB）再交给模型，
出片效果不变。所以你直接把原图丢进来就行，9 张也照常一次带上。
顺带把上传上限从 8MB 提到 16MB/张。
Key 和设置一个字节都没动，0.08 装上去自动读回来。
0.07 变了什么（装过 0.06 的请换一次）：
多了提交前的提醒：参考图总量超 8MB 时，会在上传之前就告诉你"压一下图或多分两次"，
而不是让你白等半分钟再收到一句失败。因为图要先搬进我们自己的存储，
每 MB 约 2.5 秒，总量太大就会超时。
Key 和设置一个字节都没动，0.07 装上去自动读回来。
0.06 变了什么（装过 0.05 的请换一次）：
参考图以前只带第一张，现在分镜上的图全部带上（最多 9 张，首帧排最前）。
以前面板上写着"每镜只收 1 张参考图"—— 那句话是错的：接口一直就收多张，
是我们自己写窄了。多张参考图才能同时锁住人物、场景和表情，出片更贴你的分镜。
Key 和设置一个字节都没动，0.06 装上去自动读回来。
0.05 变了什么（装过 0.04 的请换一次）：
0.04 那个包有问题 —— 装上之后插件面板打不开：API Key 那栏是空的（看着像 Key 丢了，
其实没丢）、型号下拉点开里面什么都没有、「测试连接」点了没反应、生成时长也是空的。
原因是我们打包时把面板脚本写坏了一个字符，整段脚本没运行。
你的 Key 和设置一直存在字字里，一个字节都没动，0.05 装上去会自动读回来，
不用重新填。装上 0.05 后 0.04 修好的那些（一次只交一次任务、参考图自动认）都还在。
0.04 变了什么：点一次生成不会再交两次任务（以前同一镜被触发两次会
各扣一次钱，现在自动复用第一次，日志写明"没有第二次扣费"）；参考图认得字字的所有写法，
不用再手动补；插件面板的标签错位修好；设置里多了「清除本机保存的 Key」。
1.3.0 变了什么：画面比例现在会跟着提交一起发（以前只发像素、
由服务端反推比例，竖屏偶尔会被反推成横屏）；修好了提交时出现的
「这个视频渠道的型号必须带分辨率」报错；报错文案里不再出现我们的内部型号名。
升级不用重装：型号下拉是联网拉线上清单的。
我们上下架型号、改价格，你点一下「重新拉线上型号」就行，不用重新下载插件包。
二、视频插件 · 有哪些型号
型号和价格以面板里拉到的为准，这里不再列死清单。
我们上架/下架型号、调价格时，你点一下「重新拉线上型号」——面板里显示的就是当前真能用的，
型号名后面直接带「秒数 · 价格」。这张页面以前写死过一份型号表，
后来型号换了名字，客户照着旧表选就报
看不到想用的型号有两种可能：① 它确实下架了；② 那条供货通道被临时停用了 （停用的通道，它的型号不会出现在清单里，控制台也不会有）。
model_not_found，所以现在不写了。看不到想用的型号有两种可能：① 它确实下架了；② 那条供货通道被临时停用了 （停用的通道，它的型号不会出现在清单里，控制台也不会有）。
价格以插件下拉里显示的为准（那段是实时读线上数据的）。
三件必须知道的事
- 必须带参考图：全部型号都是「参考图 + 提示词」出片，没有纯文生视频。没给图插件当场提示，不提交、不扣钱。
- 每镜只收 1 张参考图：插件取「首帧」那一张。要多张参考图请用鲸鱼AI 软件端的画布/任务卡。
- 按条计费、固定时长：提交成功即扣一条；失败自动全额退。时长由型号决定，不能改。
画面比例与像素
| 比例 | 720p 型号 | 1080p 型号 |
|---|---|---|
| 16:9 横屏 | 1280×720 | 1792×1024 |
| 9:16 竖屏 | 720×1280 | 1024×1792 |
1080p 为什么不是 1920×1080？接口只接受这四个像素尺寸，别的尺寸会被挡掉、请求到不了模型。
四、出图插件 · 3 个型号
| 型号 | 价格 | 适合 |
|---|---|---|
gpt-image-2 | 0.20 元/张 | 最快最便宜，大批量资产图（约 1 分钟） |
gpt-image-2.5 | 0.25 元/张 | 细节更好一档，只贵 5 分 |
banana-2.1 | 0.40 元/张 | 风格化更强，适合封面 / 海报 |
三个都不收参考图。 这条通道只收提示词 —— 与其"你以为带上了、
出的图却跟你给的图无关"，插件会明确说不收，日志里也写「已忽略 N 张参考图」。
要锁人物 / 场景请用视频型号，或直接在提示词里把角色写清楚。
画面比例 16:9（1920×1088）· 9:16（1088×1920）· 1:1（1024×1024）。
选什么出什么，服务端不兜底。按张计费，失败自动退。
五、出问题了怎么办
插件设置页最下面有「看运行日志」—— 上传了几张、提交了什么、任务号、每次查询状态、 服务端原话，全在里面。先看它，90% 的问题一眼就能定位。
| 提示 | 怎么办 |
|---|---|
| API Key 无效或已停用 | 用本站的 sk- Key（控制台 → 令牌 新建）；主站那套 ak_ 在这里用不了 |
| 这一镜还没有参考图 | 视频型号必须带图，给分镜设一张参考图 |
| 型号维护中 / 已下架 | 点「重新拉线上型号」重选；维护中那种暂时不能用，放出来后自动恢复 |
| 参考图太大 / 上传失败 | 单张上限 8MB，只收 PNG/JPG/WEBP |
| 等了 120 分钟还没结果 | 别重跑（会再扣一次）；到控制台「日志」按任务号查，真失败会自动退款 |
| 余额不足 | 充值后再试；失败一律自动退 |
六、只写代码、不用插件？
那就是同一套 /v1/* 接口，用你熟悉的 OpenAI SDK 直接调 —— 见
接口文档。插件只是它的一层壳，参数完全一致。