Skip to content

接入你的 AI 助手

把 MUSE 接到你的 AI 助手上,它就能替你出图、写文案、读图、出视频。

不用懂技术,三步,五分钟。真正要动手的只有第二步的一次复制粘贴。

第一步:拿你的 Key

Key 长这样:sk-studio- 开头的一串字符,是你的通行证。不用注册、不用找人要, 两个地方都能拿,哪个顺手用哪个:

在公司后台拿 —— 右上角头像 → 个人资料 → 先在 基本资料 里看「业务中台」那行, 显示「未开通」就点一下 「开通业务中台」(会自动用你现在的邮箱给你开好户,完事跳回来)→ 切到 出图密钥,Key 就在那儿,点复制。没有就点「获取我的 Key」。

在业务中台拿 —— 打开 www.museav.top 登录 → 进个人中心 → 找到 API Key 卡片 → 点「复制」,没有就先点「生成」。

两处是同一把 Key,随时能回去再看,不用抄在别处。

别把 Key 发群里、别写进代码

谁拿到谁就能花公司的额度。真泄露了就去个人中心点「重置」,旧的立刻作废。

第二步:把下面整段复制,粘给你的 AI 助手

只改一处:把 sk-studio-换成你自己的Key 换成你刚复制的那把。其余一个字都别动, 助手读完会自己配好并验证。

text
帮我接入 MUSE AV 中台,我是某租户下的成员账户,请你自己完成配置并验证。

凭据:
  接口地址 base_url = https://manager.museav.top/api
  密钥     api_key  = sk-studio-换成你自己的Key
  请把密钥存到环境变量 MUSEAV_API_KEY,不要写进代码或提交到仓库。

配置要点:
1. 对话按 OpenAI 协议接入:POST {base_url}/chat/completions,model 一律填 museav-auto。
   这是中台智能路由的模型名,会自动选当前最优的模型和服务商。
   不要填具体模型名、不要硬编码上游 —— 换代时中台自己换,你这边不用改。
2. 出图:POST https://manager.museav.top/api/generate,
   body 传 {"skill_slug": "<技能>", "input": "<一句业务描述>"}。
   技能名先打 GET /api/skills 拉真实清单,不要凭印象编。
   该接口秒回 jobId,出图是异步的,用 GET /api/jobs?id=<jobId> 轮询到 status=done 取 cdn_url。
3. 所有请求带头 X-API-Key: <api_key>(或 Authorization: Bearer <api_key>)。
4. 我这把是成员账户 Key,只能创作和查自己的数据。管理类接口(查全租户统计、开户、发 Key、
   支付、建模板)会返回 403,这是正常的,不要重试也不要想办法绕过。
5. 返回 400 且写着「当前无可用上游」= 这个能力暂时没有服务商支持,不要重试,直接告诉我。
   返回 429 是限流,等一会儿再试。
6. 先跑一次 curl -s https://manager.museav.top/api/balance -H "X-API-Key: $MUSEAV_API_KEY"
   确认凭据可用,再往下做,并把结果告诉我。
完整文档:https://docs.museav.top/api/agent

助手回你一句「余额查到了」之类的,就说明配通了。

框架里要选模型的地方,一律填 museav-auto —— 一个名字管所有,具体用哪个模型由中台自己挑。

第三步:直接说人话使唤它

帮我出一张米白色针织衫的电商白底图,正面平铺。

帮我写三条秋冬针织衫的小红书标题。

看看这张图是怎么拍的,给我一份能复现的描述。

出图是异步的:助手会先拿到一个任务号,过几十秒再取图 —— 这是正常的,不是卡住了。

不顺的时候

助手说怎么回事你要做的
403 / 没权限Key 少复制了一截,或者已经被重置了回第一步重新复制一次
400「当前无可用上游」这个能力暂时没有服务商支持别让它重试,换个做法或者找我们
429一下子发太多了等一会儿
积分不足公司额度用完了找你们管理员加,你自己充不了

出图花的是公司的额度,用的是公司的专属模板,不用自己充值。


要写代码做深度集成的,接口清单看接口概览,背后怎么选模型看智能路由