用途:该技能用于在 Claude Code、Codex 或 OpenClaw 等智能体环境中,通过 Beatra 的付费托管服务(mcp.beatra.ai)完成 AI 图像生成、合成与编辑,适用于产品图、品牌视觉、海报、社交图形、插画和照片变体等任务。仅当用户明确希望在 Beatra 上生成图像并接受付费、且同意将提示词和参考图片发送给第三方时使用;不用于纯本地图像编辑或未经批准付费渲染的场景。
主要能力:提供免费不计费的探查能力(如 beatra.models.list、任务列表),用于读取当前模型卡片与额度估算;支持一次经批准计费的调用流程:展示费用卡(工具、模型、估算和将上传的文件)并等待明确批准,上传已批准文件后以稳定 client_request_id 提交一次并轮询返回任务;报告交付产物与 billing.net_charged_credits,并在任何后续付费阶段再次征求同意。
使用方式:安装分四步。第一步,经批准后克隆固定提交的代码树到审查目录并校验树 ID 输出 TREE-OK;第二步,检查无符号链接、可执行位或子模块条目,并确认不存在自更新入口;第三步,在获得主机配置变更授权后,将审查过的目录复制到主机技能目录(如 ~/.claude/skills/ai-image-generation-studio),且目标已存在时须停止并询问用户;第四步,单独授权:运行 authorize.py 进行 OAuth 设备流程,浏览器登录并存储 bearer 令牌。安装命令示例:umask 077; review_dir="$(mktemp -d)"; cd "$review_dir"; git clone --quiet --filter=blob:none --no-checkout https://github.com/beatra-ai/ai-image-generator-skill.git src; git -C src checkout --quiet 8e1b53d105701194f03a8d4566a37b33fc7560b9 -- skills/ai-image-generation-studio; test "$(git -C src rev-parse '8e1b53d105701194f03a8d4566a37b33fc7560b9:skills/ai-image-generation-studio')" = 'b27876bca12d5eeb07fc7c41cb2ab64d086af519' && echo TREE-OK。复制:dest="$HOME/.claude/skills/ai-image-generation-studio"; test ! -e "$dest" && test ! -L "$dest" || { echo "destination exists; stop and ask the user"; exit 1; }; cp -R "src/skills/ai-image-generation-studio" "$dest"。授权:python3 "$dest/scripts/authorize.py"。免费连接检查:python3 "$HOME/.claude/skills/ai-image-generation-studio/scripts/mcp_client.py" verify。卸载时先 --dry-run 再执行 uninstall.py,依据 JSON 决策处理令牌撤销与共享连接;脚本不删除包目录,需用户确认后自行删除。
适用场景:需要借助智能体完成付费 AI 图像创作并愿意逐次审批费用与上传内容的用户。
限制:需要 Beatra 账户、网络访问、Python 3.10+ 和预付额度;模型、价格、模式与可用性由 Beatra 及上游提供方控制且可能变化,服务按现状提供;输出具有概率性,不保证唯一或不侵权,发布前需人工审核。本目录条目仅审核上述固定代码树,新版本属于另一次审核。
安全与安全说明:风险等级 critical。所有请求使用 HTTPS 并拒绝重定向;授权走 api.beatra.ai,工具调用走 mcp.beatra.ai,上传为不含令牌的 HTTPS PUT;除非缓存决策有效(10 分钟至 7 天),每次运行先访问 api.beatra.ai/skill-route,必要时访问 api.beatra.cn/skill-route 以确定网络;cn 路由下授权和调用转向 .cn 主机。版本通知:最多每 24 小时检查一次,只读查看其他安装器留下的记录,仅打印更新命令行而不执行;无自更新代码。凭证:OAuth 设备流程,bearer 令牌存于 ~/.beatra/credentials.json(目录 0700、文件 0600),具有完整 Beatra 范围包括 wallet:spend,闲置 15 天滑动过期,设备上所有 Beatra 技能共享;待批准设备代码存于 ~/.beatra/pending_authorization.json(0600)。本地状态还包括 installation.json、host.json、skills.json、network.json、balance-holds.json、.authorize.lock 及 updates/<id>/ 下的 state.json、source.json、registration.json。遥测:授权时发送主机名、包标识与版本、检测到的智能体平台和安装参考;连接后最多每天一次非计费注册调用,携带平台字段、发布渠道、网络路由、安装来源及粗略运行时信息(操作系统及版本、CPU 架构、Python 版本、区域设置、UTC 偏移),每次工具调用附加 source_package_slug 与 source_platform,这些字段无退出选项。保留:账户数据在账户生命周期内保留,任务记录、产物和计费账本在账户关闭后仍为审计和税务目的保留。内容权利:用户保留输入权利并获得 Beatra 在输出中的权利,须对上传媒体拥有权利,不得创建欺骗性冒充。