哼哼猫文档
本页内容

哼哼猫开发者接口文档

本文档是当前版本(v1)接口。仍在使用老版本(无版本号 /openapi/…)接口的开发者,文档见 GitHub Media-Downloader-API,迁移指南见 从老版本迁移。

🚀 快速开始

哼哼猫开发者接口 v1 提供两种接入方式,用同一个 API Key、同一套计费:

  • REST API:接口地址以 https://api.meowload.net/openapi/v1 开头,请求使用 Authorization: Bearer <你的 API Key> 认证,返回 JSON。需要上传文件时,按 文件上传指南 使用接口返回的上传地址。
  • MCP:托管的 MCP server(https://api.meowload.net/mcp),配好后可在 Claude Code、Codex、Cursor 等 AI Agent 里直接调用,不需要写代码;音视频转文字仅通过 REST 提供

获取 API Key

在开始之前,请先前往 开发者管理中心 获取您的 API Key。

从 快速开始 入手,一次 curl 即可调通;不想写代码,看 MCP 接入。

📚 接口列表

核心接口

接口功能描述API 参考
单帖提取提取单个视频、图片、音乐等媒体内容POST /extract/post
批量提取批量提取主页、播放列表、频道、话题内容POST /extract/playlist
字幕提取提取 YouTube 与 B 站字幕POST /extract/subtitles
YouTube 代理下载提取 YouTube 媒体信息与临时代理下载链接POST /youtube/proxy-download
文件上传上传音频、图片或视频,并获取文件 IDPOST /uploads
音视频转文字引用已上传音频或提交音视频直链,异步获取文字与时间戳POST /transcriptions
查询额度查询账户剩余 API 积分GET /credits

提取接口成功(HTTP 200)才扣费;转录在音频准备后预扣,执行失败退回,查询任务免费。计费规则见 开发者管理中心。

代码示例

Python、JavaScript、PHP、Golang 四种语言的完整调用示例:

下一步

  • 快速开始:获取 API Key、发出第一个请求、读懂响应与错误体
  • API 参考:全部端点的完整参数与响应字段,可在线调试
  • 错误码:18 个提取错误码与 retryable 语义
  • MCP 接入:在 Claude Code、Codex、Cursor 里直接调用
  • 代码示例:Python、JavaScript、PHP、Golang
  • 从老版本迁移:老版本接口到 v1 的字段改名对照与迁移清单