📚 离职知识库

media-studio 文章配图 · 搜图 API 说明

2026-07-13 · 公众号「AI 配图」功能用到的图库与 key 存放位置速查

#用了哪两个图库

图库 官网 角色 额度 key(脱敏)
Pexels https://www.pexels.com/ (API 文档 https://www.pexels.com/api/) 主用 免费,200 次/小时、2 万次/月 cP3h……aXoy(56 位)
Pixabay https://pixabay.com/ (API 文档 https://pixabay.com/api/docs/) 兜底(Pexels 没搜到才用) 免费,100 次/分钟 5634……dec5b数字ID-hash 格式)

两把 key 都是从 ppt-master skill 复用的(它的搜图配置就是这两家),原始存放在 ~/.ppt-master/.env

#key 现在放在哪几处

位置 文件/入口 说明
本地开发 ~/personal/media-studio/.env.local PEXELS_API_KEY / PIXABAY_API_KEY,被 .gitignore.env*)忽略,不进仓库
线上 Vercel 项目 media-studio 环境变量 production / preview / development 三个环境都已加(Encrypted)
网页热改 studio.saveme505.help → 设置页 → 「文章配图搜图」卡片 存 Supabase ms_sync_state.app_config,优先级高于 env
原始来源 ~/.ppt-master/.env ppt-master skill 的配置,未改动

#GitHub 脱敏确认

  • 已全历史检索(git grep 所有 commit):两把 key 从未进过仓库
  • 仓库里的 .env.example 只有 PEXELS_API_KEY=xxxx 占位符;
  • 设置页虽可明文回显 key,但全站在密码门禁之后,且该接口未登录返回 401。

#调用链(哪里在用)

  1. 选题页「生成正文 + 配图 + 封面」→ /api/generate:正文生成后服务端自动挑 2-4 个插图点(DeepSeek 出英文搜索词)→ 搜 Pexels(搜不到换 Pixabay)→ markdown 图片插进正文;
  2. 稿件页「AI 配图(重新配图)」→ /api/drafts/[id]/illustrate:改稿后手动重配,同一条流水线;
  3. 图片原图经 /api/images/proxy(只放行 images.pexels.com / pixabay.com 域名)下载到封面绑定的本地文件夹,文件名如 配图1-xxxx.jpg

#版权说明

  • Pexels:自有 License,免费商用、无需署名(代码里仍记录了摄影师名备查);
  • Pixabay:Content License,免费商用、无需署名。

来源:配置信息/配图搜图API说明.md(整理于 2026-08-18)