6.4.0 — 版本更新日志
Agnes Video Generator 的版本发布记录：每个版本的新功能、改进与问题修复。
更新内容
新功能与改进
- 创意与文稿任务的预览（"dry-run"）端点 ——
POST /api/creative/preview-script与POST /api/manuscript/preview-split让你在提交完整任务前先查看生成的脚本或文稿分段。同步执行，不创建任务。预览调用与 Chat API 共享限流器，并带有轻量的进程内并发上限（429 + Retry-After）以防滥用。（Credit: @Khaled97Sho, PR #33） - TTS 旁白的阿拉伯语标音（tashkeel） —— 创意与文稿管线现在会在 TTS 合成前自动为旁白文本添加阿拉伯语发音符号（harakat），提升发音质量。标音只影响 TTS 输入；字幕文本与
narration.txt保持干净。（Credit: @Khaled97Sho, PR #33） - 文稿参考图 —— 文稿任务现已支持逐段参考图，通过
reference_images+reference_images_map参数实现，与创意管线中已有的同名特性一致。（Credit: @Khaled97Sho, PR #33） - 按语言感知的旁白预算 —— 非 CJK 语言的旁白长度现在使用按语言区分的每秒字符率（阿拉伯语：4.0，CJK：5.0，其他：12.0），修复了「非 CJK 文本旁白过短」的问题。（Credit: @Khaled97Sho, PR #33）
- 可配置的 CORS 来源 —— 环境变量
AGNES_CORS_ORIGINS（逗号分隔）允许任何配套工具跨域调用核心 API。AGNES_CORS_ENABLED可强制开启或关闭；设置了来源时自动检测。 - 中国大陆 API 域名 ——
AGNES_DOMAIN_MAP中的cn域名现在正确指向api.agnes-ai.cn（官方中国服务端点），从此前错误的apihub.agnes-ai.cn（国际站兜底）更新而来。前端域名选择器已同步显示正确的主机名。
重构与优化
- `split_manuscript_text()` 抽取为公开工具函数 —— 文稿切分算法现在作为独立函数提供，供文稿管线与新的 preview-split 端点共同使用。
Bug 修复
- 修复限流器活锁 —— 罕见的同步获取路径竞态条件可能让所有管线无限期停摆。令牌桶的异步路径现在成为主路径，同步路径也已加固以防止活锁。（Credit: @Khaled97Sho, PR #33）
- 修复图片保存未持久化 ——
POST /api/images/generations现在await图片下载，确保生成的图片在响应前真正写入磁盘。 - 修复 GitHub CodeQL 告警 #43 与 #47 —— 路径注入与信息披露安全告警已解决。
- 配置 Key ID 改用 PBKDF2-HMAC-SHA256 —— 配置 Key ID 现在使用正规密钥派生函数进行哈希，替代此前较弱的哈希。
- 修复 Docker Hub 被 Cloudflare WAF 拦截 —— Docker Hub 概述更新脚本现在会剥离
<script>块并对 JSON 负载中的<进行转义，以绕过 WAF 的 XSS 规则。 - 修复中国大陆站点域名 —— 按官方 Agnes 模型目录，
AGNES_DOMAIN_MAP["cn"]已更正为api.agnes-ai.cn。（Issue #37） - 兼容性说明：
core/audio/tashkeel.py模块新增可选依赖（mishkal），默认通过requirements.txt安装；若缺失，标音会静默回退为原始文本。现有任务状态文件向前兼容，无需迁移。
关于 Agnes Video Generator
完全免费、开源的 AI 视频生成器：输入文字即可生成带旁白与字幕的多镜头 AI 视频。
- 完全免费开源，无需付费与高性能显卡
- 支持文字转视频、图片转视频、数字人口播、文生图
- 基于 Agnes AI 免费模型，视频全部在云端生成
- Web UI、Docker、npm 多种运行方式，支持自托管
相关页面
版本更新日志
Agnes Video Generator 的版本发布记录：每个版本的新功能、改进与问题修复。
在线体验 | Agnes Video
输入提示词，即刻生成 AI 视频和图片
文字转视频 API — 免费、无需高性能显卡的 AI 视频生成 API | Agnes Video
程序化调用 Agnes AI 免费视频模型：文字转视频、图片转视频、旁白生成等 REST API 全覆盖，包含请求参数详解、Bearer 鉴权、任务状态轮询与完整代码示例（Python/cURL/HTTP），并附常见错误排查与限速说明；无需高性能显卡、零成本接入，开发者友好，几分钟即可跑通全流程，适合快速构建自己的 AI 视频应用。
内容可信度说明
本文由一线实践者撰写，写的时候交叉核对了 arXiv 论文、厂商技术报告和 Stanford AI Index 等一手来源，不是凭主观印象下的结论。
S
SandGrid@lcy362
Agnes Video Generator 项目作者 · 全栈开发者
独立开发者，开源 AI 视频生成工具 Agnes Video Generator 的作者。项目基于 Agnes AI 完全免费的视频模型，MIT 协议开源，已经帮 1,000+ 创作者零成本产出过 AI 视频。长期关注视频生成模型的工程化和普及，文章内容都来自一线实践和一手研究。
访问 GitHub最后更新：2026-08-21