智能体

接入影境 MCP

配置一次后,智能体即可按创作方式创建作品、出片并同步到当前工作空间。脚本页与风格母版已从产品主轴下线。

  1. 签发 Agent 密钥

    前往巨人肩膀工作空间设置,在 Agent API Key 中点击「签发密钥」,复制明文密钥(仅显示一次)。

    密钥格式一般为 bigapp_...,请妥善保存明文密钥。

  2. 配置 MCP

    将 BIGAPP_API_KEY 换成你的密钥后写入 MCP 配置;推荐用 npx 拉取 yingjing-mcp,无需本地构建。需 Node.js 18+。

    已有 MCP 选 ,首次用 后粘贴到 .cursor/mcp.json 或 Cursor Settings → MCP。

    {
      "mcpServers": {
        "yingjing": {
          "command": "npx",
          "args": [
            "-y",
            "yingjing-mcp"
          ],
          "env": {
            "BIGAPP_API_KEY": "粘贴你在工作空间签发的密钥"
          }
        }
      }
    }
  3. 验证并创建作品

    重载 MCP 后先让智能体调用 whoami,再 createProject(须指定 creationMode);可用下方提示词一键交给智能体。

    连通性测试
    请调用影境 MCP 工具 whoami,测试影境是否已连通。
    
    【必须执行】
    1. 使用 MCP 工具 whoami(不要猜测或模拟返回)
    2. 调用成功后告诉我:creatorUserId、工作空间名称
    3. 若失败,把报错信息原样贴出
    创建快速成片作品
    请调用影境 MCP,创建一个快速成片作品。
    
    【必须执行】
    1. 调用 whoami
    2. 调用 createProject:creationMode 必须传 quick;作品名称可用「MCP 接入验证」;ideaText 写一句简短创意
    3. 调用 getProject:确认 creationMode 为 quick,并记下 webUrl
    4. 告诉我作品 id 与可打开的 webUrl
    
    不要调用 getScriptGeneratePrompts、generateStyleSetting 或任何画风 / 脚本工具(这些能力已从产品主轴下线)。
    不要只在聊天里描述,必须真正调用工具。
    一句话出片
    请调用影境 MCP,在刚才的快速成片作品上出一条短视频。
    
    【必须执行】
    1. 调用 estimateBilling:taskType=shot_video,durationSeconds=5,向我确认预估巨豆
    2. 调用 generateQuick:prompt 用一句画面描述(如「户外露营,暖光,商品特写」)
    3. 调用 getTask,每 3–5 秒轮询直到 success 或 failed;失败不要盲重试超过 1 次
    4. 成功后告诉我 outputPublicUrl 与 webUrl
    
    不要只在聊天里描述,必须真正调用工具。

    创建成功后,可在 作品列表 中看到新作品,或打开返回的 webUrl 进入对应工作台。脚本页与风格母版已下线。

工具能力

推荐顺序:whoami → getCapabilities → createProject(须传 creationMode,如 quick)→ getProject 核对 webUrl。出片:estimateBilling → generateQuick → getTask。脚本、画风设定、风格母版已从产品主轴下线。

  • whoami校验密钥,返回签发者与工作空间摘要
  • getCapabilities查询可用创作方式、工具阶段与是否已接计费
  • createProject创建视频作品(名称与 creationMode 必填)
  • listProjects分页列出当前签发者的作品,可按创作方式筛选
  • getProject查询详情(创作方式、webUrl、成片与分镜摘要)
  • updateProject更新名称、描述或标签
  • deleteProject逻辑删除作品
  • estimateBilling预估本次出片巨豆
  • saveQuick写入快速成片 / 编辑 / 模仿 / 换装草稿
  • generateQuick保存并出片,返回任务
  • generateStoryboard按 Idea 拆专业分镜
  • listShots列出各镜摘要(不含完整分镜 JSON)
  • addShot末尾追加一镜(最多 30,可带文案)
  • updateShot增量改一镜文案 / 时长 / 参考
  • deleteShot删除指定镜,不重排剩余镜号
  • generateShotVideo指定镜出视频
  • getTask查询单个任务,建议每 3–5 秒轮询
  • listTasks查询作品近期任务