智能体
接入画境 MCP
配置一次后,智能体(如 Qoder、Trae、Codex、Cursor、Copilot 等)即可入库素材、调用异步 AI(抠图/放大/消除/生成/扩图/局部重绘),并保存作品;结果会出现在当前个人空间的图库与作品列表中。
签发 Agent 密钥
前往巨人肩膀工作空间设置,切换到个人空间后,在 Agent API Key 中点击「签发密钥」,复制明文密钥(仅显示一次)。画境 MCP 仅支持个人空间密钥。
密钥格式一般为
bigapp_...,须为个人空间签发;请妥善保存明文密钥。配置 MCP
将 BIGAPP_API_KEY 换成你的密钥后写入 MCP 配置;推荐用 npx 拉取 huajing-mcp,无需本地构建。需 Node.js 18+。
已有 MCP 选 ,首次用 , 后粘贴到
.cursor/mcp.json或 Cursor Settings → MCP。{ "mcpServers": { "huajing": { "command": "npx", "args": [ "-y", "huajing-mcp" ], "env": { "BIGAPP_API_KEY": "粘贴个人空间签发的 Agent 密钥" } } } }验证并调用能力
重载 MCP 后先让智能体调用 whoami,再按需入库素材并创建 AI 任务;可用下方提示词一键交给智能体。
连通性测试请调用画境 MCP 工具 whoami,测试画境是否已连通。 【必须执行】 1. 使用 MCP 工具 whoami(不要猜测或模拟返回) 2. 调用成功后告诉我:creatorUserId、工作空间名称与类型 3. 若失败,把报错信息原样贴出
入库并跑 AI请调用画境 MCP,入库一张图片并完成一次 AI 处理。 【必须执行】 1. 若我提供了公网图片 URL:调用 importImageFromUrl;否则用 uploadImage(localPath 或 base64) 2. 调用 createAiMatting(或我指定的 createAiUpscale / createAiRemove / createAiGenerate / createAiExpand / createAiRedraw),传入上一步返回的 imageFileId;无需先 saveProject(未传 editorWorkId 会自动建稿) 3. 调用 waitAiTask,等待任务成功或失败 4. 成功后告诉我:inputImageFileId、taskId、editorWorkId、outputImageFileId、outputPublicUrl 不要只在聊天里描述,必须真正调用工具。精修(裁剪/水印等)请提示我回画境 Web 编辑器。
保存作品请调用画境 MCP,将当前处理结果更新到已有作品。 【必须执行】 1. 若尚无 editorWorkId:先 createAi*(传 workName)建稿,再 waitAiTask;不要用 saveProject 新建 2. 若我未提供 imageFileId,先 listImages 让我确认要用哪张图 3. 调用 saveProject({ workId: editorWorkId, workName, images }):作品名称可用「MCP 接入验证」;关联对应 imageFileId(优先 AI 输出图) 4. 调用 getProject,确认槽位定稿已更新 完成后告诉我:workId、作品名称、封面/主图 URL、recipeKey。可在画境「全部作品」中继续编辑(Aido/默认进通用生图场景页;具体场景或工具类配方会分流到对应壳)。
工具能力
推荐顺序:whoami →(可选 listRecipes)→ importImageFromUrl|uploadImage → createAi*({ workName, recipeKey? }) → waitAiTask → 使用 outputPublicUrl / outputImageFileId;多图再 saveProject({ workId, workName, images }) 更新槽位。并稿看「是否仍在交用户当前这一份作品」:是则复用 editorWorkId,或固定同一 deliverableKey/workName(MCP 按键自动并稿);另开独立作品时换键即可。建稿仅 createAi*;saveProject 只更新、不新建。recipeKey 按用户意图从全量目录选(电商主图等→场景壳,去水印等→工作台;仅笼统未匹配才默认 generic-work→通用生图)。智技 Skill 须传 skillSlug。精修请回 Web 编辑器。
whoami校验密钥,返回签发者与工作空间摘要listRecipes全量场景/工作台配方目录,供按意图选 recipeKeylistImages分页列出当前空间素材getImage查询素材元数据与公网 URLimportImageFromUrl从公网 URL 入库素材uploadImage本地路径或 base64 上传入库createAiMatting创建 AI 抠图任务createAiUpscale创建 AI 放大任务createAiRemove创建 AI 消除任务createAiGenerate创建 AI 文生图 / 图生图任务createAiExpand创建 AI 扩图任务createAiRedraw创建 AI 局部重绘任务getAiTask查询 AI 任务状态与结果waitAiTask轮询至任务终态或超时cancelAiTask取消进行中的 AI 任务listProjects分页列出作品getProject查询作品详情saveProject更新已有作品(建稿请用 createAi*)deleteProject删除作品
