Imported from rongyaozhixing/codex-agnes-media (SKILL.md). Install upstream with npx skills add rongyaozhixing/codex-agnes-media. Copyright stays with the author.

agnes-media：生图 / 生视频

agnes 是 Sapiens AI 的模型服务（OpenAI 兼容端点）。本技能通过 agnesmedia CLI（Typer 实现）生成媒体文件，CLI 与 Codex 共用同一套底层 API。

快速使用

生图（同步，约 10-60 秒）

agnesmedia image txt2img "<用户对图片的描述>"
# 自定义尺寸
agnesmedia image txt2img "<描述>" --size 1792x1024
# JSON 输出（供程序解析）
agnesmedia image txt2img "<描述>" --json

图片保存到 DOWNLOAD_DIR（默认 ./output），输出会打印保存路径。

生视频（异步任务，限流约 2 次/分钟）

# 提交任务，拿到 task_id
agnesmedia video txt2video "<视频内容描述>" [--seconds 5]
# 等待完成（约 60 秒）并尝试下载
agnesmedia task wait <task_id>
# 仅查询状态
agnesmedia task query <task_id>

注意：agnes 公网视频下载端点当前有缺陷（平台 one-api 网关返回 Not Found，2026-08 实测），task wait 会提示到 https://platform.agnes-ai.cn 网页端任务列表下载。触发限流（429）时告知用户等待约 65 秒。

Codex 对话示例

用户说「生成一张图片：一只红熊猫坐在树枝上」：

agnesmedia image txt2img "一只红熊猫坐在树枝上，卡通风格"

→ 把输出的本地路径告诉用户。

用户说「生成一个 5 秒视频：小狗在草地上跑」：

agnesmedia video txt2video "小狗在草地上奔跑" --seconds 5
agnesmedia task wait <上一步的 task_id>

自定义模型 / 参数

• 模型：通过环境变量 AGNES_IMAGE_MODEL / AGNES_VIDEO_MODEL 覆盖（默认 agnes-image-2.1-flash / agnes-video-v2.0）
• 尺寸：--size WIDTHxHEIGHT（1-4096，如 1024x1024、1792x1024）
• 时长：--seconds 1-30
• 输出目录：DOWNLOAD_DIR（默认 ./output）

注意事项

• 密钥来源优先级：环境变量 / .env（AGNES_API_KEY） > ~/.agnes.json（api_key）。不要把密钥明文打印到输出
• agnes 只有 chat/completions 端点，没有 /v1/responses，不能作为 codex 的模型后端——本技能只用于生成媒体文件
• 图片输出 PNG；视频输出 MP4（下载受限时走网页端）
• 程序化调用：skills/codex_adapter.py 提供 txt2img / video_submit / video_wait / video_generate_and_wait