灵瑶视觉PARTNER PROGRAM
PARTNER API / V1

FOR MINI PROGRAMS & PRODUCT TEAMS

合作方穿搭迁移 API 接入说明

输入用户全身照和穿搭参考图,异步生成穿搭效果图。平台提供鉴权、任务队列、供应商适配和结果交付。

单次调用
¥0.30
交付方式
轮询 / Webhook
鉴权方式
服务端 HMAC

01 / CAPABILITY

能力范围

请求包含两张私有图片:本人全身照与穿搭参考图。身高、体重、胸围、腰围、臀围等测量字段全部选填,不接收姓名、手机号等非必要身份信息。

IN本人全身照用于保留人物姿态与身份特征
IN穿搭参考图用于提取服装、配饰和整体造型
OUT穿搭效果图仅提供效果图,不暴露上游供应商

02 / INTEGRATION

接入流程

  1. 01
    企业审核与预充值

    提交企业资料和服务场景。审核通过后,财务按对公转账确认余额。

  2. 02
    服务端签名调用

    第三方小程序只调用你自己的后端;AccessKey 与 SecretKey 不放入小程序包。

  3. 03
    上传、创建、交付

    先创建私有上传会话,再创建异步任务;通过轮询或预登记 HTTPS Webhook 获取结果。

POST /v1/try-on/tasks
X-Partner-Key: pk_sandbox_•••
X-Timestamp: 1786240800000
X-Nonce: request_nonce_•••
X-Signature: hmac_sha256_hex
Idempotency-Key: order_20260809_0001

03 / PRICING & DELIVERY

计费与结果交付

30 分创建任务时冻结
24 h结果保留时间
30 min结果 URL 有效期
10 min任务总超时

生图失败、取消或超时释放冻结金额;上游重试不会重复扣费。余额按人民币“分”存储,第一期采用企业对公转账与财务人工入账,不提供授信、提现或合作方之间转账。

04 / SECURITY & COMPLIANCE

安全与合规要求

合作方需要向终端用户说明处理目的、图片范围、保存期限、上游接收方和删除方式,并在创建任务时提交授权版本、时间、证据编号和年龄分组。第一期拒绝未成年人任务。

图片不会公开。上传地址一次性、短时有效;我们不向合作方返回 CloudBase fileID,结果通过短期签名 URL 交付。

05 / APPLY

合作商入驻申请

申请时请说明企业主体、产品名称、预计日调用量、用户授权方式和回调地址。审核通过后,我们会为你开通 Sandbox 应用与独立密钥。

审核通过后将获得独立 Sandbox 应用与密钥;合作方控制台将在独立域名部署后开放。