Memene API

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

如何使用开放平台

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

平台现状

前往注册页面,使用邮箱和密码即可创建开发者账号;邀请码为选填项,填写有效邀请码可获赠 20 元余额。新用户默认获得 LLM Gateway 用户侧权限。

登录与使用

  1. 在注册页面创建账号,或在登录页面使用已有账号登录
  2. 注册后进入 LLM API 控制台,在 API Key 管理页 创建 Gateway 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 接口,每个接口页面都提供参数说明、在线调试和代码生成