📚 离职知识库

Coverr 视频/音乐素材 API

#App 信息

  • App name：Demo
  • App ID：<ID>
  • API Key：<KEY>
  • 状态：Demo（免费档，50 次调用/小时；付费 Production 档可到 2000 次/小时）

#认证方式

两种方式任选一种：

  • Header 方式（推荐）：
    curl -H 'Authorization: Bearer <API_KEY>' \
  https://api.coverr.co/videos
  • Query 参数方式：
    https://api.coverr.co/videos?api_key=<API_KEY>

Base URL：https://api.coverr.co

#接口一：视频素材 /videos

用途 方法 路径
列表/搜索视频 GET /videos
获取单个视频详情 GET /videos/:id
登记下载（必须调用，官方要求用来做反馈闭环） PATCH /videos/:id/stats/downloads

列表/搜索参数：

  • page（默认 0）
  • page_size（默认 20）
  • query（搜索关键词，如 city、nature）
  • sort：date / popular / trending（默认 popular）
  • urls：true 时在列表结果里也带上视频地址（默认 false，只有单个详情接口一定带）

返回的 urls 对象（均为签了 JWT、绑定你这个 key 的地址）：

  • mp4：全分辨率
  • mp4_preview：低分辨率预览
  • mp4_download：带 Content-Disposition 的下载直链

示例：

curl -H 'Authorization: Bearer <API_KEY>' \
  'https://api.coverr.co/videos?query=city&sort=popular&page_size=10&urls=true'

拿到想用的视频后，先 GET /videos/:id 取到 mp4_download 直链下载文件，再 PATCH /videos/:id/stats/downloads 登记一次下载（204 No Content，无需处理返回体）。

#接口二：音乐素材 /audios

用途 方法 路径
列表/搜索音乐 GET /audios
获取单个音乐详情 GET /audios/:id

列表/搜索参数：

  • page（默认 0）
  • page_size（默认 20）
  • query（搜索关键词）
  • sort：date / popular（默认 popular）

音频对象关键字段： id、slug、filename、name、title、description、duration、genres[]、instruments[]、videoThemes[]、moods[]、tempo、isPremium、downloads、listens，以及 urls.preview / urls.previewDownload / urls.masterDownload

示例：

curl -H 'Authorization: Bearer <API_KEY>' \
  'https://api.coverr.co/audios?query=upbeat&sort=popular'

#其他

  • 官方也提供 MCP Server（文档在 /docs/mcp），可以让 AI agent 直接 discover/search/retrieve 素材，适合接进自动化视频生成流程（比如 MoneyPrinterTurbo）。
  • 免费档素材使用需遵守 attribution 要求，具体条款见 https://coverr.co/license；付费 Production 档通常免署名，注册后到 /pricing 看具体条款。
  • Key 泄露请到 Coverr 控制台重置。

来源：配置信息/Coverr视频音乐API.md（整理于 2026-08-18）

相关笔记