模板库 · /api/templates

模板是带填空位的出图配方。跟技能的区别：技能一句话进一张图出，模板由你填字段，服务端做确定性替换 —— 更可控，而且不经过模型展开这一步，更省。

填入你的 API Key本站所有示例里的 $MUSEAV_API_KEY 会就地换成它

只存在你自己浏览器的 localStorage 里，不会发给任何人——本站是纯静态页面，没有后端可发。共用电脑上看完记得点「清除」。

三类模板

图片和文案在同一张表，用 type 区分；视频是独立的表（字段不一样）。

bash

# 图片模板
curl "https://manager.museav.top/api/templates?type=image&source=all" -H "X-API-Key: $MUSEAV_API_KEY"

# 文案模板
curl "https://manager.museav.top/api/templates?type=article&source=all" -H "X-API-Key: $MUSEAV_API_KEY"

# 视频模板（另一个接口）
curl "https://manager.museav.top/api/video-templates?source=all" -H "X-API-Key: $MUSEAV_API_KEY"

type 只能是 image / article，不传 = 两类都给。传非法值返回 400。

来源切换 `source`

取值	给你什么
`mine`	只给你自己建的模板
`platform`	只给中台公共模板
`all`	两者合并（不传时的默认值）

每一行都带 source: "mine" | "platform"，直接拿它渲染「来源」标签，不用自己去比对 tenant_id。

传了非法值返回 400，不会静默按默认查。

字段按各自的表原样下发

图片模板有 ratio / sample_images / template_type / domain
视频模板有 sample_cover_image / sample_video_url，而 ratio 和 duration 在 generation_configs 里

两者不强行拉平。你按 media 类型各读各的，来源切换的用法是同一套。

完整字段标准见模板字段标准。

建、改、停用

操作	怎么做
建	`POST` 同一路径，自动打上你的 `tenant_id`
改	`PATCH` 带 `id`
停用	`PATCH` 设 `active: false`
删除	平台专属，你不能删自己的模板

为什么只能停用不能删

模板是长期资产 —— 别人的流水线钩子可能正引用着它的 slug，历史任务也指向它。删掉会让那些引用变成悬空。停用就够了。

（流水线钩子本身是你的流程配置，那个可以随便删。）

用模板出图

bash

curl -X POST https://manager.museav.top/api/generate \
  -H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
  -d '{"template_id":"<模板id>","input":{"title":"黄皮生椰拿铁","subject":"咖啡杯"}}'

文案模板用 POST /api/article，视频模板用 POST /api/videos。

模板库 · /api/templates ​

三类模板 ​

来源切换 source ​

字段按各自的表原样下发 ​

建、改、停用 ​

用模板出图 ​

相关 ​