Agnes Video V2.0 视频生成技能（tokeny 干净版）

基于 Agnes AI 平台的视频生成能力。本技能不内置任何 API Key，使用者必须提供自己的密钥。

安全说明（重要）

• ❌ 本技能不包含、不硬编码任何 API Key。
• ✅ 密钥仅从以下来源读取（按优先级）：
  1. 命令行参数 --api-key sk-xxxx
  2. 环境变量 AGNES_API_KEY
  3. 同目录 config.json 的 api_key 字段
• ✅ 默认仅面向 .com 节点（https://apihub.agnes-ai.com/v1）。若意外指向 .cn 节点，脚本会主动警告（tokeny 环境下 .cn 不可达）。
• 分享本技能时，请确保不要把自己的 config.json 或含密钥的 .env 一起发出去。

---

配置（使用者自行设置）

方式一：环境变量（推荐）

export AGNES_API_KEY=sk-你的真实密钥

方式二：配置文件

复制 config.example.json 为 config.json，填入你的密钥：

{
  "api_key": "sk-你的真实密钥",
  "base_url": "https://apihub.agnes-ai.com/v1"
}

方式三：命令行参数

python scripts/generate_video.py -p "一只猫在公园里散步" --api-key sk-你的真实密钥

---

使用方法

激活技能后，由智能体调用脚本（也可手动运行）：

# 先自检（不消耗积分）：校验 Python / 密钥 / 网络
python scripts/selfcheck.py

# 生成视频（默认约 5 秒 768x1152）
python scripts/generate_video.py -p "两只相声演员在舞台上表演" -o output/xiangsheng.mp4

示例：

• /agnes-video 一只猫在公园里散步
• /agnes-video 日落的延时摄影

---

技术细节

API 端点（固定 .com）

• 创建任务：POST https://apihub.agnes-ai.com/v1/videos
• 查询状态：GET https://apihub.agnes-ai.com/v1/videos/{task_id}
• 获取下载地址：GET https://apihub.agnes-ai.com/agnesapi?video_id={video_id}

注意：轮询状态接口只回 status: completed，不含视频 URL； 必须再用 video_id 调用 /agnesapi 接口才能拿到真实下载链接。本技能已内置该逻辑。

请求格式

{
  "model": "agnes-video-v2.0",
  "prompt": "视频描述",
  "num_frames": 121,
  "frame_rate": 24,
  "height": 768,
  "width": 1152
}

常用参数

---

注意

• 视频为异步生成，创建任务后需轮询等待（脚本自动处理，最长 10 分钟）。
• 支持中文提示词。
• 视频自动下载到 -o 指定的路径。

版本: v1.0.0（tokeny 干净版 / 无内置密钥） 更新时间: 2026-08-14