接口概览

这一区是给要做集成的人看的。只是想出图的话，网页版和命令行更省事。

所有接口都在 https://www.museav.top 下。

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

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

五分钟跑通

拿一把租户 API Key（怎么拿），然后：

bash

curl -X POST https://manager.museav.top/api/generate \
  -H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
  -d '{"skill_slug":"ecom-white-backdrop","input":"米白色针织衫"}'

秒回一个任务号：

json

{ "ok": true, "jobId": "0d1f…", "status": "pending" }

出图是异步的。拿结果有两条路：回调（推荐，传 callback_url）或者轮询 GET /api/jobs。

接口分几类

你要干的事	接口
出图	`POST /api/generate`
出视频	`POST /api/videos`
写文案	`POST /api/article`
调大模型聊天（OpenAI 兼容）	`POST /api/chat`
看任务跑完没	`GET /api/jobs`
有哪些技能能用	`GET /api/skills`
管模板	`/api/templates`、`/api/video-templates`
出完图自动接下一步	`/api/template-hooks`
读一张图的构成	`POST /api/reverse`
把一张图变成模板	`POST /api/image-to-template`
传参考图/垫图/蒙版/BGM	`POST /api/upload-ref`
我这个月出了多少图、花了多少	`GET /api/tenant-stats`
平台上游还有多少余额	`GET /api/balance`
给我手下的人开账号	`/api/tenant-accounts`

三件先知道的事

一、技能和模板让你不用写提示词

skill_slug 传技能名 + input 传一句业务描述，中台替你展开成完整提示词。提示词正文不下发 —— 中台调好了什么、改了什么，都不影响你这边的调用代码。

想更可控就用模板，填空式，服务端做确定性替换，不经模型、不花模型钱。

二、出图是异步的，视频更是

/api/generate 秒回 jobId，不要在那儿等 HTTP 响应给你图。传 callback_url 让它出完通知你；回调可能丢，所以再配一条 GET /api/jobs 的兜底轮询。

三、不支持的能力会明确报错，不会静默降级

比如你要透明背景但当前没有支持的上游，接口返回 400 并说明原因， 不会给你一张白底图当作成功。

这是刻意的：白底图看起来完全正常，静默降级只会让你以为参数写错了，反复重试反复花钱。

接下来

认证与身份 —— 三种身份能干什么，别拿错 Key
错误与限流 —— 什么时候返回 400、403、429
出图 /api/generate —— 最常用的那个

接口概览 ​

五分钟跑通 ​

接口分几类 ​

三件先知道的事 ​

接下来 ​

接口概览

五分钟跑通

接口分几类

三件先知道的事

接下来