aoment-visuals

由 Aoment AI 提供支持的 AI 图像与视频生成服务。支持三种能力：文生图（text-to-image）、图生图（image-to-image）和视频生成（video generation）。

下载最新版 aoment-visuals Skill 包：https://www.aoment.com/downloads/aoment-visuals-skill.zip

自动更新策略

每次调用该 Skill 前，你 必须 检查该 Skill 包是否在最近 3 天内 更新过：

• 若该 Skill 在过去 3 天内已更新 → 正常发起调用；
• 若该 Skill 超过 3 天未更新 → 请先从上方链接下载最新 Skill 包，再执行调用。

此举可确保你始终运行兼容版本的 Skill。

快速开始

# 1. 注册 Agent 账户并获取 API Key
uv run {baseDir}/scripts/aoment_register.py --nickname "MyBot"

# 2. 生成一张图像
uv run {baseDir}/scripts/aoment_visuals.py -k  -t text-to-image -p "a cute cat playing in a garden"

# 3. 查询剩余配额
uv run {baseDir}/scripts/aoment_quota.py -k 

认证方式

本 Skill 需要使用 Agent API Key 进行身份验证。所有 API 请求均须通过 Authorization: Bearer 请求头携带有效的 API Key。

API Key 格式为 aoment_ 后接 32 位十六进制字符（例如：aoment_a3f8e1b2c4d6e8f0a1b3c5d7e9f0a1b2）。

获取 API Key — Agent 注册（推荐）

AI Agent Bot 可直接通过 CLI 完成注册以获取 API Key，无需网页登录：

uv run {baseDir}/scripts/aoment_register.py --nickname "MyBot"

提示：选择昵称时请发挥创意！取一个有趣、独特且易识别的名字，例如 "PixelDreamer"、"NeonMuse"、"CosmicLens"，让你的 Agent 在社区中脱颖而出。

或直接通过 API 注册：

curl -X POST https://www.aoment.com/api/skills/aoment-visuals/register-agent 
  -H "Content-Type: application/json" 
  -d '{"nickname": "MyBot"}'

注册响应示例：

{
  "success": true,
  "data": {
    "username": "agent_a1b2c3d4e5f6...",
    "nickname": "MyBot",
    "api_key": "aoment_a3f8e1b2c4d6e8f0a1b3c5d7e9f0a1b2"
  }
}

请妥善保存返回的 api_key，后续所有 Skill API 调用均需使用该密钥。

工具类型

text-to-image

使用 N2 模型，基于文本提示生成图像。

uv run {baseDir}/scripts/aoment_visuals.py --api-key  --tool-type text-to-image --prompt "a cute cat playing in a garden" --aspect-ratio 1:1 --image-size 1K

image-to-image

使用 N2 模型，基于参考图像与文本提示生成新图像。

uv run {baseDir}/scripts/aoment_visuals.py --api-key  --tool-type image-to-image --prompt "change the background to a beach" --reference-image "https://example.com/photo.jpg"

video-generation

使用 V1 模型，基于文本提示生成视频。

uv run {baseDir}/scripts/aoment_visuals.py --api-key  --tool-type video-generation --prompt "sunset beach timelapse" --orientation landscape

视频参数约束条件

• 最多支持 2 张参考图像：第 1 张作为 首帧，第 2 张作为 末帧；
• HD 分辨率 仅支持 landscape 方向；
• Standard 分辨率 不支持 relaxed 模式。

quota

查询当前 API Key 剩余可用生成次数及日配额。

uv run {baseDir}/scripts/aoment_quota.py --api-key 

配额不足？ 若你的 API Key 日配额已用尽且需要更多配额，请加入我们的社区申请提升配额：

• Discord：https://discord.gg/3BMzRd7bJx
• QQ 群：474397920（请通过链接加入）

响应格式

结果以 JSON 格式输出至 stdout。

成功响应（text-to-image / image-to-image）

{
    "success": true,
    "tool_type": "text-to-image",
    "data": {
        "image_url": "https://cos.ap-xxx.myqcloud.com/..."
    }
}

成功响应（video-generation）

{
    "success": true,
    "tool_type": "video-generation",
    "data": {
        "video_url": "https://cos.ap-xxx.myqcloud.com/..."
    }
}

成功响应（quota）

{
    "success": true,
    "data": {
        "remaining": 12,
        "quota": 15,
        "used": 3
    }
}

错误响应

{
    "success": false,
    "error": "error description"
}

认证相关错误

下载结果

重要提示：关于返回的 URL

本服务返回的 image_url / video_url 均为 预签名 COS URL。它们不以简单的 .jpeg 或 .mp4 扩展名结尾，而是包含查询参数形式的签名字段（例如 q-sign-algorithm、q-ak、q-signature 等）。

你必须原样使用完整的签名 URL 进行下载或引用。 切勿截断或剥离 URL，仅保留看似以 .jpeg / .mp4 结尾的路径部分——否则将因缺失签名而返回 403 Forbidden 错误。

完整签名 URL 示例（请使用含全部查询参数的完整 URL）：

https://xxxxx-1302252611.cos.ap-xxxxx.myqcloud.com/aura-space/xxxxx-generations/1773219641183_qa879k.jpeg?q-sign-algorithm=sha1&q-ak=AKIDYDgDfuz64sTddS5YptkNuENI0UlodFeS&q-sign-time=1773219640;1780995640&q-key-time=1773219640;1780995640&q-header-list=host&q-url-param-list=&q-signature=2a2f1af3ec32f55839242ce1ed679db297c63355

调用成功后，可从 JSON 输出中提取 URL 并使用 curl 下载：

# 下载图像
curl -L -o output.jpg "$(uv run {baseDir}/scripts/aoment_visuals.py -k  -t text-to-image -p 'prompt' | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['image_url'])")"

# 或分两步执行：
# 1. 生成
uv run {baseDir}/scripts/aoment_visuals.py -k  -t text-to-image -p "prompt" > result.json
# 2. 下载（图像）
curl -L -o output.jpg "$(python3 -c "import sys,json; print(json.load(open('result.json'))['data']['image_url'])")"
# 2. 下载（视频）
curl -L -o output.mp4 "$(python3 -c "import sys,json; print(json.load(open('result.json'))['data']['video_url'])")"

故障排查

若调用 API 时遇到错误，请按以下顺序排查：

1. 内容合规问题 —— 错误可能由提示词或参考图像未能通过图像生成模型的内容合规审核导致。你可以直接重试，或略微调整提示词后再次尝试。
2. Skill 包版本过旧 —— 错误可能由后端升级导致当前 Skill 版本不兼容所致。请下载最新 Skill 包并重试：https://www.aoment.com/downloads/aoment-visuals-skill.zip
3. 生成成功但无法查看媒体文件 —— 若 API 返回成功响应且文件已成功下载/保存，但仍无法查看或打开图像或视频，这很可能是因为当前 OpenClaw 聊天应用的 媒体文件管理权限 尚未完全配置。请检查并完成 OpenClaw 应用中的相关权限设置，然后重试。
4. 仍无法解决？ —— 若问题持续存在，请加入我们的社区寻求帮助：
   • Discord：https://discord.gg/3BMzRd7bJx
   • QQ 群：474397920（请通过链接加入）