2026-03-09 11:41:49 +08:00

58 KiB

Raw Blame History

petsHeroAI V2 客户端接入指引

通用信息

项目	值
加密方式	AES-128-ECB, PKCS5Padding, Base64
AES Key	`liyP4LkMfP68XvCt`
预发域名	`pre-ai.petsheroai.xyz`
生产域名	`ai.petsheroai.xyz`
代理入口	`POST {baseUrl}/quester/defender/summoner`
包名	`com.petsheroai.app`

加密流程

    构造业务参数
         |
         v
     字段名映射
  (body + params + headers)
         |
         v
      V2包装
    (body only)
         |
         v
    JSON序列化
         |
         v
    AES + Base64
         |
         v
  填入代理请求 b/p 参数
         |
         v
    POST 代理入口

代理请求结构

所有接口统一 POST 到代理入口，请求体结构如下：

{
  "hero_class": "petsHeroAI",              // appId 明文
  "pet_species": "<AES(接口路径)>",       // AES(原始path) → Base64
  "power_level": "<AES(HTTP方法)>",       // AES("POST"或"GET") → Base64
  "quest_rank": "<AES(请求头JSON)>",     // AES(映射后的Header字段名JSON) → Base64
  "battle_score": "<AES(查询参数JSON)>",    // AES(映射后的参数名JSON) → Base64
  "loyalty_index": "<AES(V2请求体JSON)>",    // AES(V2包装后的业务数据) → Base64
  "billing_addr": "<每次请求随机 Base64>",    // 噪音
  "utm_term": "<每次请求随机 Base64>",    // 噪音
  "cluster_id": "<每次请求随机 Base64>",    // 噪音
  "lsn_value": "<每次请求随机 Base64>",    // 噪音
  "accuracy_val": "<每次请求随机 Base64>",    // 噪音
  "dir_path": "<每次请求随机 Base64>"    // 噪音
}

注意: 即使原始接口为 GET（无请求体），走代理后也统一使用 POST，b 参数仍需传入 V2 包装后的空业务体。噪音 key 的值为每次请求随机生成的 Base64 字符串（模拟 AES 密文外观），服务端会忽略。

V2 包装结构

业务数据经字段映射后，按以下结构包装：

{
  "arsenal": 4,                         // 固定值
  "vault": {
    "tome": {
      "codex": {
        "grimoire": {
          "sanctum": { /* 映射后的业务字段 */ }
        }
      }
    }
  },
  "roar": "<每次请求随机生成8位字母数字组合>",
  "clash": "<每次请求随机生成8位字母数字组合>",
  "thunder": "<每次请求随机生成8位字母数字组合>",
  "rumble": "<每次请求随机生成8位字母数字组合>",
  "howl": "<每次请求随机生成8位字母数字组合>",
  "growl": "<每次请求随机生成8位字母数字组合>"
}

登录态接口

登录后，所有请求 Header 需带 knight

1. 获取推荐提示词

GET /v1/image/prompt/recomends | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "crest": "",    // ch — 渠道号
  "asset": ""    // userId — 用户ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 推荐提示词列表
    {
      "constrain": "",    // tag (string) 标签
      "ledger": ""    // prompt (string) 文本提示词
    }
  ]
}

2. 设备登录（快速登录）

POST /v1/user/fast_login | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "crest": "",    // ch — 渠道号
  "portal": "",    // pkg — 应用包名（必填）
  "accolade": ""    // type — 类型
}

请求体 (字段映射后):

{
  "digest": "",    // referer (string) 归因信息，如 utm_source=googleplay
  "resolution": "",    // sign (string) 签名，MD5(deviceId)大写32位
  "origin": ""    // deviceId (string) 设备ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "surge": "",    // extConfig (string) 客户端界面配置下发
    "accolade": "",    // type (string) 类型
    "evolve": {},    // appFbConfig (object) 应用FB配置
    "retrospect": "",    // usign (string) 用户签名
    "navigate": "",    // countryCode (string) 国家代码
    "conquer": "",    // creditsRecordUrl (string) 积分记录URL
    "concession": "",    // tgId (string) Telegram ID
    "reveal": 0,    // credit (int) 积分余额
    "defer": "",    // tgName (string) Telegram 用户名
    "galaxy": "",    // email (string) 邮箱
    "nexus": {},    // ext (object) 扩展信息
    "upgrade": false,    // forcePayCenter (boolean) 是否强制跳转支付中心
    "regulate": {},    // t2IConfig (object) T2I配置
    "pursue": {},    // h5UrlConfig (object) H5 URL配置
    "switch": "",    // payCenterUrl (string) 支付中心URL
    "vow": 0,    // freeBlurTimes (int) 免费去模糊次数
    "realm": "",    // avatar (string) 头像URL
    "terminal": "",    // userName (string) 用户名
    "equip": false,    // firstRegister (boolean) 是否首次注册
    "asset": "",    // userId (string) 用户ID
    "generate": false,    // isVip (boolean) 是否VIP
    "rally": [],    // tags (array) 用户标签
    "decree": 0,    // freeTimes (int) 免费次数
    "reevaluate": "",    // userToken (string) 用户登录token
    "tokenize": 0,    // subScribeValidTime (int) 订阅有效时间戳
    "line": 0    // status (int) 用户状态
  }
}

