🍌 Nano Banana

积分获取方式

• 新用户注册奖励：100积分（自动发放）
• 微信支付充值：1元人民币 = 10积分

API调用消费

积分特性

• ✅ API调用成功后才扣除积分
• ✅ API调用失败不会扣除积分
• ✅ 积分不足时会拒绝API调用（返回402状态码）
• ✅ 完整的交易记录和使用统计

1. 微信小程序登录

// 小程序端代码
wx.login({
  success: (res) => {
    if (res.code) {
      wx.request({
        url: 'https://your-domain.com/api/wechat/login',
        method: 'POST',
        data: { code: res.code },
        success: (loginRes) => {
          // 保存用户token
          wx.setStorageSync('userToken', loginRes.data.token);
          wx.setStorageSync('userInfo', loginRes.data.user);
          console.log('积分余额:', loginRes.data.user.points);
        }
      });
    }
  }
});

2. 使用AI服务

// 调用AI API时需要携带token
wx.uploadFile({
  url: 'https://your-domain.com/api/image/outfit-change',
  filePath: imagePath,
  name: 'image',
  header: {
    'Authorization': 'Bearer ' + wx.getStorageSync('userToken')
  },
  formData: { style: '商务正装' },
  success: (res) => {
    const data = JSON.parse(res.data);
    console.log('剩余积分:', data.points.remaining);
    console.log('处理结果:', data.data.imageUrl);
  }
});

创建支付订单

// 创建充值订单
wx.request({
  url: 'https://your-domain.com/api/wechat/payment/create',
  method: 'POST',
  header: {
    'Authorization': 'Bearer ' + wx.getStorageSync('userToken')
  },
  data: {
    amount: 10.0,  // 充值10元
    description: '购买100积分'
  },
  success: (res) => {
    if (res.data.success) {
      // 调起微信支付
      wx.requestPayment({
        ...res.data.paymentParams,
        success: () => {
          console.log('充值成功');
          // 刷新用户积分
          refreshUserInfo();
        }
      });
    }
  }
});

查询用户信息

// 获取用户信息和积分余额
wx.request({
  url: 'https://your-domain.com/api/wechat/user/info',
  method: 'GET',
  header: {
    'Authorization': 'Bearer ' + wx.getStorageSync('userToken')
  },
  success: (res) => {
    console.log('用户信息:', res.data.data);
    console.log('积分余额:', res.data.data.points);
  }
});

GET /api/wechat/user/info

GET /api/wechat/user/info

功能：获取用户完整信息和当前积分余额

认证：需要Bearer Token

请求示例：

GET /api/wechat/user/info
Authorization: Bearer your_token_here

成功响应：

{
  "success": true,
  "data": {
    "id": "user_1234567890_abc123def",
    "openid": "wx_openid_example_123456",
    "nickname": "微信用户昵称",
    "avatar": "https://wx.qlogo.cn/mmopen/avatar.jpg",
    "points": 150,
    "created_at": "2024-01-15T08:30:00.000Z"
  }
}

使用场景：

• 用户进入小程序时获取基本信息
• 定期刷新积分余额显示
• 验证用户登录状态

GET /api/wechat/points/config

GET /api/wechat/points/config

功能：获取积分系统配置信息

认证：不需要

请求示例：

GET /api/wechat/points/config

成功响应：

{
  "success": true,
  "data": {
    "apiCosts": {
      "restore_photo": 10,    // 老照片修复积分消耗
      "outfit_change": 20,    // 换装功能积分消耗
      "custom": 15,           // 自定义处理积分消耗
      "animate": 30           // 照片动画积分消耗
    },
    "exchangeRate": 10,       // 充值比例：1元 = 10积分
    "newUserBonus": 100       // 新用户注册赠送积分
  }
}

使用场景：

• 显示各功能的积分价格
• 计算充值所需金额
• 用户使用前的积分预算提示

GET /api/wechat/user/transactions

GET /api/wechat/user/transactions

功能：获取用户积分交易记录

认证：需要Bearer Token

请求参数：

• limit (可选): 返回记录数量，默认50

请求示例：

GET /api/wechat/user/transactions?limit=20
Authorization: Bearer your_token_here

成功响应：

{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "trans_123456789",
        "type": "earn",              // earn=获得积分, spend=消费积分
        "amount": 100,
        "description": "微信支付充值",
        "wechat_order_id": "wx_order_123",
        "created_at": "2024-01-15T10:30:00.000Z"
      },
      {
        "id": "trans_987654321",
        "type": "spend",
        "amount": 20,
        "description": "换装功能 API调用",
        "api_call_id": "api_call_456",
        "created_at": "2024-01-15T09:15:00.000Z"
      }
    ],
    "total": 25
  }
}

