Agnes画影 — Agnes AI 多模态创作#

Keywords#

多模态生成、图片生成、视频生成、Agnes AI、API 调用

Summary#

调用 Agnes AI 免费全模态 API，据用户描述生成图片或视频，返回结果 URL。

Strategy#

1. 意图识别 — 用户要图片还是视频（默认图片）
2. 确认 Prompt — 向用户复述并确认描述
3. 调 API — 按类型调用对应端点，视频需轮询
4. 返结果 — 返回 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 Key3复制生成的 sk- 开头密钥4a侦测环境： uname -s 判 OS， echo $SHELL 判 shell4b配置命令（据上一步结果选择）：

• 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，问用户"还要再生成吗？"

---

使用示例#

text

用户：画一只在云朵上睡觉的柴犬，治愈风
→ 确认 Prompt → 调图片 API → 返回图片 URL

用户：做一段赛博朋克城市夜景，5 秒
→ 确认 Prompt → 调视频 API → 轮询至完成 → 返回视频 URL