核心用法
aoment-visuals 是由 Aoment AI 提供的综合性 AI 视觉生成服务，封装为可通过 uv run 调用的本地脚本工具。该技能支持三大核心能力：
1. 文生图 (text-to-image)：基于 N2 模型，根据文本描述生成静态图片，支持 1:1、16:9、9:16 等 11 种宽高比，以及 1K/2K/4K 三种分辨率。
2. 图生图 (image-to-image)：以上传图片为参考，结合文本提示进行风格迁移、背景替换等创意改造，参数配置与文生图一致。
3. 视频生成 (video-generation)：基于 V1 模型，支持竖屏/横屏两种方向，标准/高清/4K 三档分辨率，可选标准或宽松生成模式。特别支持首尾帧参考图功能（最多 2 张），实现更可控的视频创作。
所有工具通过统一的 CLI 接口调用，返回预签名的 COS URL（90 天有效），可直接下载。此外提供 quota 工具查询账户剩余额度。
---
显著优点
- 功能集成度高：单一技能覆盖图像生成、图像编辑、视频生成三大场景，减少工具切换成本
- 参数配置灵活：丰富的宽高比和分辨率选项，适配社交媒体、印刷、大屏等多种输出场景
- 视频创作增强：支持首尾帧控制，为视频生成提供关键帧约束，提升可控性
- 输出质量档位清晰：1K/2K/4K 及标准/高清/4K 的分级设计，便于按需选择
- URL 直链下载：预签名 COS URL 可直接用 curl 等工具下载，集成友好
- 技术文档详尽：参数表格、约束说明、故障排查指南完整，降低上手门槛
---
潜在缺点与局限性
- API Key 认证门槛：需注册 Aoment 账号并申请 Agent API Key，对纯本地/离线场景不友好
- 额度消耗不透明：仅提供剩余次数查询，无单次消耗明细，难以预估成本
- 内容合规审查：提示词或参考图可能触发模型内容审核，需反复重试
- 视频分辨率约束复杂：高清仅支持横屏、标准分辨率不支持宽松模式等限制需特别注意
- URL 有效期限制：90 天有效期对长期归档需求不足，需及时转存
- 依赖第三方云存储：COS URL 的可用性受制于腾讯云 COS 服务状态
---
适合人群
- 内容创作者：需要快速生成社交媒体配图、短视频素材的自媒体运营者
- 设计师/艺术家：用于概念草图生成、风格探索、灵感发散
- 开发者：需要将 AI 视觉能力集成到自动化工作流的技术用户
- 电商从业者：批量生成商品场景图、营销素材
---
常规风险
| 风险类型 | 具体说明 | 缓解建议 |
|---------|---------|---------|
| **密钥泄露** | API Key 在命令行明文传递，可能被 shell 历史记录、进程列表捕获 | 使用环境变量存储密钥，避免直接硬编码 |
| **内容合规** | 生成内容可能因审核失败，敏感主题存在封号风险 | 遵守 Aoment 使用条款，避免政治、暴力、色情等敏感提示 |
| **服务依赖** | 完全依赖 Aoment 后端 API 和腾讯云 COS，单点故障风险 | 关键项目保留本地备份流程，避免单一依赖 |
| **成本失控** | 视频/高清生成可能消耗高额额度，无明确单价公示 | 先用 `quota` 查询余额，小批量测试后再规模化使用 |
| **版权模糊** | AI 生成内容的商用授权边界不明确 | 查阅 Aoment 服务条款，商业用途建议获取法律意见 |