Agnes Image 2.1 图片生成技能（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_image.py -p "一只猫在公园里散步" --api-key sk-你的真实密钥

---

使用方法

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

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

# 生成图片（默认 1024x1024，单张）
python scripts/generate_image.py -p "两只相声演员在舞台上表演" -o output/xiangsheng.png

示例：

• /agnes-image 一只猫在公园里散步
• /agnes-image 水彩风格的江南水乡

---

技术细节

API 端点（固定 .com）

• 生成图片：POST https://apihub.agnes-ai.com/v1/images/generations
• 查询模型：GET https://apihub.agnes-ai.com/v1/models

图片为同步生成：创建任务后接口直接返回 data[].url，无需像视频那样轮询状态、也无需二次取 URL。本技能直接下载返回的图片链接。

请求格式

{
  "model": "agnes-image-2.1-flash",
  "prompt": "图片描述",
  "n": 1,
  "size": "1024x1024"
}

常用参数

---

注意

• 一次可生成多张（--n 2），脚本会自动按序号命名（如 agnes_image_1.png、agnes_image_2.png）。
• 支持中文提示词。
• 图片自动下载到 -o 指定的路径。

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