3. 注销账户

GET /v1/user/delete | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": ""    // userId — 用户ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "traverse": "",    // hint (string)
    "accolade": ""    // type (string)
  }
}

4. 获取换衣模板

GET /v1/image/clothes_template | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "crest": "",    // ch — 渠道号
  "asset": "",    // userId — 用户ID
  "insignia": "1"    // categoryId — 分类ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 换衣模板列表
    {
      "congregation": "",    // templateName (string) 模板名称
      "greaves": 0,    // credits (int) 积分
      "realm": "",    // avatar (string) 头像
      "accolade": 0,    // type (int) 类型
      "rebalance": "",    // user (string) 用户
      "inject": ""    // templateUrl (string) 模板URL
    }
  ]
}

5. 获取用户通用信息

GET /v1/user/common_info | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "shield": "",    // client — 客户端标识
  "asset": "",    // userId — 用户ID
  "crest": "",    // ch — 渠道号
  "item": "",    // inviteBy — 邀请人
  "origin": "",    // deviceId — 设备ID
  "gauntlet": "",    // clientId — 客户端ID
  "portal": ""    // pkg — 应用包名（必填）
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "surge": "",    // extConfig (string) 客户端界面配置下发
    "accolade": "",    // type (string) 类型
    "evolve": {},    // appFbConfig (object) 应用FB配置
    "retrospect": "",    // usign (string) 用户签名
    "navigate": "",    // countryCode (string) 国家代码
    "conquer": "",    // creditsRecordUrl (string) 积分记录URL
    "concession": "",    // tgId (string) Telegram ID
    "reveal": 0,    // credit (int) 积分余额
    "defer": "",    // tgName (string) Telegram 用户名
    "galaxy": "",    // email (string) 邮箱
    "nexus": {},    // ext (object) 扩展信息
    "upgrade": false,    // forcePayCenter (boolean) 是否强制跳转支付中心
    "regulate": {},    // t2IConfig (object) T2I配置
    "pursue": {},    // h5UrlConfig (object) H5 URL配置
    "switch": "",    // payCenterUrl (string) 支付中心URL
    "vow": 0,    // freeBlurTimes (int) 免费去模糊次数
    "realm": "",    // avatar (string) 头像URL
    "terminal": "",    // userName (string) 用户名
    "equip": false,    // firstRegister (boolean) 是否首次注册
    "asset": "",    // userId (string) 用户ID
    "generate": false,    // isVip (boolean) 是否VIP
    "rally": [],    // tags (array) 用户标签
    "decree": 0,    // freeTimes (int) 免费次数
    "reevaluate": "",    // userToken (string) 用户登录token
    "tokenize": 0,    // subScribeValidTime (int) 订阅有效时间戳
    "line": 0    // status (int) 用户状态
  }
}

6. 归因上报

POST /v1/user/referrer | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "accolade": "",    // type — 类型
  "portal": ""    // pkg — 应用包名（必填）
}

请求体 (字段映射后):

{
  "digest": "",    // referer (string) 归因信息，如 utm_source=googleplay
  "origin": ""    // deviceId (string) 设备ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "traverse": "",    // hint (string)
    "accolade": ""    // type (string)
  }
}

7. 获取用户账户信息

GET /v1/user/account | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": ""    // userId — 用户ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "surge": "",    // extConfig (string) 客户端界面配置下发
    "accolade": "",    // type (string) 类型
    "evolve": {},    // appFbConfig (object) 应用FB配置
    "retrospect": "",    // usign (string) 用户签名
    "navigate": "",    // countryCode (string) 国家代码
    "conquer": "",    // creditsRecordUrl (string) 积分记录URL
    "concession": "",    // tgId (string) Telegram ID
    "reveal": 0,    // credit (int) 积分余额
    "defer": "",    // tgName (string) Telegram 用户名
    "galaxy": "",    // email (string) 邮箱
    "nexus": {},    // ext (object) 扩展信息
    "upgrade": false,    // forcePayCenter (boolean) 是否强制跳转支付中心
    "regulate": {},    // t2IConfig (object) T2I配置
    "pursue": {},    // h5UrlConfig (object) H5 URL配置
    "switch": "",    // payCenterUrl (string) 支付中心URL
    "vow": 0,    // freeBlurTimes (int) 免费去模糊次数
    "realm": "",    // avatar (string) 头像URL
    "terminal": "",    // userName (string) 用户名
    "equip": false,    // firstRegister (boolean) 是否首次注册
    "asset": "",    // userId (string) 用户ID
    "generate": false,    // isVip (boolean) 是否VIP
    "rally": [],    // tags (array) 用户标签
    "decree": 0,    // freeTimes (int) 免费次数
    "reevaluate": "",    // userToken (string) 用户登录token
    "tokenize": 0,    // subScribeValidTime (int) 订阅有效时间戳
    "line": 0    // status (int) 用户状态
  }
}

8. 获取Google商品列表

