Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

Agnes 免费模型技能

三个用于调用 Agnes AI 免费模型 API 的 Codex/Agent 技能：

• agnes-free-text：使用 Agnes-2.0-Flash 的免费文本对话补全，包含流式（streaming）和工具调用（tool-calling）示例。
• agnes-free-image：使用 Agnes Image 2.1 Flash 的免费图像生成与图像转换。
• agnes-free-video：使用 Agnes-Video-V2.0 的免费异步视频生成，包含任务轮询与视频下载辅助工具。

安装

将所需的技能文件夹复制到你的 Codex 技能目录：

cp -R agnes-free-text ~/.codex/skills/
cp -R agnes-free-image ~/.codex/skills/
cp -R agnes-free-video ~/.codex/skills/

你也可以将仓库放在任意位置，并在自己的 agent 运行时中引用 SKILL.md 文件。

配置

在环境变量中设置 Agnes API 密钥。不要在技能文件中硬编码密钥。

export AGNES_API_KEY="your_api_key_here"

辅助脚本也接受 AGNES_TOKEN 作为回退方式。若端点变更，可使用 AGNES_API_BASE 覆盖 API 主机。

快速检查

python3 -m py_compile \
  agnes-free-text/scripts/agnes_text.py \
  agnes-free-image/scripts/agnes_image.py \
  agnes-free-video/scripts/agnes_video.py

python3 agnes-free-text/scripts/agnes_text.py --help
python3 agnes-free-image/scripts/agnes_image.py --help
python3 agnes-free-video/scripts/agnes_video.py --help

安全

• API 密钥仅从环境变量读取。
• 不包含任何生成的媒体、本地运行输出或私有 API 密钥。
• 参考文档仅使用占位符凭据。

许可证

MIT