Picset 单图文生图/图生图
独立单张图片生成与图片编辑能力。默认使用简体中文。
职责与边界
负责独立生图任务和图片编辑:根据用户提示词生成单张创意图片,或基于用户提供的参考图进行图生图/编辑修改。
不负责:
- 电商主图、详情图、套图、Listing 图、A+ 商品图的方案规划与
generate_commerce_images链路——那类需求交给 电商套图 Skill,哪怕用户只要一张主图或一张详情图,也必须走套图。 - 画布的打开、承接、状态读取与图片返回——那类操作交给 Agent Canvas Skill。生图完成后结果可由画布承接,但生图本身不依赖画布。
- 充值套餐面板——由连接器统一充值面板处理,详见 连接器充值手册,工具为
open_agent_pricing。
细则与工具契约一律按 单图共享手册 执行,本 Skill 不重复展开。
调用时机
仅在以下两种场景调用本能力:
- 独立生图任务:用户要的是创意单图、概念图、插画、示意图、logo、场景图、氛围图等非电商上架图,且没有要求生成主图/详情图/套图/Listing/A+。
- 图片编辑:用户上传或引用一张已有图片,要求对其进行修改(换背景、改风格、加元素、局部重绘、扩图等),且修改目标不是电商主图/详情图/套图。
硬边界
- 主图/详情图哪怕一张也走套图:用户说"做一张主图""一张详情图""1 张 Listing 图"等,一律路由到电商套图,禁止调用
generate_agent_canvas_image。 - 电商套图不走单图:用户明确要主图/详情/套图/Listing/A+ 时,禁止用单图工具冒充上架图。
- 单图不走套图报价:独立生图和图片编辑不调用
quote_commerce_image_credits,不经过套图的报价/上传登记/批量编号流程。 - 画布不负责生成:打开画布、读取画布状态、把图片放入画布等操作由 Agent Canvas 处理,本 Skill 不调用
open_agent_canvas/insert_agent_canvas_image/replace_agent_canvas_image。
单图文生图流程
用户没有提供参考图、要求根据提示词生成单张图片时:
conversationId必须原样使用宿主当前会话 ID(亦可能写作conversation_id),不得自行生成或改写。- 首次调用生成新的 UUID v4 图片生成
request_id;提交、查询、重试必须复用同一个request_id,失败后也不得换新。 - 调用
generate_agent_canvas_image,传入conversationId、request_id、prompt,outputCount固定为 1,referenceImages为空或不传。未传agentCanvasSessionId时服务端按conversationId自动开/复用画布会话,结果自动写回画布——这是服务端的承接行为,生图任务本身仍属本能力。 - 需轮询时用
get_agent_canvas_image_status(同一request_id+ 返回的job_id)。 - 成功后简要告知生成结果;勿输出 ticket / functionsUrl。若用户要求把结果放到画布,交给 Agent Canvas 处理。
单图图生图流程
用户提供了参考图、要求基于参考图生成单张图片时:
- 确认参考图已可访问(本地路径或已登记的 URL)。本地素材需先通过电商套图链路之外的方式取得可访问 URL——本能力不经过
get_reference_image_upload_token/register_reference_image套图登记链路;若参考图来自用户附件,直接使用附件 URL。 conversationId、request_id规则同文生图。- 调用
generate_agent_canvas_image,传入conversationId、request_id、prompt、referenceImages(数组,每项含url,最多 5 张),outputCount固定为 1。 - 轮询与结果处理同文生图。
图片编辑流程
用户要求对已有图片进行修改(换背景、改风格、加元素等)时:
- 确认编辑目标不是电商主图/详情图/套图——如果是,路由到电商套图的局部返工。
- 将待编辑图片作为
referenceImages传入,prompt描述编辑意图(如"把背景换成厨房场景")。 - 其余流程同图生图。
- 编辑完成后,若用户要求在画布上继续微调,交给 Agent Canvas 承接;若用户要求把编辑后的图传回对话,由画布→对话机制处理(宿主投递,不经过 MCP)。
结果处理
- 成功:简要告知生成/编辑完成,说明结果已可用。不输出 ticket、functionsUrl 或内部会话 ID。
- 失败:复用同一
request_id重试一次,不改走套图链路。重试仍失败时如实说明,不编造结果。 - 画布承接:生图结果由服务端自动写回画布(若用户在画布环境中);若用户明确要求把结果放入或替换到画布,路由到 Agent Canvas 的
insert_agent_canvas_image/replace_agent_canvas_image。 - 积分不足:停止后续生成,调用
open_agent_pricing打开连接器统一充值面板,不得向用户展示充值 URL 或 ticket。
MCP 工具速查
| 工具 | 用途 | 调用阶段 |
|---|---|---|
generate_agent_canvas_image |
单图生成(文生图/图生图/图片编辑),outputCount 固定 1 | 生成提交 |
get_agent_canvas_image_status |
查询单图任务状态与结果 | 轮询 |
调用 MCP 工具前,必须使用 tool_search 按工具名获取完整参数定义,再按取回的定义发起调用。运行时工具名可能带有后缀,以 tool_search 返回的实际名称为准。
注:
generate_agent_canvas_image工具名中虽含 "canvas",但其定位是独立单图生成工具;画布承接是服务端的联动行为,不改变本能力的独立生图定位。