技能介绍

在数字内容创作和自动化处理中，图片编辑往往依赖专业软件或手动操作，难以通过编程快速集成。智绘图片编辑技能提供了一个 API 接口，允许开发者基于文本描述和参考图片，自动执行图片编辑任务，从而简化工作流程。

该技能的核心能力是 image_edit，通过 prompt 参数指定编辑描述，并使用 images 数组提供至少一张参考图片。关键步骤包括：

提交编辑请求：使用 POST 方法调用 /api/v1/llm/invoke 或 /api/v1/llm/tasks 接口。请求体需包含 model、capability 和 payload 字段，其中 payload 中必须设置 prompt 和 images。图片支持 Base64 或 URL 格式。
异步处理流程：由于编辑任务可能耗时，默认采用异步模式。提交成功后，会返回一个任务 ID（task_id）。开发者需要轮询 GET /api/v1/llm/tasks/{task_id} 来检查任务状态（pending、running、succeeded 或 failed），建议轮询间隔为 2–5 秒。
集成支付：如果任务涉及付费（单价 0.5 元/次），首次请求可能返回 HTTP 402 响应，其中包含微信支付信息。开发者必须确保 Agent 已安装微信支付扩展（weixinpay extension），然后调起支付，并在支付成功后用相同的 JSON body 重试请求，同时在 Header 中添加 WeixinPay-Required 和 X-Payment-Id。
获取结果：任务成功后，从响应中的 data.result.data[].url 提取输出图片的 URL，以便后续使用。

付费依赖：调用前必须检查 Agent 是否支持微信支付。如果不支持，应终止流程并提示用户「当前 Agent 暂不支持付费创作能力」。
异步延迟：由于任务异步执行，响应时间可能从几秒到几分钟不等，开发者需设置合理的超时（如 3–5 分钟）并避免阻塞主线程。
错误处理：常见错误包括 HTTP 400（请求非法或参数缺失）、402（需付费但未支付）、404（模型未启用）和 503（服务暂不可用）。任务失败时，查看 data.error_message 获取脱敏后的错误详情。
定价透明：在提交付费任务前，应向用户明确展示服务名称和价格（0.5 元/次），获得确认后再进入支付流程，以避免意外扣费。