智能体

接入画境 MCP

配置一次后,智能体(如 Qoder、Trae、Codex、Cursor、Copilot 等)即可入库素材、调用异步 AI(抠图/放大/消除/生成/扩图/局部重绘),并保存作品;结果会出现在当前个人空间的图库与作品列表中。

  1. 签发 Agent 密钥

    前往巨人肩膀工作空间设置,切换到个人空间后,在 Agent API Key 中点击「签发密钥」,复制明文密钥(仅显示一次)。画境 MCP 仅支持个人空间密钥。

    密钥格式一般为 bigapp_...,须为个人空间签发;请妥善保存明文密钥。

  2. 配置 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 密钥"
          }
        }
      }
    }
  3. 验证并调用能力

    重载 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/默认进通用生图场景页;具体场景或工具类配方会分流到对应壳)。

    入库与 AI 结果可在 图库 查看;作品会出现在 全部作品 。

工具能力

推荐顺序: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全量场景/工作台配方目录,供按意图选 recipeKey
  • listImages分页列出当前空间素材
  • getImage查询素材元数据与公网 URL
  • importImageFromUrl从公网 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删除作品