GET /v1/payment/getGooglePayActivities | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "shield": "",    // client — 客户端
  "vambrace": "",    // country — 国家代码
  "portal": ""    // pkg — 应用包名（必填）
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "cleanse": [    // subscriptionActivitys (array) 订阅商品列表
      {
        "extrapolate": "",    // note (string) 备注
        "helm": "",    // code (string) 产品代码
        "forge": 0,    // bonus (int) 赠送积分
        "guardian": "",    // actualAmount (string) 实际金额
        "lead": "",    // discountOff (string) 折扣
        "glossary": "",    // title (string) 标题
        "curriculum": "",    // originAmount (string) 原价
        "warrior": "",    // activityId (string) 活动ID
        "distribute": "",    // subscriptionPeriod (string) 订阅周期
        "greaves": 0,    // credits (int) 积分数
        "shield": "",    // client (string) 客户端
        "species": 0,    // days (int) 天数
        "familiar": "",    // currency (string) 货币
        "subtract": 0    // productType (int) 产品类型
      }
    ],
    "summon": [    // activitys (array) 商品列表
      {
        "extrapolate": "",    // note (string) 备注
        "helm": "",    // code (string) 产品代码
        "forge": 0,    // bonus (int) 赠送积分
        "guardian": "",    // actualAmount (string) 实际金额
        "lead": "",    // discountOff (string) 折扣
        "glossary": "",    // title (string) 标题
        "curriculum": "",    // originAmount (string) 原价
        "warrior": "",    // activityId (string) 活动ID
        "distribute": "",    // subscriptionPeriod (string) 订阅周期
        "greaves": 0,    // credits (int) 积分数
        "shield": "",    // client (string) 客户端
        "species": 0,    // days (int) 天数
        "familiar": "",    // currency (string) 货币
        "subtract": 0    // productType (int) 产品类型
      }
    ]
  }
}

9. 获取Apple商品列表

GET /v1/payment/getApplePayActivities | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "shield": "",    // client — 客户端
  "vambrace": "",    // country — 国家代码
  "portal": ""    // pkg — 应用包名（必填）
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "cleanse": [    // subscriptionActivitys (array) 订阅商品列表
      {
        "extrapolate": "",    // note (string) 备注
        "helm": "",    // code (string) 产品代码
        "forge": 0,    // bonus (int) 赠送积分
        "guardian": "",    // actualAmount (string) 实际金额
        "lead": "",    // discountOff (string) 折扣
        "glossary": "",    // title (string) 标题
        "curriculum": "",    // originAmount (string) 原价
        "warrior": "",    // activityId (string) 活动ID
        "distribute": "",    // subscriptionPeriod (string) 订阅周期
        "greaves": 0,    // credits (int) 积分数
        "shield": "",    // client (string) 客户端
        "species": 0,    // days (int) 天数
        "familiar": "",    // currency (string) 货币
        "subtract": 0    // productType (int) 产品类型
      }
    ],
    "summon": [    // activitys (array) 商品列表
      {
        "extrapolate": "",    // note (string) 备注
        "helm": "",    // code (string) 产品代码
        "forge": 0,    // bonus (int) 赠送积分
        "guardian": "",    // actualAmount (string) 实际金额
        "lead": "",    // discountOff (string) 折扣
        "glossary": "",    // title (string) 标题
        "curriculum": "",    // originAmount (string) 原价
        "warrior": "",    // activityId (string) 活动ID
        "distribute": "",    // subscriptionPeriod (string) 订阅周期
        "greaves": 0,    // credits (int) 积分数
        "shield": "",    // client (string) 客户端
        "species": 0,    // days (int) 天数
        "familiar": "",    // currency (string) 货币
        "subtract": 0    // productType (int) 产品类型
      }
    ]
  }
}

10. 创建支付订单

POST /v1/payment/createPayment | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": ""    // userId — 用户ID
}

请求体 (字段映射后):

{
  "sentinel": "",    // app (string) 应用标识（必填）
  "bazaar": "",    // lastName (string) 姓
  "vambrace": "",    // country (string) 国家代码
  "dominion": "",    // expireMonth (string) 过期月
  "captain": "",    // accountName (string) 账户名
  "frame": "",    // userInfoType (string) 用户信息类型
  "legend": false,    // automaticRenewal (boolean) 是否自动续费
  "lineage": "",    // channel (string) 渠道
  "companion": "",    // cvcCode (string) CVC安全码
  "armor": "",    // channelType (string) 渠道类型
  "asset": "",    // userId (string) 用户ID
  "warrior": "",    // activityId (string) 活动模板ID
  "appointment": "",    // firstName (string) 名
  "ceremony": "",    // subPaymentMethod (string) 子支付方式
  "block": "",    // phone (string) 电话
  "insurer": "",    // tgOrderId (string) Telegram订单ID
  "concession": "",    // tgId (string) Telegram ID
  "brigade": "",    // name (string) 姓名
  "resource": "",    // paymentMethod (string) 支付方式，如 GOOGLEPAY/APPLEPAY
  "sanctuary": "",    // expireYear (string) 过期年
  "artifact": "",    // card (string) 卡号
  "line": ""    // status (string) 状态
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "scout": {},    // features (object) 功能特性
    "handshake": [    // payTypeList (array) 支付类型列表
      {
        "mold": "",    // showName (string) 展示名称
        "brigade": "",    // name (string) 支付方式
        "greylist": "",    // icon (string) 展示图标
        "unzip": "",    // paylink (string) 支付链接
        "federation": 0,    // id (long) ID
        "invent": 0    // sort (int) 排序
      }
    ],
    "merge": "",    // issuerUrl (string) 发卡方URL
    "protect": "",    // cryptoInvoiceUrl (string) 加密发票URL
    "convert": "",    // payUrl (string) 支付URL
    "federation": "",    // id (string) 支付ID/订单ID
    "destroy": {},    // payStatus (object) 支付状态
    "transplant": 0    // openType (int) URL打开方式，0=内部/1=外部浏览器
  }
}

