Self-host Agnes Video Generator

Agnes Video Generator README

How to install Agnes Video Generator

AGNES_API_KEY (via .env)

How to configure Agnes Video Generator

• AGNES_API_KEY── 1. API Key（必填）────────────────────────────────────────────── 从 https://platform.agnes-ai.com 获取免费 Key ⚠️ 主 Key 的变量名不带序号（就是 AGNES_API_KEY，没有 AGNES_API_KEY_1 这个槽位）

  ── 1. API Key（必填）────────────────────────────────────────────── 从 https://platform.agnes-ai.com 获取免费 Key ⚠️ 主 Key 的变量名不带序号（就是 AGNES_API_KEY，没有 AGNES_API_KEY_1 这个槽位）

• AGNES_API_KEY_2── 2. 多 Key 轮询（可选，推荐）──────────────────────────────────── 每个 Key 的配额独立，总量 ≈ 20 × Key 数 / 分钟。 命名规则：主 Key 用 AGNES_API_KEY，额外 Key 从 AGNES_API_KEY_2 起序号依次递增 （_2、_3、_4 ...），中间不可断号（断号之后的 Key 不会被加载）。 遇到 429 会自动轮换到下一个 Key；限速配额与并发上限随 Key 数线性放大。

  ── 2. 多 Key 轮询（可选，推荐）──────────────────────────────────── 每个 Key 的配额独立，总量 ≈ 20 × Key 数 / 分钟。 命名规则：主 Key 用 AGNES_API_KEY，额外 Key 从 AGNES_API_KEY_2 起序号依次递增 （_2、_3、_4 ...），中间不可断号（断号之后的 Key 不会被加载）。 遇到 429 会自动轮换到下一个 Key；限速配额与并发上限随 Key 数线性放大。

• AGNES_API_KEY_3
• AGNES_API_KEY_4
• AGNES_API_KEY_5
• AGNES_CHAT_TIMEOUTChat 单次读超时（秒，默认 300；与多模态 chat_multimodal 对齐，消除双标准） stability_hardening P1：超时类错误最多重试 1 次，扩大成功窗口的同时压缩失败等待

  Chat 单次读超时（秒，默认 300；与多模态 chat_multimodal 对齐，消除双标准） stability_hardening P1：超时类错误最多重试 1 次，扩大成功窗口的同时压缩失败等待

• AGNES_CONFIG_ID_HMAC_KEY多 Key 管理接口生成 Key id 所用的哈希盐，一般无需修改

  多 Key 管理接口生成 Key id 所用的哈希盐，一般无需修改

• AGNES_CORS_ENABLED显式禁用（即使设置了 origins 也不启用中间件）：

  显式禁用（即使设置了 origins 也不启用中间件）：

• AGNES_CORS_ORIGINS── 7. CORS 跨源白名单（可选，供独立本地伴侣工具调用本服务 API）────────── 场景：本地跑一个独立的简化前端（如 agnes-simple-ui，监听 :8787）， 从浏览器直接调用本服务的 /api/* 接口。设置后服务仅允许列出的源跨源调用。 默认空 = 不启用 CORS（攻击面不变）；同源页面不受影响。

  ── 7. CORS 跨源白名单（可选，供独立本地伴侣工具调用本服务 API）────────── 场景：本地跑一个独立的简化前端（如 agnes-simple-ui，监听 :8787）， 从浏览器直接调用本服务的 /api/* 接口。设置后服务仅允许列出的源跨源调用。 默认空 = 不启用 CORS（攻击面不变）；同源页面不受影响。

• AGNES_IMAGE_I2I_MODEL── 5. 图生图模型（可选）─────────────────────────────────────────── i2i 默认与 t2i 同模型（当前默认 agnes-image-2.5-flash）；如需为 i2i 固定旧版：

  ── 5. 图生图模型（可选）─────────────────────────────────────────── i2i 默认与 t2i 同模型（当前默认 agnes-image-2.5-flash）；如需为 i2i 固定旧版：

• AGNES_RATE_BURST共享桶容量（默认 = 4 × Key 数；仅需调节突发并发时使用）

  共享桶容量（默认 = 4 × Key 数；仅需调节突发并发时使用）

• AGNES_RATE_LIMIT── 4. 限速（可选）───────────────────────────────────────────────── 共享桶：Chat / 图片生成 / 图片上传 / 结果轮询 共用 默认 = 20 × Key 数 × 0.8 安全系数；仍频繁 429 时可适当调低

  ── 4. 限速（可选）───────────────────────────────────────────────── 共享桶：Chat / 图片生成 / 图片上传 / 结果轮询 共用 默认 = 20 × Key 数 × 0.8 安全系数；仍频繁 429 时可适当调低

• AGNES_SUBTITLE_ASS字幕合成：=0 关闭 ffmpeg ASS 单链（回退 moviepy 词级动效路径），默认开启

  字幕合成：=0 关闭 ffmpeg ASS 单链（回退 moviepy 词级动效路径），默认开启

• AGNES_SWEEP_AGE_DAYS── 6. 运维（可选）───────────────────────────────────────────────── 启动时清理 N 天前的僵尸任务目录（不设置则不执行清理）

  ── 6. 运维（可选）───────────────────────────────────────────────── 启动时清理 N 天前的僵尸任务目录（不设置则不执行清理）

• AGNES_VIDEO_POLL_TIMEOUT视频任务轮询总超时（秒，默认 1800）

  视频任务轮询总超时（秒，默认 1800）

• AGNES_VIDEO_RATE_BURST
• AGNES_VIDEO_RATE_LIMIT视频提交独立桶（默认 = 1 × Key 数） 若服务端对视频提交是「全局限 1/min」而非 per-Key，显式设为 1

  视频提交独立桶（默认 = 1 × Key 数） 若服务端对视频提交是「全局限 1/min」而非 per-Key，显式设为 1

• HOST=0.0.0.0── 3. 本地服务监听地址（非 Agnes API 地址）─────────────────────────

  ── 3. 本地服务监听地址（非 Agnes API 地址）─────────────────────────

• PORT=8765
• PROMPT_LANGUAGE提示词语言（zh/en，影响 LLM meta-prompt 语言）

  提示词语言（zh/en，影响 LLM meta-prompt 语言）