Auto Story

首页›在智能体里调用这些能力

在智能体里调用这些能力

两种形态,同一套能力、同一个余额:

MCP Server:在支持 MCP 的智能体产品里加一段服务器配置,指向 https://autostory.cn/mcp,配上 API Key。之后智能体就能自己列出能力目录、提交任务、轮询进度并把成片链接带回对话里。

Agent Skill:一份 SKILL.md 说明书,交给支持 Skills 的宿主,教它按正确的顺序调用开放平台接口。适合想自己控制调用编排的场景。

两种方式扣的都是账户余额,计费口径与网页端完全一致,失败不计费。智能体拿不到也不需要拿到内部提示词模板:它给一句需求,服务端出成品。

方式一:MCP Server(推荐)

在支持 MCP 的智能体产品里加一段服务器配置,只填一个地址:https://autostory.cn/mcp,不用填任何密钥。第一次连接时宿主会读到我们的授权说明,自动打开浏览器;你在登录态里点一次「同意授权」,宿主就拿到的是一把只能提交与查询任务、每月限量、30 天后自动失效的短时效令牌,到期它自己续,续不上就再弹一次浏览器。各家宿主的字段名略有差异,把下面这段里的 url 填进它要求的位置即可。

{
  "mcpServers": {
    "autostory": {
      "type": "streamable-http",
      "url": "https://autostory.cn/mcp"
    }
  }
}

为什么不该把手工复制的 Key 当默认接法:复制出来的长期明文会留在宿主配置文件里,被截图、被同步、被贴进群;而且大多数人建 Key 时直接勾全权限、限额留空,等于给智能体发了一把全站万能钥匙。网页授权把这两件事一次性收回来——令牌的形状由服务端定,页面改不了,控制台里随时能吊销(名字以 oauth: 开头的就是这一类)。

提供四件通用工具:autostory_capabilities(能力目录)、autostory_pricing(计费口径)、autostory_submit(提交任务)、autostory_task(查状态与产物);每项能力另有一张专用表单 autostory_submit_<能力名>,模型与选择类参数是下拉、默认值已预填。查询到成功时,图片与音频直接作为内容块返回,视频与文稿给资源链接。工具参数的契约与能力清单同源,服务端加一条能力,工具列表跟着多一条。

宿主要是不支持网页授权(有些老版本只会让你手填 headers),再走这一版:先在一键授权里建一把受限 Key,把明文填进配置的 Authorization 里。想自己挑权限与限额就去控制台「API Key」新建。

{
  "mcpServers": {
    "autostory": {
      "type": "streamable-http",
      "url": "https://autostory.cn/mcp",
      "headers": {
        "Authorization": "Bearer sk-你的APIKey"
      }
    }
  }
}

方式二:Agent Skill

想要自己掌握调用编排,就把 SKILL.md 交给支持 Skills 的宿主:它讲清提交与轮询的用法、每条能力的参数边界与错误语义,鉴权同样使用 API Key。目录接口免 Key 可查,写代码前先读它:GET https://autostory.cn/openapi/v1/capabilities。

计费与额度

智能体的每一次调用都走你的账户余额,与网页端同一条账本:提交时按最低档预扣,跑完按实际用量结算,失败的任务不计费,不会产生欠费任务。余额不足时这次提交不会执行也不会扣钱,回执会直接给出充值地址;从授权页点「现在充值」,充完自动回到同一页接着授权,不用重走一遍。

API Key 怎么建

省事的方式:一键授权——登录态里点一次确认,我们发一把只能提交与查询任务、每月限量、90 天自动失效的 Key,配置片段直接给你粘。

想自己挑权限与限额,就去控制台「API Key」新建,明文只在创建那一次返回;给智能体用的 Key 建议只勾选它确实需要的能力格,并设一个每月上限。

常见问题

需要什么账号?
一个 Auto Story 账户就够了,在控制台创建 API Key 填进配置即可,不需要另外开通应用。
智能体能替我改提示词吗?
它负责把你的需求翻成一次调用;写画面提示词、拆镜、选参数这些由服务端完成,结果不满意时可以让它换一句重跑,重跑的那一条单独计费。
一条视频要等多久?
视频类任务按分钟计,智能体需要轮询;文本与图片类通常十几秒到一分钟。排队中会给出队列位置,不代表失败。
能在手机上用吗?
只要那个智能体产品支持 MCP 或 Skills 并且能访问本站,就能用;产物是带签名的直链,可以直接播放与下载。