AnPPT 品牌 Logo
积分 --购买与兑换

Agent 工作台

调用 Agent 生成 PPT

在本页逐页报价、确认后再生成，也可以转可编辑 PPTX。任何消耗和生成都必须你点确认。把本页、/llms.txt 或/api/agent/catalog 发给外部 AI，它会走同一套技能；外部 Agent 只能报价，扣费仍要你在本页点头。

加载工作台…

给外部 Agent 的钥匙

登录后打开 账号 / API Key，生成一把 anppt_live_ 开头的钥匙。只显示一次。

MCP

Cursor / Claude 把下面配进 MCP。tools/call 与 HTTP 技能名相同。生成类工具必须先 propose_job。

{
  "mcpServers": {
    "anppt": {
      "url": "https://ppt.an520.xin/api/agent/mcp",
      "headers": {
        "Authorization": "Bearer anppt_live_YOUR_KEY"
      }
    }
  }
}

HTTP

POST https://ppt.an520.xin/api/agent/skills/{name}，Header Authorization: Bearer …。API Key 只能打 /api/agent/* 与钱包估价，不能当网站会话，也不能直打生图路由。

工作流

逐页图生图（用户确认每一页）

  1. 只拆当页：原文 + 当页全部原图 upload_asset。不要把整份 PPT 的图一次喂进。
  2. 锁画风：用户认可的第一页当风格底；内容页锁顶栏/底栏，中间可换；少字页跟封面完成度。
  3. propose_job skill=generate_page，agentConfirmed=true，summary 写页码、文案要点、原图清单、10🌟。停住。
  4. 用户在网站 /agents 点确认后，带 proposalId 调用 generate_page（同一 projectId）。mode=replicate 时 imagePath=锁图。
  5. get_project 把图给用户看。点头才下一页；失败只重跑当页。禁止一次生成全书。
  6. 全书完成后 propose_job convert_editable（20🌟/页），用户再确认才转可编辑，然后按页 refine_page 微调也要再确认。

一张一张生成（无原稿）

  1. quote_credits action=deck_page_generate pages=1
  2. propose_job → 用户确认 → generate_page（同一 projectId）
  3. get_project 确认图片后再报价下一页
  4. 全书完成后用户确认再 export_image 或 convert_editable

复刻 / 美化别人的 PPT

  1. upload_asset 每页壳图
  2. plan_beautify（免费，不需确认）
  3. 对每一页：propose_job generate_page mode=replicate → 用户确认 → 生成
  4. 全书完成后用户确认再转可编辑

整套文档生成 PPT

  1. create_deck（pages 或 sourceText），outline/structure 免费
  2. run_deck generate-slide 必须先 propose_job，用户确认一页做一页；禁止 action=generate 一次跑完全书
  3. get_deck 等到该页成功
  4. 用户确认后再 convert_editable

