# 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 到代理入口，请求体结构如下：

```json
{
  "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 包装结构

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

```json
{
  "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) 状态
}
```

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

请求体 (字段映射后):

```json
{
  "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) 文本提示词
}
```

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

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

```json
{
  "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)
```

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

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

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

```json
{
  "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)
```

请求体 (字段映射后):

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

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

```json
{
  "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 变更后请重新执行生成命令。*