crossimage 图片翻译

概述

crossimage 用于翻译一张跨境电商商品图。当前为限时推广阶段，单张仅需 ¥0.01，固定使用 Economy 档位，适合低门槛体验和日常商品图处理。

付款成功后，服务会创建真实生产翻译任务。若首次生成失败，服务端只会在 Economy 档位自动重试一次，不会切换到 Balanced 或 Premium；第二次仍失败则按现有规则全额退款。

用户体验原则

• 先说明“当前限时推广体验价 ¥0.01/张”，取得用户对本次付款流程的确认。
• 支付完成后自动等待结果，不让用户手动拼接接口或填写 API Key。
• 翻译成功后，优先在当前对话中直接展示结果图片。
• 同时提供“下载结果图”和“下载完整 ZIP”入口。
• 不向用户展示生产 API Key、微信支付码、交易号、服务器本地路径或其他内部凭据。

支持范围

• 每次处理一张图片。
• 支持目标语言：EN、ZH、RU、AR、DE、JA、KO、FR、ES。
• 本地图片使用 --image-path，公共 HTTPS 图片使用 --image-url，两者只能选择一个。
• 本地图片最大 8 MiB；脚本只发送图片内容、文件名和 MIME 类型，不发送本地路径。

使用流程

1. 创建支付订单

本地图片：

python scripts/crossimage_pay.py checkout 
  --image-path "/absolute/path/product.png" 
  --target-lang EN 
  --confirm-create-order

公共 HTTPS 图片：

python scripts/crossimage_pay.py checkout 
  --image-url "https://example.com/product.png" 
  --target-lang EN 
  --confirm-create-order

未提供 --confirm-create-order 时，脚本必须停止且不得创建订单。成功后保存返回的私有 state_file，不要再次运行 checkout。

2. 发起微信支付

从结果中读取 WeixinPay.WeixinPay-Required，把它作为 paymentCode 调用 weixinpay_pay，由用户在微信支付界面确认 ¥0.01。不要修改金额，也不要把 Agent 显示的“支付成功”当作商户侧到账凭证。

3. 继续同一个订单

python scripts/crossimage_pay.py retry 
  --state-file "<第一步返回的 state_file>"

必须复用同一个 state_file。脚本会恢复完全相同的图片、语言、Agent 身份、支付码和订单号，避免重复扣款或重复创建任务。

4. 展示最终结果

• HTTP 202 / PROCESSING：等待 retry_after_seconds，再使用同一个 state_file 重试。
• HTTP 402 / NOT_PAID：付款尚未确认；不要创建新订单。
• HTTP 200 / SUCCESS：将 delivery.result_images[*].preview_url 用 Markdown 图片直接展示；再提供对应 download_url 和 delivery.result_package.download_url。
• REFUNDED：服务无法交付，款项已全额退回，停止重试。
• REFUND_PROCESSING：退款处理中，不要再次支付。
• FULFILL_AND_REFUND_FAILED：保留订单号并联系商户支持，不要再次支付。

结果链接是短时有效的安全签名链接，不包含生产 API Key 或支付凭据。链接失效后，应从原订单重新获取，不能绕过鉴权永久公开文件。

生产接口

客户端调用：

POST https://mcp.di-matrix.com/skillpay/v1/resource

支付签名、商户查单、生产鉴权、翻译履约、一次 Economy 自动重试、退款和结果签名均由服务端完成，Skill 内不保存这些密钥。