下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/aiulink--product-scene.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @aiulink/product-scene。白底产品图一键生成电商场景图,保持产品主体不变融入目标场景
阅读全文 (展开查看完整说明)
概述
上传一张产品图(白底图最佳),描述想要的场景,AI 在保持产品主体完全不变(外观、颜色、logo、比例)的前提下,将其自然融入目标场景,输出专业电商摄影质感的场景图,可直接用于主图/详情页/A+ 页面。本 Skill 为按次付费服务,每次成功出图收费 0.30 元,费用由用户直接支付给创作者。
元数据
| 字段 | 值 |
|---|---|
| skill_id | dny-product-scene |
| skill_version | 1.0.0 |
| product_id | dny-product-scene |
| capability | image_to_image |
服务地址
Base URL:https://posterapi.aiulink.com
统一接口:POST {Base URL}/skillpay/v1/scene/invoke
付费前置检查
调用本 Skill 前,检查当前 Agent 是否已安装 weixinpay 插件:
- ✅ 已安装:可继续提供付费服务
- ❌ 未安装:向用户提示「当前 Agent 暂不支持微信支付付费能力」,终止流程
命中创作意图后,先向用户展示服务名称「AI商品场景图」和价格「0.30 元/次」,由用户确认后再进入付费流程。
工作流程
第一步:请求资源
POST {Base URL}/skillpay/v1/scene/invoke
Content-Type: application/json
{
"image_url": "https://example.com/product-white-bg.png",
"scene": "北欧风客厅的茶几上,清晨柔和阳光从左侧窗户洒入",
"size": "1:1"
}请求字段:
| 字段 | 必填 | 说明 |
|---|---|---|
| image_url | 是 | 产品图 URL(http/https 可公开访问;白底图效果最佳) |
| scene | 是 | 目标场景描述,光线/材质/氛围越具体效果越好 |
| size | 否 | 图片比例,如 1:1、4:3、3:4、16:9,默认方形 |
如果用户只提供了本地图片文件,先引导用户提供可访问的图片 URL(或经你的文件能力上传后的 URL)再调用。
第二步:处理 402 响应
未支付时接口返回 HTTP 402。提取并同时保存以下两个值,两者缺一不可:
- Header
WeixinPay-Required:支付码(payment_code) - Header
X-Out-Trade-No:商户订单号
第三步:发起支付
将第二步保存的 WeixinPay-Required 值作为 paymentCode,调用 weixinpay_pay 向用户申请支付授权,引导用户完成支付。
第四步:支付成功后获取图片(⚠️ 必须执行)
支付成功后必须重新请求本接口,否则永远拿不到图片:
POST {Base URL}/skillpay/v1/scene/invoke
Content-Type: application/json
WeixinPay-Required: <第二步保存的支付码>
X-Out-Trade-No: <第二步保存的订单号>
{"image_url": "...", "scene": "...", "size": "1:1"} // body 与第一步完全一致,不得修改任何字段- JSON body 必须与第一步原样一致,订单信息只通过 Header 传递
- 验证通过后执行图生图(耗时约 30-90 秒,属正常现象,请勿中断重发)
- 成功返回 HTTP 200,
content.image_url即场景图 URL,将图片展示给用户 - 若返回
"code": "NOT_PAID",说明支付尚未完成,稍等几秒后原样重试 - 若返回
"code": "REFUNDED",说明服务异常已自动全额退款:向用户说明「服务暂时不可用,款项已原路退回」,不要再次支付或重试
错误处理
| HTTP | code | 含义与处理 |
|---|---|---|
| 400 | BAD_REQUEST | 缺少 image_url/scene 或图片地址非法,修正后重新发起 |
| 402 | PAYMENT_REQUIRED / NOT_PAID | 需要支付或支付未完成:完成支付后原样重试 |
| 404 | ORDER_NOT_FOUND / PRODUCT_NOT_FOUND | 订单号或商品不存在,检查后重新发起 |
| 409 | BODY_MISMATCH | 重试 body 与首次不一致,恢复原 body 后重试 |
| 200 | REFUNDED | 服务异常已自动全额退款,告知用户并终止流程 |
| 500 | FULFILL_AND_REFUND_FAILED | 服务异常且退款失败,建议用户联系客服 |
| 502 | PREORDER_FAILED / QUERY_FAILED | 支付链路异常,稍后原样重试 |
| 503 | SERVICE_DISABLED / CONFIG_INCOMPLETE | 服务暂不可用,提示用户稍后再试 |
计费说明
- 单价 0.30 元/次(以 SkillHub 后台配置为准),每笔订单支付成功后仅可履约一次
- 同一订单重复请求返回缓存结果(
already_fulfilled: true),不重复扣费 - 支付成功但因服务异常未能出图时,系统自动全额退款,用户无需任何操作
- 订单有效期约 15 分钟,过期后重新发起即可生成新订单