11. Google支付结果回调

POST /v1/payment/googlepay | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": ""    // userId — 用户ID
}

请求体 (字段映射后):

{
  "sample": "",    // signature (string) 签名
  "merchant": "",    // purchaseData (string) Google支付凭据JSON
  "federation": "",    // id (string) 支付ID/订单ID
  "asset": ""    // userId (string) 用户ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "warrior": "",    // activityId (string) 活动模板ID
    "disambiguate": "",    // redirectUrl (string) 重定向URL
    "awaken": false,    // addCredits (boolean) 是否添加积分
    "visor": "",    // count (string) 数量
    "familiar": "",    // currency (string) 货币
    "federation": "",    // id (string) 支付ID/订单ID
    "line": {}    // status (object) 状态
  }
}

12. Apple支付结果回调

POST /v1/payment/applepay | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "portal": ""    // pkg — 应用包名（必填）
}

请求体 (字段映射后):

{
  "attendee": "",    // receipt (string) Apple支付凭据
  "federation": "",    // id (string) 支付ID/订单ID
  "asset": "",    // userId (string) 用户ID
  "chronicle": ""    // transactionId (string) 交易ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "warrior": "",    // activityId (string) 活动模板ID
    "disambiguate": "",    // redirectUrl (string) 重定向URL
    "awaken": false,    // addCredits (boolean) 是否添加积分
    "visor": "",    // count (string) 数量
    "familiar": "",    // currency (string) 货币
    "federation": "",    // id (string) 支付ID/订单ID
    "line": {}    // status (object) 状态
  }
}

13. 获取支付订单列表

GET /v1/payment/getPaymentDetailList | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "resource": "",    // paymentMethod — 支付方式，如 GOOGLEPAY/APPLEPAY
  "specimen": ""    // filterStatus — 筛选状态
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": []    // data (array) 订单列表，每项含id/status/currency/count/activityId/addCredits/redirectUrl
}

14. 创建文生图任务

POST /v1/image/txt2img_create | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "crest": "",    // ch — 渠道号
  "asset": ""    // userId — 用户ID
}

请求体 (字段映射后):

{
  "declaration": 1,    // 固定传参
  "quest": "",    // aspectRatio (string) 宽高比
  "ledger": ""    // prompt (string) 文本提示词
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

15. 创建换衣任务

POST /v1/image/clothes_swap_ex | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "congregation": "",    // templateName — 模板名称
  "accolade": "1"    // type — 类型
}

请求体 (字段映射后):

{
  "profit": "",    // srcImgBase64 (string) 源图片Base64数据
  "statute": ""    // srcImgUrl (string) 源图片URL
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

16. 查询图片生成进度

GET /v1/image/progress | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "tree": ""    // taskId — 任务ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "curate": [    // imageInfos (array) 图片信息列表
      {
        "reconfigure": "",    // imgUrl (string) 图片URL
        "reify": false,    // isBlur (boolean) 是否模糊
        "royalty": 0,    // imageId (long) 图片ID
        "booking": "",    // resolution (string) 分辨率
        "reconnect": 0    // imgType (int) 图片类型
      }
    ],
    "dice": 0,    // progress (int) 进度
    "listing": 0,    // state (int) 任务状态
    "accolade": 0,    // type (int) 任务类型
    "flowStep": 0,    // waitTime (int) 等待时间
    "tree": 0,    // taskId (int) 任务ID
    "revert": 0    // queueCnt (int) 队列数量
  }
}

17. 创建视频换脸任务

POST /v1/image/video_facewap_task | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": ""    // userId — 用户ID
}

请求体 (字段映射后):

{
  "fragment": 10,    // 固定传参
  "bond": "",    // headPos (string) 头像位置
  "promotion": "",    // videoUrl (string) 视频URL
  "arena": 2,    // 固定传参
  "agent": "",    // headImg (string) 头像图片
  "congregation": "",    // templateName (string) 模板名称
  "applicant": 1,    // 固定传参
  "accolade": 0,    // 固定传参
  "histogram": 3    // 固定传参
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

18. 创建图转视频姿态任务

POST /v1/image/img2video_pose_task | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "congregation": "",    // templateName — 模板名称
  "notification": "25",    // fps — 帧率
  "allowance": "false",    // needopt — 是否优化，通过配置控制
  "cosmos": "12",    // duration — 时长
  "profit": "",    // srcImgBase64 — 源图片Base64数据
  "compendium": ""    // srcVideo — 源视频
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

19. 获取图转视频姿态模板

GET /v1/image/img2Video_pose_template | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "crest": "",    // ch — 渠道号
  "asset": "",    // userId — 用户ID
  "insignia": "1"    // categoryId — 分类ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 图转视频姿态模板列表
    {
      "cosmos": 0,    // duration (int) 时长
      "extend": "",    // templateTfUrl (string) 模板TF URL
      "pipe": 0,    // templateTfCredits (int) 模板TF积分
      "acknowledge": "",    // templateFifUrl (string) 模板FIF URL
      "congregation": "",    // templateName (string) 模板名称
      "greaves": {},    // credits (object) 积分配置
      "unwrap": 0,    // templateTfDuration (int) 模板TF时长
      "decommission": 0,    // templateFifDuration (int) 模板FIF时长
      "ascend": "",    // animate (string) 动画
      "pause": 0,    // templateFifCredits (int) 模板FIF积分
      "inject": ""    // templateUrl (string) 模板URL
    }
  ]
}

