Memene API

开发文档
开发者控制台
入门指南如何使用开放平台
入门指南

如何使用开放平台

欢迎来到 Memene API 开放平台。本文档将帮助你了解平台的基本使用流程，以及如何让 AI Agent 接入我们的 API。

平台现状

Memene API 开放平台目前处于内测阶段，暂未开放公开注册。内测期间通过直接发放账号的方式提供使用。如需获取内测账号，请通过以下方式联系我们：

  • 前往 联系我们 页面查看联系方式
  • 或在页面右上角点击「联系我们」直接扫码联系客服

登录与使用

  1. 收到内测账号后，在 登录页面 使用账号密码登录
  2. 登录后进入 开发者控制台，在 API Key 管理页 创建 API Key

每个 API Key 创建后仅显示一次完整密钥，请立即保存。之后只能看到 Key ID 前缀。

发起 API 请求

所有需要认证的接口都要求在请求头中携带 API Key：

txt
Authorization: Bearer YOUR_API_KEY

API 的 Base URL 为 https://api.memene.cn， 以下是一个 cURL 示例：

bash
curl -X GET "https://api.memene.cn/health" \
  -H "Authorization: Bearer YOUR_API_KEY"

为 AI Agent 提供文档

如果你希望让 AI Agent（如大语言模型）了解并调用 Memene API，可以将以下端点提供给它：

端点说明
/llms.txt站点级 API 索引，列出所有可用接口的摘要
/llms-full.txt完整导航地图，包含入门指南、计费规则和全部端点索引
/docs/{endpointId}/llm.txt单个接口的详细参数与响应文档
/docs/{endpointId}/skill单个接口的 Skill 定义（符合 SKILL.md 标准，可直接用于 Claude Code、OpenClaw 等 AI Agent）

这些端点均遵循 llms.txt 规范，以纯文本 Markdown 格式输出，方便 Agent 直接解析和使用。

其中 /skill 端点生成的内容遵循 SKILL.md 标准，包含 YAML frontmatter、完整的接口参数（含嵌套字段）、请求/响应示例和调用代码示例，可直接作为 Claude Code 或 OpenClaw 的 Skill 使用。你也可以在每个接口文档页面点击右上角的「帮助」按钮，选择「SKILL」一键复制。

你也可以复制上方的端点地址，提交给你惯用的大模型，让它辅助你完成 API 调用的相关操作。

异步任务接口

部分接口由于数据量较大或上游响应时间较长，采用异步任务模式。这类接口不会直接返回结果，而是返回一个 taskId，你需要通过轮询来获取最终结果。

调用流程：

  1. 调用提交接口（如 POST /v1/meme/memeItemsByDomain），获得 taskId 和 pending 状态
  2. 每隔 3-5 秒轮询对应的查询接口（如 GET /v1/meme/memeItemsByDomain/:taskId）
  3. 当 status 变为 completed 时，output 字段包含完整结果
  4. 当 status 变为 failed 时，error 字段包含错误信息

超时说明：

  • 异步任务一般不会超过 5 分钟完成
  • 系统设置了 20 分钟的最大超时限制，超时后任务将自动标记为失败
  • 任务失败时已冻结的费用会自动退还

计费说明：

  • 费用在提交任务时冻结
  • 任务成功完成后确认扣费
  • 任务失败或超时后自动退还冻结金额

下一步

  • 查看 计费规则，了解接口调用的计费方式
  • 在左侧导航中浏览所有可用的 API 接口，每个接口页面都提供参数说明、在线调试和代码生成