Green Screen Memes

Green Screen Memes API 示例

可直接复制粘贴的 Green Screen Memes API 示例： 约有 2,100 个绿幕表情包片段（背景为纯绿色、蓝色或红色的热门反应表情包，大多数保留原始声音），可按反应、动作或主题搜索，通过 REST 或 MCP 使用。每天都会添加新片段。

每个示例都会查找一个片段、下载它，并将其抠像合成到你自己的照片或视频上，最终生成适用于 Shorts、Reels 或 TikTok 的 1080x1920 MP4。

用作 Claude Code 插件

此仓库也是 Claude Code 插件市场。该插件会配置 MCP 服务，并添加一个 make-memes 技能，用于规划字幕、查找片段并通过 ffmpeg 合成单个表情包或整批表情包。在启动 Claude Code 的 shell 中设置 GSM_API_KEY（免费密钥），然后运行：

/plugin marketplace add green-screen-memes/green-screen-memes-api
/plugin install green-screen-memes@green-screen-memes

然后提出类似“我想为我的企业制作很多表情包”的请求。Codex 和其他 Agent：请参阅 AGENTS.md，了解相同的工作流和 MCP 配置。

示例	展示内容	运行方式
claude-code/	连接 MCP 服务，然后根据一个提示词制作表情包	claude mcp add --transport http green-screen-memes https://api.greenscreenmemes.app/mcp --header "Authorization: Bearer $GSM_API_KEY"
node/	使用 Node 18+ 搜索、下载并合成，无需依赖	node examples/node/meme.mjs "shocked cat" background.jpg
python/	使用 Python 标准库实现相同功能	python3 examples/python/meme.py "shocked cat" background.jpg
ffmpeg/	curl + ffmpeg 脚本：将绿幕抠像合成到照片上，或合成到带混合音频的视频上	examples/ffmpeg/key-over-image.sh background.jpg greenscreen.mp4 green
remotion/	使用预先抠像的透明片段制作 Remotion 合成	cd examples/remotion && npm install && npm run studio
trending-to-short/	将今日排名第一的热门片段制作为竖屏短视频	node examples/trending-to-short/trending-to-short.mjs background.jpg

除 MCP 配置外，所有示例都需要在 PATH 中安装 FFmpeg（含 ffprobe）。

1. 获取免费密钥

在 https://api.greenscreenmemes.app/dashboard 登录（使用 Google 账号或电子邮件链接），并创建一个免费的 Sandbox 密钥：总共可下载 50 个视频，每月可调用 30,000 次，适用于构建和测试。然后：

cp .env.example .env          # put your key in GSM_API_KEY
set -a; source .env; set +a   # or: export GSM_API_KEY=gsm_live_...

请将密钥保存在你的计算机或服务器上。API 不会发送 CORS 标头，因此请从后端调用，而不要从浏览器调用。

2. 从 AI Agent 使用（MCP）

claude mcp add --transport http green-screen-memes https://api.greenscreenmemes.app/mcp \
  --header "Authorization: Bearer $GSM_API_KEY"

Cursor 和其他 MCP 客户端：使用网址 https://api.greenscreenmemes.app/mcp 和相同的 Authorization 标头。现成的配置位于 examples/claude-code。该服务也已列入官方 MCP Registry，名称为 app.greenscreenmemes.api/green-screen-memes。

然后，例如提出以下请求：

为我的咖啡店制作一个表情包。找到一段有人或某物明显表现出如释重负或喜悦的绿幕视频，将它抠像合成到 ./shop.jpg 上，制作成竖屏视频，并配上字幕“Monday, fixed.”

工具：search_green_screens、get_green_screen（视频链接和可直接使用的 ffmpeg 命令）、get_trending、list_collections、get_collection、list_tags、get_usage。

3. 或调用 REST

curl -H "Authorization: Bearer $GSM_API_KEY" \
  "https://api.greenscreenmemes.app/v1/memes?q=side%20eye&limit=5"

