Agnes画影 — Agnes AI 多模态创作
Keywords
多模态生成、图片生成、视频生成、Agnes AI、API 调用
Summary
调用 Agnes AI 免费全模态 API，据用户描述生成图片或视频，返回结果 URL。
Strategy
- 意图识别 — 用户要图片还是视频（默认图片）
- 确认 Prompt — 向用户复述并确认描述
- 调 API — 按类型调用对应端点，视频需轮询
- 返结果 — 返回 URL，询问是否继续
AVOID
- 勿将 API Key 暴露在日志或 prompt 中
- 勿高频轮询视频接口（间隔 ≥10 秒）
- 勿一次生成多张图/多个视频而未先问用户
- 勿假设视频同步返回——必须轮询至 complete
- 勿假设用户使用 zsh——每次配置前须侦测 OS 与 shell
- 勿在 Windows 上使用 Linux 路径语法（如 ~/.zshrc）
前置条件
AGNES_API_KEY环境变量（运行时自动侦测 OS 与 shell，见下方配置步骤）- API 基础地址：
https://apihub.agnes-ai.com/v1
获取 API Key
| 步骤 | 操作 |
|---|---|
| 1 | 打开 platform.agnes-ai.com，注册/登录 |
| 2 | 左侧导航 → API Keys → Create API Key |
| 3 | 复制生成的 sk- 开头密钥 |
| 4a | 侦测环境：uname -s 判 OS，echo $SHELL 判 shell |
| 4b | 配置命令（据上一步结果选择）：• Linux/macOS + zsh → echo 'export AGNES_API_KEY="sk-..."' >> ~/.zshrc && source ~/.zshrc• Linux + bash → echo 'export AGNES_API_KEY="sk-..."' >> ~/.bashrc && source ~/.bashrc• macOS + bash → echo 'export AGNES_API_KEY="sk-..."' >> ~/.bash_profile && source ~/.bash_profile• Windows + PowerShell → Add-Content -Path $PROFILE -Value '$env:AGNES_API_KEY="sk-..."'• 其他环境 → 询问用户其 shell 配置文件名 |
| 5 | 验证：curl -s https://apihub.agnes-ai.com/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $AGNES_API_KEY" -d '{"model":"agnes-2.0-flash","messages":[{"role":"user","content":"hi"}]}'，返回含 choices 即成功 |
工作流
1. 识别意图
| 用户说 | → 操作 |
|---|---|
| "画/生成图片/做张图……" | 图片 |
| "生成视频/短片/短视频……" | 视频 |
| 未明确 | 默认图片，可反问确认 |
2. 确认 Prompt（Human-in-the-Loop）
向用户展示你要发送的描述文字，确认后再调 API。
3. 调用 API
详细参数与 curl 示例见 modules/01-api-reference.md。
快速参考：
| 能力 | 端点 | 模型名 |
|---|---|---|
| 图片 | POST /v1/images/generations |
agnes-image-2.0-flash |
| 视频 | POST /v1/video/generations |
agnes-video-v2.0（带 v） |
- 图片：从响应
.data[0].url取 URL - 视频：异步任务，轮询
.data.status至completed，从.data.remixed_from_video_id取 URL
4. 返回结果
展示 URL，问用户"还要再生成吗？"
使用示例
用户：画一只在云朵上睡觉的柴犬，治愈风
→ 确认 Prompt → 调图片 API → 返回图片 URL
用户：做一段赛博朋克城市夜景，5 秒
→ 确认 Prompt → 调视频 API → 轮询至完成 → 返回视频 URL