GET /api/wechat/user/api-usage

GET /api/wechat/user/api-usage

功能：获取用户API使用记录

认证：需要Bearer Token

请求参数：

• limit (可选): 返回记录数量，默认50

请求示例：

GET /api/wechat/user/api-usage?limit=10
Authorization: Bearer your_token_here

成功响应：

{
  "success": true,
  "data": {
    "usage": [
      {
        "id": "usage_123456789",
        "api_type": "outfit_change",
        "points_cost": 20,
        "request_id": "req_789012345",
        "success": true,
        "created_at": "2024-01-15T09:15:00.000Z"
      },
      {
        "id": "usage_987654321",
        "api_type": "restore_photo",
        "points_cost": 10,
        "request_id": "req_456789012",
        "success": true,
        "created_at": "2024-01-15T08:45:00.000Z"
      }
    ],
    "total": 15
  }
}

💡 积分返回说明

所有图像处理API都会返回积分信息：

标准积分返回格式：

{
  "success": true,
  "message": "处理完成",
  "data": {
    // ... 处理结果数据
  },
  "points": {
    "deducted": 20,        // 本次扣除的积分
    "remaining": 130       // 扣除后的剩余积分
  }
}

适用的API接口：

• POST /api/image/restore (扣除10积分)
• POST /api/image/outfit (扣除20积分)
• POST /api/image/custom (扣除15积分)
• POST /api/image/animate (扣除30积分)

积分不足错误：

{
  "error": "积分不足",
  "code": "INSUFFICIENT_POINTS",
  "message": "当前积分：5，需要积分：20"
}

其他数据接口一览

通用错误处理

• 400 Bad Request：请求参数错误
• 401 Unauthorized：未登录或token过期
• 402 Payment Required：积分不足
• 500 Internal Server Error：服务器内部错误

微信小程序配置

• AppID：wx765b20f090a4a0f9（已配置）
• 服务器域名：需要在小程序后台配置request合法域名
• 支付功能：需要开通微信支付商户号

开发调试

• 开发工具中启用"不校验合法域名"选项
• 使用真机调试测试支付功能
• 生产环境必须使用HTTPS

完整的小程序集成代码

// app.js - 全局登录处理
App({
  globalData: {
    userInfo: null,
    token: null,
    apiBase: 'https://your-domain.com/api'
  },

  onLaunch() {
    this.login();
  },

  // 用户登录
  async login() {
    return new Promise((resolve, reject) => {
      wx.login({
        success: (res) => {
          if (res.code) {
            wx.request({
              url: this.globalData.apiBase + '/wechat/login',
              method: 'POST',
              data: { code: res.code },
              success: (loginRes) => {
                if (loginRes.data.success) {
                  this.globalData.token = loginRes.data.token;
                  this.globalData.userInfo = loginRes.data.user;
                  wx.setStorageSync('token', loginRes.data.token);
                  wx.setStorageSync('userInfo', loginRes.data.user);
                  resolve(loginRes.data);
                } else {
                  reject(loginRes.data);
                }
              },
              fail: reject
            });
          } else {
            reject(res);
          }
        },
        fail: reject
      });
    });
  },

  // 检查积分余额
  async checkPoints(required) {
    const userInfo = wx.getStorageSync('userInfo') || this.globalData.userInfo;
    if (!userInfo || userInfo.points < required) {
      wx.showModal({
        title: '积分不足',
        content: `操作需要${required}积分，您当前有${userInfo?.points || 0}积分。是否前往充值？`,
        success: (res) => {
          if (res.confirm) {
            // 跳转到充值页面
            wx.navigateTo({ url: '/pages/recharge/recharge' });
          }
        }
      });
      return false;
    }
    return true;
  },

  // 使用AI服务
  async useAI(apiPath, filePath, params = {}) {
    const token = wx.getStorageSync('token') || this.globalData.token;
    if (!token) {
      await this.login();
    }

    return new Promise((resolve, reject) => {
      wx.uploadFile({
        url: this.globalData.apiBase + apiPath,
        filePath: filePath,
        name: 'image',
        header: {
          'Authorization': `Bearer ${token}`
        },
        formData: params,
        success: (res) => {
          try {
            const data = JSON.parse(res.data);
            if (data.success) {
              // 更新用户积分信息
              if (data.points) {
                const userInfo = wx.getStorageSync('userInfo');
                userInfo.points = data.points.remaining;
                wx.setStorageSync('userInfo', userInfo);
                this.globalData.userInfo = userInfo;
              }
              resolve(data);
            } else {
              reject(data);
            }
          } catch (e) {
            reject({ message: '解析响应失败', error: e });
          }
        },
        fail: reject
      });
    });
  }
});

