在 Cursor 里用 apimodels 生成图片和视频

1把 apimodels 加进 Cursor

两种方法,效果一样,任选其一。

方法 A:一键安装

装好 Cursor 后点下面的按钮,浏览器会问是否打开 Cursor,允许即可。Cursor 弹出确认框,名字和地址都已填好,点 Install。

添加到 Cursor

{
  "mcpServers": {
    "apimodels": {
      "url": "https://api.apimodels.app/mcp"
    }
  }
}

2点 Authenticate

在 Cursor 左侧栏打开 Customize,切到 MCPs(编辑器窗口里是 Cursor Settings → Tools & MCPs)。apimodels 会出现在 Needs Attention 里,状态是 Needs authentication,点右边的 Authenticate,Cursor 会打开浏览器。

3在 apimodels.app 点「授权」

浏览器打开 apimodels.app 的授权页(没登录会先让你登录)。确认上面写的是 Cursor,点「授权」。浏览器会跳回本机的 localhost:8787,Cursor 就收到了授权,回到 Cursor 即可。

授权会为 Cursor 新建一把专用 API key,名字是「MCP · Cursor · 日期」,生成按正常价格从你的余额扣费。哪天不想让 Cursor 用了,到 控制台 → API Keys 删掉这把 key 即可。

4确认已连接

回到 Customize → MCPs,apimodels 移到了 Connected 下,显示 9 tools enabled,绿点表示在线。

5在 Agent 里直接提需求

新开一个 Agent 对话,用大白话说要什么。第一次可以点名 apimodels,Agent 就知道该用这组工具;Cursor 调用工具前如果请你确认,点运行即可。

用 apimodels 生成一张 16:9 的图片:一只金棕色虎斑矮脚猫
坐在洒满晨光的窗台上。保存到 assets/cat.png。

给一个陶瓷咖啡杯做一条 15 秒、3 个镜头的产品预告片。
先用 apimodels 给每个镜头出一张 16:9 的关键帧给我看,
确认后用 generate_video 把每张做成 5 秒的片段,下载到 assets/。

视频要等一会儿:中位约 2.5 分钟,九成在 8 分钟内。每次工具调用最多等 50 秒,没出来就交回任务号,Agent 会自己调 get_task 接着取,不会重复提交,也不会重复扣费。结果文件 30 天后删除,让 Agent 当场下载到项目里(上面的例子已经写了)。

想用电脑上的图片当参考图或首帧:托管服务器读不到你的本机文件,Agent 会先调 get_upload_url,在终端里用 curl 把文件传上来,再用返回的链接生成。你只需要在 Cursor 问是否运行这条命令时同意。

排错

授权一直不成功,提示 Server did not respond within 30 seconds

最常见的原因是本机 8787 端口被别的程序占了。Cursor 固定在 8787 端口接收浏览器跳回来的授权,这个端口改不了;它被占用时,你在网页上点了「授权」,Cursor 也收不到,等 30 秒后报这个错。Cloudflare 的 wrangler dev 默认就用 8787,开着它的话最容易撞上。先查是谁占着:

Copy

# macOS / Linux: who is listening on 8787?
lsof -nP -iTCP:8787 -sTCP:LISTEN

# Windows (PowerShell or cmd): find the PID, then the program
netstat -ano | findstr :8787
tasklist /FI "PID eq <PID>"

关掉那个程序,或让它换个端口(wrangler 用 wrangler dev --port 8788),然后按下一条重新授权。授权完成后它可以再用回 8787,只有授权那一下需要这个端口。

授权失败一次后,Authenticate 按钮不见了

Cursor 会把这个服务器停在出错状态,不再显示 Authenticate。让它重来一遍:打开 ~/.cursor/mcp.json,删掉 apimodels 这一项并保存,再把它加回去并保存(或者删掉后重新点上面的「添加到 Cursor」)。apimodels 会回到 Needs authentication,再点 Authenticate 即可。

想让服务器跑在自己电脑上

本地版能直接读本机文件、一次调用可以等完整个视频,但需要装 Node.js。先在终端运行 npx -y apimodels-mcp login,在浏览器里点「授权」,再把 mcp.json 里的 apimodels 换成下面这段。两种只留一个,别同时开。

{
  "mcpServers": {
    "apimodels": {
      "command": "npx",
      "args": ["-y", "apimodels-mcp"]
    }
  }
}

环境变量、等待时间等全部参数见 /docs/mcp。