20. 创建换脸任务

POST /v1/image/faceswap_task | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": ""    // app — 应用标识（必填）
}

请求体 (字段映射后):

{
  "revenue": "",    // img (string) 图片
  "bond": "",    // headPos (string) 头像位置
  "arena": 0,    // 固定传参
  "agent": "",    // headImg (string) 头像图片
  "booking": "",    // resolution (string) 分辨率
  "histogram": 2,    // 固定传参
  "stadium": 1    // 固定传参
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

21. App事件打点上报

POST /v1/log/appevent | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "fortress": "",    // event — 事件名称（必填）
  "asset": "",    // userId — 用户ID
  "crest": ""    // ch — 渠道
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "traverse": "",    // hint (string)
    "accolade": ""    // type (string)
  }
}

22. 创建黏土风格任务

POST /v1/image/clay_stylization | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "allowance": "false",    // needopt — 是否优化，通过配置控制
  "crest": ""    // ch — 渠道号
}

请求体 (字段映射后):

{
  "profit": "",    // srcImgBase64 (string) 源图片Base64数据
  "statute": ""    // srcImgUrl (string) 源图片URL
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

23. 创建自定义换衣任务

POST /v1/image/custom_clothes_swap | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "asset": "",    // userId — 用户ID
  "ranger": "3"    // appType — 应用类型
}

请求体 (字段映射后):

{
  "balance": "",    // srcImg2 (string) 源图片2的文件路径
  "endeavor": ""    // srcImg1 (string) 源图片1的文件路径
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

24. 获取文生图标签

GET /v1/image/txt2img_tags | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "portal": "",    // pkg — 应用包名（必填）
  "asset": ""    // userId — 用户ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 标签列表
    {
      "parallelize": "",    // theme (string) 主题
      "rally": []    // tags (array) 标签
    }
  ]
}

25. 获取文生图提示词模板

POST /v1/image/txt2img_prompts | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "sidekick": []    // data (array) 标签数据列表
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "ledger": "",    // prompt (string) 文本提示词
    "rally": ""    // tags (string) 标签
  }
}

26. 获取分类列表

GET /v1/image/category-list | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "portal": "",    // pkg — 应用包名（必填）
  "endowment": ""    // templateTypes — 模板类型列表
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 分类列表
    {
      "recharge": "",    // templateType (string) 模板类型
      "patrol": "",    // categoryName (string) 分类名称
      "insignia": 0    // categoryId (int) 分类ID
    }
  ]
}

27. 获取App语言配置

GET /v1/config/app-language | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "portal": "",    // pkg — 应用包名（必填）
  "seminar": ""    // lang — 语言代码
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "charge": ""    // config (string) 语言配置JSON
  }
}

28. 图片动作风格化gif

POST /v1/image/offtop_video | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": "",    // userId — 用户ID
  "allowance": "false"    // needopt — 是否优化，通过配置控制
}

请求体 (字段映射后):

{
  "summary": "480p",    // 固定传参
  "refuge": ""    // srcImg (string) 源图片
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

29. 获取我的任务列表

GET /v1/image/my-tasks | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "trophy": "",    // page — 页码
  "heatmap": "",    // size — 每页数量
  "platoon": "1,3,4"    // taskTypes — 任务类型列表
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "weigh": 0,    // total (int) 总数
    "empower": 0,    // current (int) 当前页
    "heatmap": 0,    // size (int) 每页大小
    "intensify": [    // records (array) 记录列表
      {
        "cipher": 0,    // taskType (int) 任务类型
        "discover": 0,    // createTime (long) 创建时间
        "listing": "",    // state (string) 任务状态
        "tree": 0,    // taskId (long) 任务ID
        "downsample": []    // imgList (array) 图片列表
      }
    ],
    "manifest": false    // hasNext (boolean) 是否有下一页
  }
}

30. 创建增强换脸任务

POST /v1/image/faceswap_ex_task | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "sentinel": "",    // app — 应用标识（必填）
  "asset": ""    // userId — 用户ID
}

请求体 (字段映射后):

{
  "balance": "",    // srcImg2 (string) 源图片2的文件路径
  "endeavor": ""    // srcImg1 (string) 源图片1的文件路径
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

31. 创建生图任务

POST /v1/image/create-task | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "asset": ""    // userId — 用户ID
}

请求体 (字段映射后):