接口地址

功能说明

使用AI技术修复老旧、破损的照片，提升清晰度，修复划痕和污渍，调整亮度和对比度，保持原有历史风格。

请求头

Authorization: Bearer {用户token}
Content-Type: multipart/form-data

请求参数

积分消费

💰 消费：10积分 | 仅在处理成功后扣除

文件要求

• 支持格式：JPG、JPEG、PNG、GIF、WebP、BMP
• 文件大小：最大10MB
• 建议分辨率：不超过2048x2048像素以获得最佳处理效果

响应格式

{
  "success": true,
  "message": "老照片修复完成",
  "requestId": "req_1704123456",
  "processingTime": "3245ms",
  "data": {
    "originalImage": "upload_123.jpg",
    "restoredImage": "restored_123.jpg",
    "imageUrl": "/uploads/restored_123.jpg"
  },
  "points": {
    "deducted": 10,
    "remaining": 170
  }
}

接口地址

功能说明

为人物图片更换服装风格，保持人物面部和体型特征不变，支持风格描述和参考图片两种方式。

请求头

Authorization: Bearer {用户token}
Content-Type: multipart/form-data

请求参数

积分消费

💰 消费：20积分 | 仅在处理成功后扣除

风格选项

• 预设风格：商务、休闲、运动、正装、时尚、复古、街头、优雅、韩式、日式等
• 自定义描述：如"黑色西装配红色领带"、"夏季连衣裙"等
• 参考图片：上传包含目标服装风格的图片

响应格式

{
  "success": true,
  "message": "换装完成",
  "requestId": "req_1704123457",
  "processingTime": "5678ms",
  "data": {
    "originalImage": "upload_124.jpg",
    "changedImage": "outfit_124.jpg",
    "imageUrl": "/uploads/outfit_124.jpg",
    "style": "商务正装",
    "useReference": false,
    "referenceImage": null
  },
  "points": {
    "deducted": 20,
    "remaining": 150
  }
}

接口地址

功能说明

根据用户自定义指令对图片进行AI处理，支持背景更换、滤镜效果、风格转换等多种操作。

请求头

Authorization: Bearer {用户token}
Content-Type: multipart/form-data

请求参数

积分消费

💰 消费：15积分 | 仅在处理成功后扣除

指令示例

• "把背景改成海滩日落风景"
• "将图片转换为油画风格"
• "增强图片亮度和对比度"
• "添加复古滤镜效果"
• "移除背景，保留主体"

响应格式

{
  "success": true,
  "message": "自定义图片处理完成",
  "requestId": "req_1704123458",
  "processingTime": "4567ms",
  "data": {
    "originalImage": "upload_125.jpg",
    "processedImage": "custom_125.jpg",
    "imageUrl": "/uploads/custom_125.jpg",
    "prompt": "把背景改成海滩日落风景"
  },
  "points": {
    "deducted": 15,
    "remaining": 135
  }
}

接口地址

功能说明

使用Veo 3将静态照片转换为动态视频，支持人像动画、场景动画和自定义动画效果。

请求头

Authorization: Bearer {用户token}
Content-Type: multipart/form-data

请求参数

积分消费

💰 消费：30积分 | 仅在处理成功后扣除

动画类型说明

• general：通用动画效果，适合各种图片
• portrait：人像动画，专门优化面部表情和动作
• scene：场景动画，增强环境氛围和景物动态
• custom：自定义动画，根据motionPrompt生成特定效果

响应格式

{
  "success": true,
  "message": "照片动画生成完成",
  "requestId": "req_1704123459",
  "processingTime": "15678ms",
  "data": {
    "originalImage": "upload_126.jpg",
    "animatedVideo": "animated_126_photo.mp4",
    "videoUrl": "/uploads/animated_126_photo.mp4",
    "animationType": "portrait",
    "duration": "3s",
    "resolution": "1024x576",
    "mimeType": "video/mp4"
  },
  "points": {
    "deducted": 30,
    "remaining": 105
  }
}

上传方式

• Content-Type：multipart/form-data
• 编码方式：表单数据编码
• 字段名：image（主图片）、reference（参考图片）

下载方式

• 访问地址：https://banana.8miao.cn/uploads/{filename}
• 文件命名：{功能}_{时间戳}_{原文件名}.png
• 浏览器访问：直接在浏览器中打开图片URL
• 程序下载：通过HTTP GET请求获取图片数据

错误响应

{
  "success": false,
  "message": "具体错误信息",
  "error": "错误代码或详细描述"
}