跨境商品一键上架包

概述

这是一个支持微信 Agent Pay 的 Pay Skill。服务地址为 https://api.arcdovion.com，免费预检不收费；预检通过并取得用户明确同意后，每次付费生成收费 9.90 元人民币。

一次处理一个商品和1～10张PNG/JPEG图片，生成Amazon美国站英文标题、5条Bullet Points、描述、Search Terms、SKU变体草表、风险核对报告，以及白底主图、卖点图、场景图和细节图共4张商品图，最终交付ZIP上架包。

使用边界

V1只处理Amazon美国站和英文输出。不得抓取1688、淘宝或Amazon链接；用户只有链接时，请其上传合法持有的商品主图或详情页截图。不得索取店铺密码、Cookie、Access Token、银行卡或Seller Central凭据，不得自动登录或发布Listing。

不得编造没有图片或用户文字证据的材料、尺寸、重量、认证、兼容性、包装清单、功效、销量、评价或品牌授权。不确定信息必须列入待人工确认项。不得承诺Amazon审核通过、销量提升或不侵权。

上传前说明：图片会发送到发布者API，并由火山方舟模型进行图片理解、英文文案及商品图生成；文件按服务端保留策略删除。用户必须确认拥有使用和改编素材的权利，否则不上传、不创建订单。

付费前置检查

调用前确认当前Agent已安装 weixinpay 并可调用 weixinpay_pay：

• 可以调用：继续上传和免费预检。
• 无法调用：提示“当前Agent暂不支持微信支付付费能力”，立即终止，不上传文件、不创建订单。

免费预检通过后，向用户明确说明“本次生成收费9.90元，包含英文Listing、Excel草表、风险报告和4张商品图”，取得明确付费同意后才能请求付费接口。

第一步：上传商品图片

对每张图片调用：

POST https://api.arcdovion.com/v1/uploads
Content-Type: multipart/form-data

file=<PNG或JPEG文件>

保存每次响应中的 upload_id。接受1～10张图片，合计不超过20MB，每张至少256×256像素。不要重复上传同一文件。

第二步：免费预检

调用以下免费接口，不会创建支付订单：

POST https://api.arcdovion.com/v1/skills/global-product-listing-kit/preflight
Content-Type: application/json

{
  "uploadIds": ["上传接口返回的upload_id"],
  "product": {
    "chineseTitle": "可选中文商品名",
    "brandName": "可选品牌，无品牌可填Unbranded",
    "specifications": "可选，仅填写确认过的规格",
    "keySellingPoints": "可选，仅填写确认过的卖点",
    "targetPriceUsd": 29.99,
    "rightsConfirmed": true
  }
}

只有HTTP 200且同时返回 supported:true、chargeable:true 才能继续。预检失败时向用户说明错误，不得请求付费接口。

第三步：请求付费生成

生成一个本次任务内固定不变的 requestId，允许8～64位字母、数字、连字符或下划线。调用：

POST https://api.arcdovion.com/v1/skills/global-product-listing-kit/generate
Content-Type: application/json

{
  "requestId": "listing-task-固定请求ID",
  "uploadIds": ["与预检完全相同的upload_id"],
  "product": {
    "chineseTitle": "与预检相同",
    "brandName": "与预检相同",
    "specifications": "与预检相同",
    "keySellingPoints": "与预检相同",
    "targetPriceUsd": 29.99,
    "rightsConfirmed": true
  }
}

第一次请求的预期响应是HTTP 402 Payment Required。服务端已经完成微信支付下单和SkillHub X402 AI预下单，并同时通过Header与Body返回支付码：

HTTP/1.1 402 Payment Required
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
Content-Type: application/json

{
  "code": "PAYMENT_REQUIRED",
  "message": "Payment authorization is required.",
  "WeixinPay": {
    "WeixinPay-Required": "<payment_code>",
    "prompt": "请将支付码交给weixinpay_pay，支付成功后使用完全相同的请求体和两个支付响应头重试。"
  },
  "out_trade_no": "<out_trade_no>",
  "amount": "9.90",
  "currency": "CNY"
}

必须原样保存 WeixinPay-Required 和 X-Out-Trade-No。如果Agent只能读取响应Body，从 WeixinPay["WeixinPay-Required"] 取得同一个支付码。不得自行解析、构造或替换支付码。

第四步：调用微信支付

把完整 WeixinPay-Required 值作为 paymentCode，只调用一次：

weixinpay_pay(paymentCode=<完整的WeixinPay-Required值>)

由用户在微信支付AI专属卡中确认付款。不得代替用户确认支付，不得因为等待或生成较慢而再次调用 weixinpay_pay。

第五步：支付后重试并获取结果

支付成功后，必须重新调用同一个付费生成接口：

POST https://api.arcdovion.com/v1/skills/global-product-listing-kit/generate
Content-Type: application/json
WeixinPay-Required: <第三步保存的payment_code>
X-Out-Trade-No: <第三步保存的out_trade_no>

请求Body必须与第三步完全一致，包括 requestId、图片顺序和商品信息。

• HTTP 202：后台生成中。按 retry_after_seconds 等待，然后携带相同Body和两个支付Header再次轮询；不得重新支付或创建新订单。
• HTTP 200：生成完成。读取 download_url，拼接 https://api.arcdovion.com 下载ZIP并交付用户。
• already_fulfilled:true：返回同一订单的已有结果，不会重复收费。

结果下载接口形如：

GET https://api.arcdovion.com/v1/skills/global-product-listing-kit/results/<result_token>

异常处理

• HTTP 409：请求内容或支付上下文不一致，保留原订单并停止，不创建新订单。
• HTTP 410：结果已过期，提示用户联系支持，不重新收费。
• HTTP 429、500、502、503、504：停止自动重试，保留 out_trade_no，明确告知已付款用户不要再次支付。
• 支付是否成功必须以商户服务端微信回调或查单结果为准，不能仅凭Agent侧的支付提示推断。

成功标准

成功结果必须包含英文标题、恰好5条Bullet Points、描述、Search Terms、商品事实、待确认字段、风险报告、SKU变体草表、4张商品图和ZIP下载地址。先提醒用户检查 risk-report.md 与中文核对稿，再使用 amazon-listing.xlsx 和 images/；所有生成内容都需要人工复核。