{
  "nexus": "",    // ext (string) 扩展参数
  "cipher": "",    // taskType (string) 任务类型
  "heatmap": "",    // size (string) 输出尺寸，如 480p
  "congregation": "",    // templateName (string) 模板名称
  "balance": "",    // srcImg2 (string) 源图片2的文件路径
  "guild": "",    // srcImg1Url (string) 源图片1的URL
  "allowance": false,    // 固定传参
  "endeavor": "",    // srcImg1 (string) 源图片1的文件路径
  "commission": "",    // srcImg2Url (string) 源图片2的URL
  "ledger": ""    // prompt (string) 文本提示词
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "listing": 0,    // state (int) 任务状态
    "tree": 0    // taskId (int) 任务ID
  }
}

32. 获取积分页面信息

GET /v1/user/credits-page | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "trophy": "1",    // page — 页码
  "heatmap": "10",    // size — 每页条数
  "accolade": "1"    // type — 积分类型
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "weigh": 0,    // total (int) 总条数
    "empower": 0,    // current (int) 当前页
    "coordinate": 0,    // pages (int) 总页数
    "heatmap": 0,    // size (int) 每页大小
    "intensify": [    // records (array) 积分记录列表
      {
        "tailor": "",    // subBusinessType (string) 子业务类型
        "greaves": 0,    // credits (int) 积分数
        "discover": 0,    // createTime (long) 创建时间
        "vanquish": "",    // businessId (string) 业务ID
        "accolade": 0,    // type (int) 类型，1=增加，2=扣除
        "defend": ""    // businessType (string) 业务类型
      }
    ]
  }
}

33. 删除任务

POST /v1/image/delete-task | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "tree": 0    // taskId (int) 任务ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "traverse": "",    // hint (string)
    "accolade": ""    // type (string)
  }
}

34. 获取支付方式列表

POST /v1/payment/get-payment-methods | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "warrior": 0,    // activityId (int) 活动模板ID
  "vambrace": ""    // country (string) 国家代码
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "renew": [    // paymentMethods (array) 支付方式列表
      {
        "ceremony": "",    // subPaymentMethod (string) 子支付方式
        "conjure": 0,    // bonusCredits (int) 赠送积分
        "brigade": "",    // name (string) 名称
        "greylist": "",    // icon (string) 图标
        "finalize": false,    // recentlyUsed (boolean) 是否最近使用
        "resource": "",    // paymentMethod (string) 支付方式
        "deny": false,    // recommend (boolean) 是否推荐
        "enchant": 0.0,    // bonusRatio (double) 赠送比例
        "deploy": false    // selected (boolean) 是否默认选中
      }
    ]
  }
}

35. 获取订单详情

GET /v1/payment/getOrderDetail | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "asset": "",    // userId — 用户ID
  "federation": ""    // id — 支付ID/订单ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "warrior": "",    // activityId (string) 活动模板ID
    "disambiguate": "",    // redirectUrl (string) 重定向URL
    "awaken": false,    // addCredits (boolean) 是否添加积分
    "visor": "",    // count (string) 数量
    "familiar": "",    // currency (string) 货币
    "federation": "",    // id (string) 支付ID/订单ID
    "line": {}    // status (object) 状态
  }
}

36. 获取反馈上传URL

POST /v1/feedback/upload-presigned-url | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "layer": ""    // fileName (string) 文件名
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "shed": "",    // uploadUrl (string) 上传URL
    "hunt": ""    // filePath (string) 文件路径
  }
}

37. 提交反馈

POST /v1/feedback/submit | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "inventory": [],    // fileUrls (array) 文件URL列表
  "pauldron": "",    // contentType (string) 内容类型
  "cloak": ""    // content (string) 内容
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "traverse": "",    // hint (string)
    "accolade": ""    // type (string)
  }
}

38. 获取反馈列表

GET /v1/feedback/list | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "trophy": "1",    // page — 页码
  "heatmap": "10"    // size — 每页条数
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "weigh": 0,    // total (int) 总条数
    "empower": 0,    // current (int) 当前页
    "heatmap": 0,    // size (int) 每页大小
    "intensify": [    // records (array) 反馈记录列表
      {
        "redact": false,    // read (boolean) 是否已读
        "track": 0,    // feedbackId (long) 反馈ID
        "inventory": [],    // fileUrls (array) 附件URL列表
        "voxelize": 0,    // replyStatus (int) 回复状态
        "uncover": "",    // createTimeText (string) 创建时间
        "cloak": ""    // content (string) 反馈内容
      }
    ],
    "manifest": false    // hasNext (boolean) 是否有下一页
  }
}

39. 标记反馈已读

POST /v1/feedback/read | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "registry": []    // feedbackIds (array) 反馈ID列表
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "traverse": "",    // hint (string)
    "accolade": ""    // type (string)
  }
}

40. 获取未读消息数

GET /v1/user/unread-message-count | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "municipality": ""    // types — 消息类型列表
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "footprint": [    // unreadCountList (array) 各类型未读数列表
      {
        "visor": 0,    // count (int) 未读数
        "accolade": ""    // type (string) 消息类型
      }
    ],
    "defragment": 0,    // totalUnreadCount (int) 总未读消息数
    "probe": 0    // lastUpdateTime (int) 最后更新时间戳
  }
}

41. 获取图转视频分类

