mopng-api

维护与需求：需求由 MoPNG 产品侧（小明 · CPO）分诊与排序。提需求 / 报问题请直接开 issue：https://github.com/jkin8010/mopng-api/issues —— 72 小时内给出「接受 / 拒绝 / 待定」三态答复（判「待定」时在 issue 里写明缺什么信息、由谁补、何时回看）。代码实现按单派给开发同学；本仓只做需求分诊，不在这里承诺档期。

面向 OpenClaw 的 MoPNG Agent Skill。它调用 qise-studio motu-agent 的公共 OpenAPI，让 UserAgent 与 MoPNG Agent 协商图片生成或修图方案，再由服务端执行功能链。

Quickstart

git clone https://github.com/jkin8010/mopng-api.git && cd mopng-api
uv sync
export MOPNG_API_KEY='ak_...'          # 私密配置，不要提交或粘贴到对话
uv run python scripts/mopng_agent.py models --capability text-to-image

最后一条能打印模型目录，就说明 key 与网络都通了。下一步见「一键协商」。

配置

export MOPNG_API_KEY='ak_...'                 # 私密配置，不要提交或粘贴到对话
export MOPNG_AGENT_BASE_URL='https://agent-api.mopng.cn'

MOPNG_AGENT_BASE_URL 默认是 https://agent-api.mopng.cn。客户端会自动请求 /api/v1/open/agent，鉴权头为 X-API-Key。

查询服务端当前模型目录（只读、免费）：

python3 scripts/mopng_agent.py models --capability text-to-image
python3 scripts/mopng_api.py list-models

scripts/mopng_api.py 只提供只读查询。所有图像生成/修图操作都必须走 mopng_agent.py 的「Plan 审阅 → 用户批准 → 执行」流程，没有任何绕过批准直接下单的入口。

一键协商

已有图片必须先有 motu-agent 可访问的 HTTPS URL；多个参考图可重复传入 --reference-url：

python3 scripts/mopng_agent.py run \
  --intent '把产品图背景换成白色，做电商主图' \
  --goal '背景替换' \
  --reference-url 'https://example.com/product.png' \
  --usage '电商主图' \
  --style-constraint '纯白背景，产品边缘干净' \
  --width 1024 --height 1024

纯文生图不传 --reference-url：

python3 scripts/mopng_agent.py run \
  --intent '生成一张电影感的橘猫宇航员海报' \
  --goal '文生图' --usage '海报'

run 不会自动执行，也不会替你批准：它创建会话、展示 Plan，然后打印成本与下一步命令。真正开始计费必须由你显式执行：

python3 scripts/mopng_agent.py approve SESSION_ID

费用披露：图像任务会调用付费接口并消耗 MoPNG 积分。查询模型目录（models / list-models）不产生费用；批准 Plan 后才开始计费。

手动协商

python3 scripts/mopng_agent.py brief --intent '...' --goal '风格转换' --reference-url 'https://...'
python3 scripts/mopng_agent.py plan SESSION_ID
python3 scripts/mopng_agent.py revision SESSION_ID --plan-id PLAN_ID --round 2 \
  --feedback-json '[{"step":1,"type":"set_cost_mode","value":"premium"}]'
python3 scripts/mopng_agent.py approve SESSION_ID
python3 scripts/mopng_agent.py status SESSION_ID --watch

支持的 OpenAPI 操作是创建会话、读取 Plan、修订、批准、轮询执行、打断和删除会话。完整行为和安全边界见 SKILL.md。

校验

uv run pytest tests/ -v
uv run bandit -r scripts -ll