Memene API

开发文档
开发者控制台
入门指南计费规则
入门指南

计费规则

Memene API 采用按次计费模式,不同接口有不同的单价。部分基础接口免费使用。

计费方式

  • 每次成功的 API 调用按接口单价扣费
  • 返回 4xx/5xx 错误的请求不计费
  • 单价以人民币(¥)计算,精确到小数点后四位

查看接口价格

每个 API 接口文档页面的标题旁会显示价格标签:

  • ¥X.XXXX/次 — 付费接口,显示具体单价
  • 免费 — 需要认证但不收费的接口
  • 无标签 — 公开接口,无需认证也不收费

余额与充值

  1. 开发者控制台 查看当前账户余额
  2. 余额不足时 API 调用将返回 402 Payment Required
  3. 联系平台管理员进行充值

用量查询

用量统计页 可以查看:

  • 按日期的调用量趋势
  • 按 API Key 的消费明细
  • 按接口的调用分布

异步任务接口的计费

部分耗时较长的接口(如领域内容查询)采用异步任务模式,其计费流程与普通接口略有不同:

  1. 提交任务时:费用从余额中冻结(暂扣),但不立即扣除
  2. 任务成功完成:冻结金额确认扣除
  3. 任务失败或超时:冻结金额自动退还至账户余额

异步任务的最大超时时间为 20 分钟。一般情况下任务会在 5 分钟内完成。

Gateway(AI API 中转)的计费

Gateway(gw_memene_xxx 密钥)采用后付费模式,与上面的开放 API 略有不同:

  1. 请求开始:仅校验余额是否高于透支下限,不预扣金额
  2. 请求结束:根据上游返回的真实 token 用量计算 cost,按 cost = (input/1M × 输入单价) + (output/1M × 输出单价) 异步扣费
  3. 失败请求:上游返回 4xx/5xx 或没有获取到 usage 时不扣费
  4. 流式中断:按已收到的 usage 部分扣费

透支与拒绝

为了保证"已经放进来的请求一定能完整跑完",Gateway 允许账户余额在请求结束扣费时短暂跌至负值:

  • 余额 > 0:放行
  • 余额 ≤ 0 且 > -透支额度:依然放行(已被允许的请求不会被中途打断)
  • 余额 ≤ -透支额度:直接返回 402 INSUFFICIENT_BALANCE,需要充值后才能继续调用

默认透支额度为 5 元,足以覆盖单次大模型请求和瞬时并发的尾差。

由于扣费是异步批量执行的(每 ~2 秒一批),充值后看到的余额变化可能略有延迟。 控制台的"账单流水"会列出每一笔 Gateway 扣费记录(type 为 gateway_consume),可与"调用日志"一一对照。