ADP 多模态生成

> ADP 多模态生成 Skill | 本 Skill 提供 图片生成、视频生成、3D 模型生成 三类能力，统一按异步任务方式完成提交与结果查询。

概述

本技能用于在中文场景下，按用户意图为图片、视频和 3D 生成请求选择合适的 ADP 能力模块，并以 submit/query 成对方式执行异步任务。

模块划分

调用前先读 references/ability-catalog.md。里面记录了当前已核实的模块别名、能力页地址、底层工具名、关键参数以及当前可调用状态。

重要说明

1. 运行前请先安装依赖：pip install -r requirements.txt，并确保环境变量中提供了 ADP_API_KEY。详见 步骤 3 的"运行依赖" 小节。
2. 本 Skill 面向中文业务场景，默认用中文向用户解释模块选择、参数和阻塞原因。
3. 本 Skill 调用的是 ADP 平台的多模态能力，不是腾讯云开放 API。
4. 只有在 references/ability-catalog.md 中被明确核实过的字段，才能当成已确认事实使用。
5. 如果某个能力当前不能执行，直接汇报阻塞，不要猜内部接口，也不要私自换到别的模型。

模块与别名

不要直接让用户或调用方记能力 ID。统一按下面的模块别名使用：

执行时只接受这些模块别名，不接受直接传底层标识。

路由规则

按以下规则路由：

不要跨类别静默降级。比如用户明确要视频生成，而当前目标能力不能外呼时，不能偷偷改成图片或 3D 能力。

执行流程

步骤 1：选择能力

按上面的路由规则选择能力，再到 references/ability-catalog.md 核对已验证事实。

步骤 2：选择模式

按能力类型选择模式：

补充规则：

• image.hy 的 text2image 只需要 Prompt
• image.hy 的 image2image 需要 Prompt + Images
• image.gi 的 text2image 只需要 Prompt
• image.gi 的 image2image 需要 Prompt + Images

步骤 3：脚本用法

运行依赖

执行脚本前请先安装依赖：

pip install -r requirements.txt

依赖清单见 requirements.txt，目前仅需要 requests。脚本同时要求环境中提供 ADP_API_KEY（环境变量优先），未设置时会汇报阻塞。

调用方式

统一格式：

python3 scripts/adp_mcp.py <alias> run [--mode <mode>] [--step <submit|query>] (<json> | -f <json-file>)

参数提供方式二选一：

• 直接传 JSON 字符串（参数体积小或不含 base64 时使用）。
• 通过 -f/--arguments-file 指定 JSON 文件路径，或传 -f - 从 stdin 读取（推荐用于图生图、图生视频等含 base64 的大请求体）。

常见示例：

python3 scripts/adp_mcp.py image.hy run '{"Prompt":"一只白色小猫坐在木桌上，写实风格","Resolution":"1024:1024"}'
python3 scripts/adp_mcp.py image.hy run --mode image2image '{"Prompt":"保留主体，改成宫崎骏风格","Images":["https://example.com/input.png"]}'
python3 scripts/adp_mcp.py image.gi run --mode image2image -f /tmp/gi_args.json
python3 scripts/adp_mcp.py video.kling run --mode text2video '{"Prompt":"海边日落延时摄影","Duration":"5"}'
python3 scripts/adp_mcp.py video.vidu run --mode image2video '{"Images":["https://example.com/input.png"],"Duration":5}'
python3 scripts/adp_mcp.py 3d.hy run '{"Prompt":"一辆未来感概念跑车"}'

分步执行示例：

python3 scripts/adp_mcp.py image.hy run --step submit '{"Prompt":"一只白色小猫坐在木桌上，写实风格","Resolution":"1024:1024"}'
python3 scripts/adp_mcp.py image.hy run --step query '{"JobId":"123"}'

步骤 4：汇报结果

汇报时必须说明：

• 最终使用了哪个能力
• 这是默认命中还是关键词触发的模型切换
• 如果失败，是 submit 失败还是 query 结果失败
• 如果是外部调用受限，要明确标注为平台限制

参考资料

• 逐能力事实看 references/ability-catalog.md。