下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/ixhlink--ixhlink-skills-image-edit-pro.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @ixhlink/ixhlink-skills-image-edit-pro。智能图片编辑助手,根据文字描述对已上传图片进行风格化、调色、局部修改、背景替换等 AI 修图,当用户要求「修图」「改图」「P图」「编辑图片」「换背景」「调色」「风格化」「图片后期处理」时使用。
阅读全文 (展开查看完整说明)
概述
元数据
| 字段 | 值 |
|---|---|
| skill_id | ixhlink-skills-image-edit-pro |
| skill_version | 1.0.0 |
| product_id | ixhlink-skills-image-edit-pro |
| model_key | ixhlink-skills-image-edit-pro |
| capability | image_edit |
服务地址
Base URL:https://iskills.ixhlink.com
下文接口均写路径(如 /api/v1/llm/invoke),完整地址 = Base URL + 路径。
统一响应格式:
{"success": true, "code": 0, "message": "ok", "data": {}}调用流程
image_edit 为慢任务,默认异步。典型流程:
- (可选)
GET /api/v1/llm/models确认模型已启用 POST /api/v1/llm/invoke提交编辑请求- 若返回 402:调起微信支付,成功后用相同 JSON body 重试,Header 附带
WeixinPay-Required与X-Payment-Id - 从响应取
data.task.id,轮询GET /api/v1/llm/tasks/{task_id}直至status = succeeded - 从
data.result.data[].url读取输出图片 URL
也可直接用 POST /api/v1/llm/tasks 创建异步任务(请求体相同,强制异步)。
1. 查询模型(可选)
GET /api/v1/llm/models
Accept: application/json确认返回的 items 中包含:
{"model": "ixhlink-skills-image-edit-pro", "capability": "image_edit"}2. 提交图片编辑
POST /api/v1/llm/invoke
Content-Type: application/json请求体:
{
"capability": "image_edit",
"model": "ixhlink-skills-image-edit-pro",
"payload": {
"prompt": "给图片加上温暖的日落色调",
"images": [
{
"b64": "<base64>",
"filename": "sample.png",
"mime_type": "image/png"
}
],
"response_format": "url"
}
}payload 字段:
| 字段 | 必填 | 说明 |
|---|---|---|
prompt | 是 | 编辑描述 |
images | 是 | 参考图数组,至少 1 张 |
images[].b64 | 二选一 | 图片 Base64(与 url 二选一) |
images[].url | 二选一 | 可公网访问的图片 URL |
images[].filename | 否 | 文件名,默认 image.png |
images[].mime_type | 否 | MIME 类型,如 image/png |
response_format | 否 | 建议 url(默认) |
size | 否 | 如 1024x1024 |
提交成功响应(异步):
{
"success": true,
"code": 0,
"message": "任务已提交",
"data": {
"task": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "pending",
"capability": "image_edit",
"model_key": "ixhlink-skills-image-edit-pro"
}
}
}3. 轮询任务结果
GET /api/v1/llm/tasks/{task_id}
Accept: application/json任务状态: pending → running → succeeded / failed
建议间隔 2–5 秒轮询,超时可根据业务设为 3–5 分钟。
成功响应示例:
{
"success": true,
"code": 0,
"message": "ok",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "succeeded",
"result": {
"data": [
{"url": "https://oss.example.com/edited.png"}
]
}
}
}输出图片 URL 在 data.result.data[].url。
付费前置检查
调用本 Skill 前,必须检查当前 Agent 是否已安装支付能力(weixinpay extension):
- ✅ 已安装:可继续提供付费创作服务
- ❌ 未安装:向用户提示「当前 Agent 暂不支持付费创作能力」,终止流程
服务与定价
| 产品ID | 服务内容 | 单价 |
|---|---|---|
ixhlink-skills-image-edit-pro | 全能图片编辑 | 0.8 元/次 |
价格以 SkillHub 后台配置为准。命中创作意图后,向用户展示服务名称和价格,由用户确认后进入付费流程。
付费说明
当 amount_fen > 0 且未完成支付时,首次 POST /api/v1/llm/invoke 会返回 HTTP 402,响应中携带:
- Header:
WeixinPay-Required: <payment_code>、X-Payment-Id: <payment_id> - Body:
WeixinPay对象(含payment_id、prompt等)
客户端流程(Agent / MCP / Web):
首次 invoke → 402 → weixinpay_pay(payment_code) → 支付成功后重试 invoke「原样重试」的含义:
- JSON body 不变:
model、capability、payload必须与首次请求完全一致 - 订单参数单独带上:将 402 中的
payment_code、payment_id通过 Header 传入(推荐),或写入 body 的WeixinPay;勿改payload业务字段来传订单号
重试请求示例:
POST /api/v1/llm/invoke
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Payment-Id: <payment_id>
{"model":"ixhlink-skills-image-edit-pro","capability":"image_edit","payload":{...}}amount_fen = 0 时可跳过支付,直接调用。每笔订单按次消费,使用后不可复用。
错误处理
| HTTP | 常见原因 |
|---|---|
| 400 | 缺少 model、payload 非法、参考图为空 |
| 402 | 需付费或 X402 预下单失败 |
| 404 | 模型未启用或 capability 不匹配 |
| 503 | 服务暂不可用 |
任务失败时 status = failed,查看 data.error_message(已脱敏,不含上游地址或内部日志)。