端点
GET /v1/memes?q=&tag=&color=&updatedSince=&limit=&cursor=	搜索或列出绿幕素材
GET /v1/memes/{id}	单个绿幕素材（对 id 进行 URL 编码）
GET /v1/trending	查看 Green Screen Memes 应用当前的热门内容，以及其 rank
GET /v1/collections、GET /v1/collections/{id}	精选合集
GET /v1/tags	使用最多的标签
GET /v1/usage	你的套餐和本月用量
GET /v1/removed?since=	按权利持有人要求下架的片段

列表会返回 { data, total, nextCursor }；错误会返回 { error: { code, message } }。 每个片段包含 id、name、description、tags、chromaKeyColor（green、blue、 red 或 none）、durationSeconds、thumbnailUrl 和 videoUrl。媒体链接会根据你的密钥签名， 并在约 6 小时后过期，因此请下载文件，不要保存链接。

完整参考文档：https://api.greenscreenmemes.app/docs · OpenAPI：https://api.greenscreenmemes.app/v1/openapi.json · 面向大模型：https://api.greenscreenmemes.app/llms.txt

4. 使用 FFmpeg 抠像

叠加在照片上（竖屏 1080x1920，片段位于底部，保留片段声音）：

ffmpeg -loop 1 -i background.jpg -i greenscreen.mp4 -filter_complex \
 "[0:v]scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920,setsar=1[bg];\
  [1:v]chromakey=0x00ff00:0.2:0.05,scale=1080:-2[fg];\
  [bg][fg]overlay=(W-w)/2:H-h:shortest=1,format=yuv420p[v]" \
 -map "[v]" -map "1:a?" -c:v libx264 -crf 20 -c:a aac meme.mp4

抠像颜色：绿色 0x00ff00、蓝色 0x0000ff、红色 0xff0000。如果颜色为 none，则原样使用片段。如果仍有绿色边缘，请稍微调高 0.2；如果主体部分变得透明，请调低它。要叠加在视频上并混合音频，请参阅 examples/ffmpeg。

视频 meme API

如果你正在构建视频工具、短视频内容流水线或 meme 应用，并且需要真正的视频 meme，而不是图片模板，这就是适合你的 API：纯色抠像背景的短 MP4 片段，带有声音，以及用于搜索的元数据和合成片段的 ffmpeg 命令。它不会生成 meme，也不会移除你的视频背景；它提供的是一个精选的即用型绿幕素材库。

反应片段 API

片段会根据其中发生的事情打上标签，因此用情绪或动作搜索效果最佳：shocked、slow clap、side eye、crying、happy dance、waiting。GET /v1/tags 会展示素材库涵盖的内容，GET /v1/trending 会返回人们当前在 Green Screen Memes 应用中最常使用的内容。若要保持本地副本同步，请轮询 GET /v1/memes?updatedSince=<ISO date>，并删除 GET /v1/removed 列出的所有内容。

meme 的 MCP 服务

位于 https://api.greenscreenmemes.app/mcp 的 MCP 服务可让 Claude Code、Cursor 或任何能使用 shell 的 Agent 查找片段、获取下载链接并自行运行合成。get_green_screen 会返回与该片段抠像颜色对应的 ffmpeg 命令，因此 Agent 无需自行推导滤镜图。与 REST 使用相同的密钥和限制；每次工具调用计为一次调用。

片段的使用方式

这些都是网络 meme。Green Screen Memes 制作绿幕版本、添加标签并对其进行精选，同时提供搜索功能；**原始素材不属于我们，API 也不会向你授予其使用许可。**如何使用片段由你负责。

• 付费套餐下，片段可用于应用，也可用于你自己或客户发布的视频。沙盒密钥仅用于开发和测试。
• 可以在企业自己的账号或其客户的账号上发布自然内容，其中也可以包含人物。
• 不得将包含可识别人物的片段用于付费广告、赞助帖子或代言。动物、物品和卡通形象不受此限制。
• 不要在新作品中使用 GET /v1/removed 列出的片段，并从你保存的任何内容中删除它们。

完整条款：https://api.greenscreenmemes.app/terms

许可证

此仓库中的示例代码采用 MIT 许可证。它仅涵盖代码：此处不包含任何片段，你从 API 获取的片段、缩略图和目录数据则受 API 条款约束，而非 MIT 许可证。

如有疑问，请联系：[email protected] · Green Screen Memes 由 Hedko Group LLC 制作。