GET /v1/image/img2video/categories | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 分类列表
    {
      "brigade": "",    // name (string) 分类名称
      "greylist": "",    // icon (string) 图标
      "federation": 0    // id (int) 分类ID
    }
  ]
}

42. 获取图转视频任务列表

GET /v1/image/img2video/tasks | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

查询参数 (字段映射后):

{
  "insignia": ""    // categoryId — 分类ID
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": [    // data (array) 任务列表
    {
      "preempt": {},    // previewVideo (object) 预览视频
      "preprocess": {},    // resolution720p (object) 720p分辨率
      "simplify": 0,    // imageCount (int) 图片数量
      "nexus": "",    // ext (string) 扩展参数
      "cipher": "",    // taskType (string) 任务类型
      "reverify": {},    // resolution480p (object) 480p分辨率
      "congregation": "",    // templateName (string) 模板名称
      "allowance": false,    // needopt (boolean) 是否优化，通过配置控制
      "subscribe": {},    // label (object) 标签
      "glossary": "",    // title (string) 标题
      "extract": {}    // previewImage (object) 预览图
    }
  ]
}

43. 获取预签名上传URL

POST /v1/image/upload-presigned-url | 鉴权: 需要

请求头 (字段映射后):

  portal              应用包名（必填）  (原始: pkg)
  knight              用户登录token  (原始: User_token)

请求体 (字段映射后):

{
  "gateway": "",    // fileName1 (string) 文件名1
  "action": "",    // fileName2 (string) 文件名2
  "pauldron": "",    // contentType (string) 文件MIME类型
  "stronghold": 0    // expectedSize (int) 预期文件大小
}

响应 (解密后, 字段映射后):

{
  "rampart": "",    // msg (string) 消息
  "helm": 0,    // code (int) 状态码，0=成功
  "sidekick": {    // data
    "bolster": "",    // uploadUrl1 (string) 上传URL 1
    "soar": 0,    // expiresIn (int) 过期时间(秒)
    "remap": {},    // requiredHeaders (object) 上传所需请求头
    "expound": "",    // uploadUrl2 (string) 上传URL 2
    "train": "",    // filePath2 (string) 文件路径 2
    "recruit": ""    // filePath1 (string) 文件路径 1
  }
}

错误码

code	说明
0	成功
-1	失败
-2	系统错误
-3	鉴权失败
-5	参数错误
1001	积分不足
1002	免费次数已用完
1003	免费次数和积分均已用完

字段映射全表

