Agent Skills
返回列表
🎨

Agnes AI 多模态生成

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_d0c0b7f4/agnes-ai-skill。

技能介绍

要解决什么问题

在 Agent 或本地脚本里接多模态生成时，常见做法是分别对接聊天、画图、视频三套 SDK 或 curl 模板。Agnes AI 把能力挂在 OpenAI 兼容 的 Base URL（https://apihub.agnes-ai.com/v1）上，但视频是异步任务、端点也与图像不同，手写轮询和下载很容易踩坑（例如误用 /v1/videos/generations）。

本技能提供 零依赖 的 scripts/agnes_client.py（仅用标准库 urllib），把文生文、文生图、文生视频收敛为同一套命令行子命令，并自带「成功判据」：有直链输出或 -o 目标文件且文件存在即视为成功。

如何工作

  • 文生文（text）：POST /v1/chat/completions，默认模型 agnes-2.0-flash，支持 -s/--system、-m/--max-tokens，stdout 打印回复与 token 消耗。
  • 文生图（image）：POST /v1/images/generations（同步），默认 agnes-image-2.1-flash，从 data[].url 取图并下载到 -o；可传 size、n 等参数。
  • 文生视频（video）：POST /v1/videos 提交任务，用 task_id 轮询 GET /v1/videos/{task_id} 直至 status=="completed"，再从 metadata.url 下载；不要走 /v1/videos/generations。

更细的模型列表、字段与错误码见技能内 references/api_reference.md；案例可参考 examples/demo.md。

边界与注意点

  • 需自备环境变量 AGNES_API_KEY（在 platform.agnes-ai.com 控制台创建），勿写进仓库。
  • 视频生成 限频 1 次/分钟，连续多段需间隔 ≥60 秒，否则可能 429 与 rate_limit_exceeded。
  • 技能标注为免费版：安装与调用本身不收取中间费用，实际配额与计费以 Agnes 平台为准。

使用场景

  • 在本地或 CI 脚本中用 `image` 子命令把提示词生成的图片下载到 `-o` 指定路径，用于海报或品牌物料落盘。
  • 为 Agent 或自动化流程调用 `text` 子命令，用 `-s` 系统提示约束 JSON/表格等结构化回复后再做下游解析。
  • 需要根据文案出短视频时，用 `video` 子命令走 `POST /v1/videos` 与轮询，拿到 `metadata.url` 后自动保存成品。
  • 在内网或受限环境无法用 pip 时，用 `agnes_client.py` 验证 `AGNES_API_KEY` 及文生文/图/视频三类接口是否通。

适合人员

  • 维护 Agent 工具链、要把聊天补全与画图/视频生成接到同一 OpenAI 兼容端点的后端工程师
  • 按品牌 brief 用命令行批量出图并写入固定目录的营销自动化或视觉脚本维护者
  • 做短视频原型、需在脚本里遵守每分钟 1 次视频限频并处理 429 的产品或内容实验同学
  • 只能使用 Python 标准库、不能随意装依赖的内网运维或集成开发同学