git:20260912.6c490fd to git:20261028.1756e02

---

name: agnes-media-generation

description: |

Agnes AI 生图/改图/生视频。用户指定 Agnes、agnes-ai.com 时使用。

⏰ 触发：「用 Agnes 生图/生视频」「agnes-ai 画图」等。

凭据 vendor id：`agnes`（EvoFlow 设置 → 创意媒体）。

---

# Agnes AI 媒体生成

用户指定 **Agnes / agnes-ai.com** 时使用。凭据 vendor id：**`agnes`**。

## 官方文档

| 能力 | 文档 |

|------|------|

| 总览 | [Agnes AI API Overview](https://agnes-ai.com/doc/overview) |

| 生图 / 图生图 | [Agnes Image 2.1 Flash](https://agnes-ai.com/doc/agnes-image-21-flash) — **图生图必须传 `image`** |

| 生视频 | [Agnes Video v2.0](https://agnes-ai.com/doc/agnes-video-v20) |

API 基址：`https://apihub.agnes-ai.com`

认证：`Authorization: Bearer <key>`

## 凭据

**设置 → 环境变量**：添加 `AGNES_API_KEY=…`（保存后立即注入 terminal/脚本）。也可在 **设置 → 模型 → 创意媒体 → Agnes** 填写（会自动写入该环境变量）。

申请：[Agnes 平台](https://platform.agnes-ai.com)

## 脚本

`skills/public/agnes-media-generation/scripts/agnes_api.py`（stdout = JSON）

### 文生图

```bash

python skills/public/agnes-media-generation/scripts/agnes_api.py image \

--prompt "A luminous floating city above misty canyon at sunrise, cinematic" \

--size 1024x768 \

--output-dir outputs

```

### 图生图 / 改图（须参考图 URL）

```bash

python skills/public/agnes-media-generation/scripts/agnes_api.py image \

--prompt "Turn into rainy cyberpunk night, preserve composition" \

--image "https://example.com/input.png" \

--size 1024x768 \

--output-dir outputs

```

### 文生视频（异步 + 轮询）

```bash

python skills/public/agnes-media-generation/scripts/agnes_api.py video \

--prompt "A cinematic shot of a cat on the beach at sunset, soft waves" \

--poll --output-dir outputs

```

### 图生视频

```bash

python skills/public/agnes-media-generation/scripts/agnes_api.py video \

--prompt "Subtle camera push-in, natural lighting" \

--image "https://example.com/frame.png" \

--poll --output-dir outputs

```

### 查询任务

```bash

python skills/public/agnes-media-generation/scripts/agnes_api.py video-get TASK_ID

```

## 交付

## 常见错误

- 图生图未传 `--image`

- 未 `--poll` 就当作失败

- 与火山 **混用**凭据或模型名

- 失败 **勿自动换** 其它厂商（须用户同意）