去水印解析 API

1微信小程序后台配置域名

登录微信公众平台小程序后台，进入 开发管理 / 开发设置 / 服务器域名，添加下面域名。 生产环境必须使用已备案、证书有效的 HTTPS 域名；开发者工具里的“不校验合法域名”只适合本地调试。

注意：小程序后台填写的是域名，不要带接口路径；例如填 https://ck.og1.top，不要填 https://ck.og1.top/open-api/parse。

常见源站 CDN 域名（填到 downloadFile合法域名）

微信后台只填域名，不填路径和参数。下面是本接口常见返回域名；平台 CDN 会按地区和时间变化，最终以接口实际返回的 video_url、images、resources[].url 的 host 为准。

2小程序请求解析接口

推荐用 POST 调用，返回 code = 200 表示成功。

const API_BASE = 'https://ck.og1.top'
const API_KEY = 'YOUR_APP_ID'

function parseVideo(shareUrl) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: API_BASE + '/open-api/parse',
      method: 'POST',
      header: {
        'content-type': 'application/json'
      },
      data: {
        key: API_KEY,
        url: shareUrl
      },
      success(res) {
        const body = res.data || {}
        if (body.code === 200) {
          resolve(body.data)
          return
        }
        reject(new Error(body.msg || body.message || '解析失败'))
      },
      fail(err) {
        reject(err)
      }
    })
  })
}

3展示视频、图集和文案

parseVideo(inputUrl).then(data => {
  // 视频直链
  const videoUrl = data.video_url || ''

  // 图文/图集
  const imageUrls = data.image_urls || data.images || []

  // 复制文案
  const copyText = data.copy_text || data.caption || data.title || ''

  this.setData({
    result: data,
    videoUrl,
    imageUrls,
    copyText
  })
})

4下载资源

保存视频或图片时，推荐先下载解析结果里的原始直连地址；如果直连域名未配置、返回 403 或下载失败，再自动切换到本站代理地址。 这样源站 CDN 能直连时速度最快，不能直连时也不会直接失败。

function toProxyUrl(rawUrl) {
  if (!rawUrl) return ''
  if (rawUrl.indexOf(API_BASE + '/api/resource/preview') === 0) return rawUrl
  return API_BASE + '/api/resource/preview?url=' + encodeURIComponent(rawUrl)
}

function uniqueUrls(urls) {
  const result = []
  urls.forEach(url => {
    url = url ? String(url).trim() : ''
    if (url && result.indexOf(url) === -1) result.push(url)
  })
  return result
}

