Meme 服务

批量查询 RSS 文章图片需要认证¥0.005/次

POST/v1/meme/rss/images/query

接口说明

批量查询 RSS 文章页面中已提取的图片链接。每张图片同时返回原站 URL 和通过 wsrv.nl 动态生成的代理 URL，以及 HTML 中声明的用途、位置、宽高。平台不保存图片，也不执行视觉模型分析。

请求参数

article_unique_ids：必填，RSS 文章的 uniqueId 数组；可从 RSS 内容查询接口返回项中获取。
单次最少 1 篇、最多 50 篇，ID 必须是 32 位小写十六进制字符串且不可重复。

逐篇状态

status	含义
ready	图片清单已提取，manifest.images 允许为空数组
not_extracted	文章存在，但历史数据尚未生成图片清单
not_found	文章不存在

单篇缺失不会导致整批失败，结果顺序与请求顺序一致。图片 URL 属于原站资源，其可访问性、防盗链和有效期由原站决定。

url：原站图片地址。
proxyUrl：经过 URL 编码后拼接的 wsrv.nl 地址，默认限制宽度 1920px，并输出 WebP（质量 82）。该公共服务不提供可用性 SLA。

计费说明

需要有效的 API Key（Bearer Token）。
按批量请求次数计费，不按文章数或图片数叠加；失败时自动退还。

请求头

参数类型必填说明

Authorizationstring是

从 Memene API 开放平台获取的 API Key。是 Bearer Token 格式，例如：Bearer sk_memene_xxx_yyy。可以点击此处获取 API KEY

请求参数

参数类型必填说明

article_unique_idsarray<RSS 文章唯一 ID（32 位小写十六进制 MD5）>是

待查询的 RSS 文章 uniqueId，单次 1-50 个且不可重复

请求示例

application/json

json

{
  "article_unique_ids": [
    "c4ca4238a0b923820dcc509a6f75849b",
    "c81e728d9d4c2f636f067f89cc14862c"
  ]
}

响应结构

200

Default Response

application/json

字段类型说明

statusCodenumber

messagestring

dataobject

└itemsarray<RssArticleImagesResultItem>

按请求顺序返回的逐篇结果

└uniqueIdstring

RSS 文章唯一 ID（32 位小写十六进制 MD5）

└statusstring

└manifestobject

RSS 文章图片清单

└versionnumber

图片清单结构版本

└imageCountnumber

实际返回的图片数量

└observedCountnumber

提取过程中观察到的候选图片数量

└truncatedboolean

是否因数量或存储上限发生截断

└imagesarray<RssArticleImageReference>

图片链接清单，最多 50 项

└urlstring

原站图片 URL

└proxyUrlstring

通过 wsrv.nl 动态生成的图片代理 URL

└rolestring

图片用途：封面或正文图片

└positionnumber

同一用途下的顺序，从 0 开始

└widthnumber

HTML 声明的宽度（像素）；未声明时省略

└heightnumber

HTML 声明的高度（像素）；未声明时省略

└extractedAtstring

图片清单提取时间（ISO 8601）

└updatedAtstring

图片清单更新时间（ISO 8601）

└requestedCountnumber

└readyCountnumber

└notExtractedCountnumber

└notFoundCountnumber

示例

json

{
  "statusCode": 200,
  "message": "success",
  "data": {
    "items": [
      {
        "uniqueId": "c4ca4238a0b923820dcc509a6f75849b",
        "status": "ready",
        "manifest": {
          "version": 1,
          "imageCount": 1,
          "observedCount": 1,
          "truncated": false,
          "images": [
            {
              "url": "https://example.com/article/image.jpg",
              "proxyUrl": "https://wsrv.nl/?url=https%3A%2F%2Fexample.com%2Farticle%2Fimage.jpg&w=1920&output=webp&q=82",
              "role": "inline",
              "position": 0,
              "width": 1200,
              "height": 800
            }
          ],
          "extractedAt": "2026-07-19T00:00:00.000Z",
          "updatedAt": "2026-07-19T00:00:00.000Z"
        }
      },
      {
        "uniqueId": "c81e728d9d4c2f636f067f89cc14862c",
        "status": "not_extracted"
      }
    ],
    "requestedCount": 2,
    "readyCount": 1,
    "notExtractedCount": 1,
    "notFoundCount": 0
  }
}

400

Default Response

application/json

字段类型说明

errorstring

messagestring

示例

json

{
  "error": "Bad Request",
  "message": "请求参数不合法"
}

401

Default Response

application/json

字段类型说明

errorstring

messagestring

示例

json

{
  "error": "Unauthorized",
  "message": "无效的 API Key"
}

402

Default Response

application/json

字段类型说明

errorstring

messagestring

示例

json

{
  "error": "Payment Required",
  "message": "余额不足"
}

502

Default Response

application/json

字段类型说明

errorstring

messagestring

示例

json

{
  "error": "Bad Gateway",
  "message": "上游服务暂时不可用"
}