Chat 代理 · POST /api/chat
OpenAI 兼容的对话接口,支持 vision(传图片)。
填入你的 API Key本站所有示例里的
$MUSEAV_API_KEY 会就地换成它只存在你自己浏览器的 localStorage 里,不会发给任何人——本站是纯静态页面,没有后端可发。 共用电脑上看完记得点「清除」。
bash
curl -X POST https://manager.museav.top/api/chat \
-H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"deepseek","messages":[{"role":"user","content":"hi"}]}'也兼容 POST /api/chat/completions(OpenAI SDK 的标准路径)。base_url 填 https://manager.museav.top/api。
请求体和响应体走 OpenAI Chat Completions 的形状。 model 可以填官方 id,也可以填短名 deepseek / zhipu / minimax(以 GET /api/chat 的 families 为准)。
清单:GET /api/chat 或 GET /api/chat/models。用 OpenAI SDK 的话,client.models.list()(即 GET /api/models)也能拿到这份清单,探活不用绕路。
一把 Key,多个 Agent
租户(或平台)不必给每个数字成员开租户、也不必开平台账号。服务端共用一把 API Key,每次请求带上是谁在调:
bash
curl -X POST https://manager.museav.top/api/chat \
-H "X-API-Key: $MUSEAV_API_KEY" \
-H "X-CS-Agent: lunove" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek","messages":[{"role":"user","content":"hi"}]}'也可以写在 JSON 里(头优先):{"agent":"hym-poster","model":"deepseek","messages":[...]}。
规则:
agent只能是 1–32 位、字母开头的[a-z0-9_-](会转成小写)。- 用量记在这把 Key 名下(
tenant_id/account_id),agent_id只是拆账标签。限流仍是 Key 每小时 300 次,不是按 agent 各算各的。 - 好易美 / 猫砂自己的助手同样用法:Key 还是租户那一把,
X-CS-Agent: hym-poster即可。 - 不要为了分账去给 Agent 发个人账户 Key,除非那个人还要登录网页出图。
Hermes 示例:provider 的 base_url 指到中台,并加请求头 X-CS-Agent: <member_id>(与本机 CS_AGENT 一致)。
限流
chat 300 次/小时(按 Key),超了返回 429,带 Retry-After。
相关
- 写文案
/api/article—— 要的是成品文案而不是对话的话,用这个更省事 - 读图
/api/reverse—— 要的是「这张图怎么构成的」,用这个
接口集成 · 在档 L3「要接进自己的系统」的链路上 —— 本页是这条链的延伸