function isBilibiliProtectedUrl(url) {
  return /\/\/[^/]*(?:bilivideo\.com|hdslb\.com|bilibili\.com)(?:[/:?#]|$)/i.test(url || '')
}

function saveByDirectFirst(rawUrl, type = 'video') {
  const proxyUrl = toProxyUrl(rawUrl)
  const urls = type === 'video' && isBilibiliProtectedUrl(rawUrl)
    ? uniqueUrls([proxyUrl, rawUrl])
    : uniqueUrls([rawUrl, proxyUrl])
  const saveApi = type === 'image' ? wx.saveImageToPhotosAlbum : wx.saveVideoToPhotosAlbum

  function tryDownload(index) {
    const downloadUrl = urls[index]
    if (!downloadUrl) {
      wx.hideLoading()
      wx.showToast({ title: '没有可下载资源', icon: 'none' })
      return
    }

    wx.downloadFile({
      url: downloadUrl,
      success(res) {
        if (res.statusCode === 200 && res.tempFilePath) {
          saveApi({
            filePath: res.tempFilePath,
            success() {
              wx.hideLoading()
              wx.showToast({ title: '已保存' })
            },
            fail() {
              wx.hideLoading()
              wx.showToast({ title: '请先授权相册权限', icon: 'none' })
            }
          })
          return
        }

        if (index + 1 < urls.length) {
          tryDownload(index + 1)
          return
        }

        wx.hideLoading()
        wx.showToast({ title: '下载失败', icon: 'none' })
      },
      fail() {
        if (index + 1 < urls.length) {
          tryDownload(index + 1)
          return
        }

        wx.hideLoading()
        wx.showToast({ title: '下载域名未配置或网络异常', icon: 'none' })
      }
    })
  }

  wx.showLoading({ title: '下载中' })
  tryDownload(0)
}

5现有小程序怎么改源码

如果你的小程序源码现在只下载 video_url 或 image_urls，建议改成“直连优先、本站代理兜底”。 不懂代码也可以按下面步骤操作。

常见旧代码一般类似这样，只拿短视频平台直链下载：

// 旧写法：只有直连，没有代理兜底
// 直连域名没填到 downloadFile合法域名，或源站临时防盗链，就会保存失败
wx.downloadFile({
  url: result.video_url,
  success(res) {
    wx.saveVideoToPhotosAlbum({
      filePath: res.tempFilePath
    })
  }
})

第二步：新建一个下载工具文件。原生微信小程序可放到 utils/download.js：

const API_BASE = 'https://ck.og1.top'

function toProxyUrl(rawUrl) {
  if (!rawUrl) return ''

  // 已经是本站代理地址时，不重复套代理
  if (rawUrl.indexOf(API_BASE + '/api/resource/preview') === 0) {
    return rawUrl
  }

  const proxyUrl = API_BASE + '/api/resource/preview?url=' + encodeURIComponent(rawUrl)
  return proxyUrl
}

function uniqueUrls(urls) {
  const result = []
  urls.forEach(url => {
    url = url ? String(url).trim() : ''
    if (url && result.indexOf(url) === -1) {
      result.push(url)
    }
  })
  return result
}

function isBilibiliProtectedUrl(url) {
  return /\/\/[^/]*(?:bilivideo\.com|hdslb\.com|bilibili\.com)(?:[/:?#]|$)/i.test(url || '')
}

function downloadFileByDirectFirst(rawUrl) {
  const proxyUrl = toProxyUrl(rawUrl)
  const urls = isBilibiliProtectedUrl(rawUrl)
    ? uniqueUrls([proxyUrl, rawUrl])
    : uniqueUrls([rawUrl, proxyUrl])

  return new Promise((resolve, reject) => {
    function tryDownload(index) {
      const downloadUrl = urls[index]
      if (!downloadUrl) {
        reject(new Error('没有可下载资源'))
        return
      }

      wx.downloadFile({
        url: downloadUrl,
        success(res) {
          if (res.statusCode === 200 && res.tempFilePath) {
            resolve(res.tempFilePath)
            return
          }

          if (index + 1 < urls.length) {
            tryDownload(index + 1)
            return
          }

          reject(new Error('下载失败'))
        },
        fail() {
          if (index + 1 < urls.length) {
            tryDownload(index + 1)
            return
          }

          reject(new Error('下载域名未配置或网络异常'))
        }
      })
    }

    tryDownload(0)
  })
}

function saveByDirectFirst(rawUrl, type) {
  wx.showLoading({ title: '下载中' })

  downloadFileByDirectFirst(rawUrl)
    .then(tempFilePath => {
      const saveApi = type === 'image' ? wx.saveImageToPhotosAlbum : wx.saveVideoToPhotosAlbum
      saveApi({
        filePath: tempFilePath,
        success() {
          wx.hideLoading()
          wx.showToast({ title: '保存成功' })
        },
        fail() {
          wx.hideLoading()
          wx.showToast({ title: '请授权相册权限', icon: 'none' })
        }
      })
    })
    .catch(err => {
      wx.hideLoading()
      wx.showToast({ title: err.message || '下载失败', icon: 'none' })
    })
}

module.exports = {
  toProxyUrl,
  downloadFileByDirectFirst,
  saveByDirectFirst
}

第三步：把页面里原来的直接下载代码替换成下面这样：

const downloader = require('../../utils/download')

// 保存视频：先下载 video_url，失败后自动走本站代理
downloader.saveByDirectFirst(result.video_url, 'video')

// 保存单张图片
const firstImage = (result.image_urls || result.images || [])[0]
downloader.saveByDirectFirst(firstImage, 'image')

如果是图集，需要批量保存图片，可以这样写：

const downloader = require('../../utils/download')

function saveImages(result) {
  const images = result.image_urls || result.images || []
  if (!images.length) {
    wx.showToast({ title: '没有图片', icon: 'none' })
    return
  }

  let index = 0
  function saveNext() {
    if (index >= images.length) {
      wx.showToast({ title: '全部保存完成' })
      return
    }

    const current = images[index]
    index += 1

    downloader.downloadFileByDirectFirst(current)
      .then(tempFilePath => {
        wx.saveImageToPhotosAlbum({
          filePath: tempFilePath,
          complete: saveNext
        })
      })
      .catch(() => {
        saveNext()
      })
  }

  saveNext()
}

uni-app 项目可以用下面这版，放到 utils/download.js：

const API_BASE = 'https://ck.og1.top'

export function toProxyUrl(rawUrl) {
  if (!rawUrl) return ''
  if (rawUrl.indexOf(API_BASE + '/api/resource/preview') === 0) return rawUrl
  return API_BASE + '/api/resource/preview?url=' + encodeURIComponent(rawUrl)
}

function uniqueUrls(urls) {
  const result = []
  urls.forEach(url => {
    url = url ? String(url).trim() : ''
    if (url && result.indexOf(url) === -1) result.push(url)
  })
  return result
}

function isBilibiliProtectedUrl(url) {
  return /\/\/[^/]*(?:bilivideo\.com|hdslb\.com|bilibili\.com)(?:[/:?#]|$)/i.test(url || '')
}

export function downloadFileByDirectFirst(rawUrl) {
  const proxyUrl = toProxyUrl(rawUrl)
  const urls = isBilibiliProtectedUrl(rawUrl)
    ? uniqueUrls([proxyUrl, rawUrl])
    : uniqueUrls([rawUrl, proxyUrl])

  return new Promise((resolve, reject) => {
    function tryDownload(index) {
      const downloadUrl = urls[index]
      if (!downloadUrl) {
        reject(new Error('没有可下载资源'))
        return
      }

      uni.downloadFile({
        url: downloadUrl,
        success(res) {
          if (res.statusCode === 200 && res.tempFilePath) {
            resolve(res.tempFilePath)
            return
          }

          if (index + 1 < urls.length) {
            tryDownload(index + 1)
            return
          }

          reject(new Error('下载失败'))
        },
        fail() {
          if (index + 1 < urls.length) {
            tryDownload(index + 1)
            return
          }

          reject(new Error('下载域名未配置或网络异常'))
        }
      })
    }

    tryDownload(0)
  })
}

export function saveByDirectFirst(rawUrl, type = 'video') {
  uni.showLoading({ title: '下载中' })

  downloadFileByDirectFirst(rawUrl)
    .then(tempFilePath => {
      if (type === 'image') {
        uni.saveImageToPhotosAlbum({
          filePath: tempFilePath,
          success: () => {
            uni.hideLoading()
            uni.showToast({ title: '保存成功' })
          },
          fail: () => {
            uni.hideLoading()
            uni.showToast({ title: '请授权相册权限', icon: 'none' })
          }
        })
        return
      }

      uni.saveVideoToPhotosAlbum({
        filePath: tempFilePath,
        success: () => {
          uni.hideLoading()
          uni.showToast({ title: '保存成功' })
        },
        fail: () => {
          uni.hideLoading()
          uni.showToast({ title: '请授权相册权限', icon: 'none' })
        }
      })
    })
    .catch(err => {
      uni.hideLoading()
      uni.showToast({ title: err.message || '下载失败', icon: 'none' })
    })
}

uni-app 页面里这样调用：

import { saveByDirectFirst } from '@/utils/download.js'

// 保存视频
saveByDirectFirst(this.result.video_url, 'video')

// 保存图片
saveByDirectFirst(this.result.image_urls[0], 'image')

6查询余额/套餐状态

wx.request({
  url: 'https://ck.og1.top/open-api/balance',
  method: 'GET',
  data: {
    key: API_KEY
  },
  success(res) {
    if ((res.data || {}).code === 200) {
      console.log('余额信息', res.data.data)
    }
  }
})

7常见问题