技能（元能力）

  • get_wallet

    不单独计价

    读取当前 API Key 所属 AnPPT 账号的星星余额。所有生成/改图/转可编辑都扣这只钱包，没有单独的 Agent 账户。先查余额再开贵操作。

  • quote_credits

    不单独计价

    按官网标准价估算星星，不扣费。action 只能是：deck_page_generate（生图/复刻成图 10🌟/页）、deck_page_refine（改图 5🌟/页）、export_editable（转可编辑 20🌟/页）、export_editable_text（轻量文字档 5🌟/页）、export_image（图片版 PPTX，0）、outline（大纲，0）。pages 为页数。402 之前先 quote。

  • upload_asset

    不单独计价

    把图片或 PDF 存到该用户名下，返回 path。后续 generate_page.imagePath、plan_beautify.imagePaths、create_deck 的文件都用这个 path。MCP 传 name/mime/base64；不要传外链。单文件 ≤30MB，每用户每小时最多 60 次。

  • generate_page

    10🌟 · 需确认

    在 AnPPT 服务器生成一张 16:9 幻灯片图，扣 10🌟，失败退星。禁止直接调用。必须：① propose_job（skill=generate_page，agentConfirmed=true，summary 写清这一页文案/原图/星星）② 等用户在网站 /agents 点确认 ③ 再带 proposalId 调用本技能。一页一轮，用户点头才翻下一页。普通页：title+content，可带 stylePackId。复刻：mode=replicate 且 imagePath=已锁定的壳/风格图，content=当页大纲。同一套 PPT 复用 projectId。不要把整份 PPT 的图一次喂进；只要当页原图。不要在本地画 PPT。

  • refine_page

    5🌟 · 需确认

    对已生成页做图生图修改，扣 5🌟/次，失败退星。禁止直接调用：先 propose_job，等用户确认后再带 proposalId。editInstruction 用中文写清改什么、什么保持不变。需要已有 pageId。

  • get_project

    不单独计价

    读取单页/美化项目的页面、状态、图片 URL。generate_page 后用它核对 status 与 imageUrl。

  • plan_beautify

    不单独计价

    PPT 美化元能力的规划步：按壳页图+主题/材料，拆出与页数一致的新文案（免费 LLM，不扣星）。先 upload_asset 得到 imagePaths，再对本工具。返回的 slides[].title/content 再逐页交给 generate_page（mode=replicate，同一 imagePath）。不要把复刻走成普通文生图。

  • create_deck

    不单独计价

    在网站上建一套 deck（不是本地文件）。有现成逐页文案时传 pages[{title,rawText}]，状态直接 outlined。只有长文档时传 sourceText+targetPageCount（1–40），状态 parsed，接着 run_deck outline。stylePackId 可选。解析/大纲不扣星。

  • run_deck

    10🌟 · 需确认

    对已有 deckId 执行工作台动作。免费：outline / structure / confirm-structure。生成必须一页一轮：只允许 generate-slide / refine-slide 等单页动作，且必须先 propose_job 再等用户确认。禁止 action=generate 或 retry-failed 一次跑完全书。生成 10🌟/页，改图 5🌟，失败退星。

  • get_deck

    不单独计价

    读取 deck 状态、每页 genStatus/imageUrl、活跃 job。generating 时隔几秒再拉，不要重复 generate。

  • export_image

    0🌟 · 需确认

    把已生成页打成 16:9 整页图片 PPTX，免费但仍算生成，必须先 propose_job 再等用户确认。deck 传 deckId；单页/美化项目传 projectId。没有成功页会 409。

  • convert_editable

    20🌟 · 需确认

    把页图交给网站转成元素级可编辑 PPTX，20🌟/页，失败退星。禁止直接调用：先 propose_job，等用户在 /agents 确认后再带 proposalId。只接受已生成项目的 deckId 或 projectId；不要把 PDF/图片 base64 放进确认单（文件转换请用网站「文件转可编辑」）。页数由服务器按实页计价，不能少报。返回 exportId 后 get_export 轮询。不要反复 force。

  • propose_job

    不单独计价

    任何消耗或生成的第一步。Agent 先 quote，再本工具：skill=要执行的技能名，args=稍后真正调用时的参数，summary=给人看的一句话（页码、文案要点、扣多少星），agentConfirmed=true 表示你已核对。不扣费。转可编辑的页数由服务器按项目实页计算，不能少报。返回 proposalId 与 credits。然后停下来，让用户打开网站 /agents 点确认（API Key 不能代替用户）。用户确认前禁止 generate_page / convert_editable。一页一轮。

  • list_jobs

    不单独计价

    列出该账号尚未完成的确认单。pending_user=等用户点头；ready=用户已确认，可以带 proposalId 执行。外部 Agent 应轮询本工具，不要催用户以外的渠道扣费。

  • confirm_job

    不单独计价

    只有网站登录用户（Cookie）能调用。API Key / MCP 调用会 403。用户在 /agents 点确认时走这里。需要 proposalId 且 userConfirmed=true。

  • cancel_job

    不单独计价

    取消尚未执行的确认单。已消耗的不能取消。

  • get_export

    不单独计价

    按 exportId 读取转可编辑/图片版导出进度与下载 url。processing 就轮询，不要重开转换。