原始字段	V2字段
User_token	knight
accountId	wizard
accountName	captain
activityId	warrior
actualAmount	guardian
adsTokenId	champion
amount	hero
app	sentinel
appType	ranger
approveState	paladin
aspectRatio	quest
automaticRenewal	legend
baseUrl	destiny
begTime	emblem
campaignInfo	relic
card	artifact
ch	crest
channel	lineage
channelType	armor
client	shield
clientId	gauntlet
code	helm
coder	mantle
contentType	pauldron
count	visor
country	vambrace
currency	familiar
cvcCode	companion
data	sidekick
days	species
devId	ancestry
deviceId	origin
domain	totem
dt	sigil
endTime	citadel
event	fortress
expectedSize	stronghold
expireMonth	dominion
expireYear	sanctuary
ext	nexus
extJson	vanguard
feedbackIds	registry
fileName	layer
fileName1	gateway
fileName2	action
filterCountry	blueprint
filterDomain	vendor
filterOwnerId	participant
filterStatus	specimen
filterTaskType	package
filterVip	quotation
firstName	appointment
fps	notification
googleClientId	discourse
hash	mediation
hashIsZero	corpus
headFaceIndex	histogram
headImg	agent
headPos	bond
headType	arena
host	initiative
imageFaceIndex	committee
imageId	royalty
img	revenue
imgCount	declaration
imgId	criterion
inviteBy	item
keepUserId	series
lang	seminar
lastName	bazaar
link	festival
list	junction
method	heap
model	authorization
msg	rampart
needImage	assembly
needUndress	directive
needopt	allowance
negativePrompt	underwriter
orderId	gazette
originAmount	curriculum
owner	genealogy
p12KeyPath	arraignment
packageName	folio
page	trophy
password	township
payMethods	wallet
paymentMethod	resource
phone	block
pkg	portal
platform	trigger
prompt	ledger
publicKey	template
purchaseData	merchant
receipt	attendee
referer	digest
refererType	campaign
resolution	booking
serviceAccountEmail	alert
sharedSecret	comment
sign	resolution
signature	sample
size	heatmap
srcFaceImgBase64	attachment
srcFaceIndex	stadium
srcImg	refuge
srcImg1	endeavor
srcImg1Url	guild
srcImg2	balance
srcImg2Url	commission
srcImgBase64	profit
srcImgUrl	statute
srcVideo	compendium
status	line
style	webinar
subPaymentMethod	ceremony
targetId	node
taskIds	privilege
taskType	cipher
taskTypes	platoon
templateName	congregation
templateTypes	endowment
tgId	concession
tgOrderId	insurer
token	thesis
transactionId	chronicle
truePrompt	deposition
ts	quarto
type	accolade
types	municipality
userApplePayList	gallery
userId	asset
userInfoType	frame
username	pulse
val	journal
value	schema
verifyCode	supplier
videoFaceIndex	applicant
videoFrameIndex	fragment
videoSize	summary
activitys	summon
addCredits	awaken
appFbConfig	evolve
appraise	unleash
config	charge
countId	command
countryCode	navigate
credit	reveal
creditPromotion	unlock
creditsRecordUrl	conquer
cryptoInvoiceUrl	protect
current	empower
department	inspire
description	pedigree
domains	avatar
duration	cosmos
email	galaxy
enabled	nebula
expiresIn	soar
extConfig	surge
faceInfos	strike
feature	dodge
features	scout
filePath	hunt
filePath1	recruit
filePath2	train
firstRegister	equip
forcePayCenter	upgrade
freeBlurTimes	vow
freeTimes	decree
h5UrlConfig	pursue
hasNext	manifest
hint	traverse
imgUrl	reconfigure
invitedCnt	deduce
isBlur	reify
isVip	generate
issuerUrl	merge
lastUpdateTime	probe
maxLimit	architect
methodActivitys	modify
methodChannels	restore
needCredits	deserialize
openType	transplant
optimizeCountSql	harvest
optimizeJoinOfCountSql	seek
orders	identify
pages	coordinate
payCenterUrl	switch
payStatus	destroy
payTypeList	handshake
payUrl	convert
paymentMethods	renew
permissions	sandbox
recent	entrap
records	intensify
redirectUrl	disambiguate
requiredHeaders	remap
role	evaluate
searchCount	suspend
subScribeValidTime	tokenize
subscriptionActivitys	cleanse
sumCredits	emit
sys	associate
t2IConfig	regulate
tags	rally
targetInvitedCnt	authorize
tgName	defer
total	weigh
totalUnreadCount	defragment
unreadCountList	footprint
uploadUrl	shed
uploadUrl1	bolster
uploadUrl2	expound
userName	terminal
userToken	reevaluate
userType	prefetch
usign	retrospect
videoUrl	promotion
age	transform
animate	ascend
avatar	realm
baseCredits	wield
bonus	forge
bonusCredits	conjure
bonusRatio	enchant
businessId	vanquish
businessType	defend
categoryId	insignia
categoryName	patrol
content	cloak
creatTime	explore
createTime	discover
createTimeText	uncover
credits	greaves
discountOff	lead
face	dash
faceIndex	leap
face_index	parry
feedbackId	track
fileUrls	inventory
frameIndex	unite
frame_index	pledge
gender	venture
icon	greylist
id	federation
imageCount	simplify
imageInfos	curate
imgList	downsample
imgType	reconnect
index	prewarm
label	subscribe
name	brigade
note	extrapolate
payId	assert
payMethod	intercept
payTime	restart
paylink	unzip
previewImage	extract
previewVideo	preempt
productType	subtract
progress	dice
queueCnt	revert
read	redact
recentlyUsed	finalize
recommend	deny
replyStatus	voxelize
resolution480p	reverify
resolution720p	preprocess
resulotion	theorize
rewardCredits	represent
rewardRatio	render
selected	deploy
showName	mold
sort	invent
state	listing
subBusinessType	tailor
subscriptionPeriod	distribute
tag	constrain
taskId	tree
templateFaceUrl	simulate
templateFifCredits	pause
templateFifDuration	decommission
templateFifUrl	acknowledge
templateTfCredits	pipe
templateTfDuration	unwrap
templateTfUrl	extend
templateType	recharge
templateUrl	inject
theme	parallelize
title	glossary
updateTime	fork
url	digitize
user	rebalance
videoDuration	demonstrate
waitTime	flowStep
x1	invoke
x2	sync
y1	configure
y2	manufacture

本文档由 ProtocolEncTool 自动生成，API 变更后请重新执行生成命令。

58 KiB Raw Blame History Unescape Escape

petsHeroAI V2 客户端接入指引

通用信息

加密流程

代理请求结构

V2 包装结构

登录态接口

1. 获取推荐提示词

2. 设备登录（快速登录）

3. 注销账户

4. 获取换衣模板

5. 获取用户通用信息

6. 归因上报

7. 获取用户账户信息

8. 获取Google商品列表

9. 获取Apple商品列表

10. 创建支付订单

11. Google支付结果回调

12. Apple支付结果回调

13. 获取支付订单列表

14. 创建文生图任务

15. 创建换衣任务

16. 查询图片生成进度

17. 创建视频换脸任务

18. 创建图转视频姿态任务

19. 获取图转视频姿态模板

20. 创建换脸任务

21. App事件打点上报

22. 创建黏土风格任务

23. 创建自定义换衣任务

24. 获取文生图标签

25. 获取文生图提示词模板

26. 获取分类列表

27. 获取App语言配置

28. 图片动作风格化gif

29. 获取我的任务列表

30. 创建增强换脸任务

31. 创建生图任务

32. 获取积分页面信息

33. 删除任务

34. 获取支付方式列表

35. 获取订单详情

36. 获取反馈上传URL

37. 提交反馈

38. 获取反馈列表

39. 标记反馈已读

40. 获取未读消息数

41. 获取图转视频分类

42. 获取图转视频任务列表

43. 获取预签名上传URL

错误码

字段映射全表

58 KiB

Raw Blame History