APIMODELSAPIMODELS
实测 Cursor 3.24 · 远程 MCP · 浏览器一键授权

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

apimodels 是一个远程 MCP 服务器:加进 Cursor 之后,Cursor 的 Agent 就能直接调用 apimodels 上的图片、视频和语音模型。只要加一个地址、在浏览器里点一次「授权」,不用装 Node.js,也不用复制 API key。下面每一步都配了实际截图。

一句话版

把 https://api.apimodels.app/mcp 加进 Cursor 的 MCP 服务器(下面的按钮,或 ~/.cursor/mcp.json 里写一行 url),在 Customize → MCPs 里点 Authenticate,浏览器里登录 apimodels.app 点「授权」,看到 Connected · 9 tools enabled 就能用了。

这一页只管「让 Cursor 的 Agent 能生成图片和视频」,不改变 Cursor 自己用哪个聊天模型。想让 Cursor 的对话模型也走 apimodels,见 /docs/clients。

1把 apimodels 加进 Cursor

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

方法 A:一键安装

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

添加到 Cursor
Cursor 的「Install MCP server?」确认框:Name 为 apimodels,Type 为 Remote HTTPS,Server URL 已填好,点 Install
Cursor 的「Install MCP server?」确认框:Name 为 apimodels,Type 为 Remote HTTPS,Server URL 已填好,点 Install

方法 B:写配置文件

打开(没有就新建)~/.cursor/mcp.json,Windows 上是 C:\Users\你的用户名\.cursor\mcp.json。已经有其它服务器的话,把 apimodels 这一项加进 mcpServers 里即可。保存后 Cursor 会自动重新读取,不用重启。

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

只想在某个项目里用,就把同样的内容写进项目根目录的 .cursor/mcp.json。

2点 Authenticate

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

Customize → MCPs 里的 apimodels:Needs authentication,右侧是 Authenticate
Customize → MCPs 里的 apimodels:Needs authentication,右侧是 Authenticate

3在 apimodels.app 点「授权」

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

apimodels.app 的授权页:Cursor 请求使用你的 apimodels 账号生成图片、视频和语音
apimodels.app 的授权页:Cursor 请求使用你的 apimodels 账号生成图片、视频和语音

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

4确认已连接

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

apimodels 已连接:Connected,9 tools enabled
apimodels 已连接:Connected,9 tools enabled
工具做什么计费
generate_image文生图、改图(带参考图),返回图片链接和一张 Agent 能看的预览按张
generate_video文生视频、图生视频(首帧),做完返回视频链接,没做完返回任务号按条 / 按秒
get_task接着取还在跑的任务,直到拿到链接不收费
text_to_speech配音 / 旁白按文本长度
review_image让视觉模型对照要求检查一张图,指出问题并给出改好的提示词每次远低于 $0.01
get_upload_url给一个 15 分钟有效的上传链接,把本机文件传上来当参考图不收费
get_balance查余额(美元)不收费
list_models列出当前可用的模型 id不收费
chat调用站上其它聊天模型按 token

5在 Agent 里直接提需求

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

出一张图

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

让 Agent 规划并生成一段多镜头视频

给一个陶瓷咖啡杯做一条 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

Cursor 的报错提示:Could not connect to MCP server "apimodels": Server did not respond within 30 seconds
Cursor 的报错提示:Could not connect to MCP server "apimodels": Server did not respond within 30 seconds

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

# 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 按钮不见了

授权失败后 apimodels 显示 Error - Show Output,没有 Authenticate 按钮
授权失败后 apimodels 显示 Error - Show Output,没有 Authenticate 按钮

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

症状原因 / 修法
之前能用,突然所有工具都报未授权Cursor 用的那把「MCP · Cursor · 日期」key 被删除或停用了。按上一条删掉再加回 apimodels,重新授权一次。
Agent 说没有 apimodels 工具先看 Customize → MCPs 里 apimodels 是否在 Connected 下且是开启状态;再确认是在 Agent 对话里提的需求。提问时点名 apimodels 也有帮助。
HTTP 402余额不足。到 控制台 → 余额 充值后重试,失败的生成不扣费。
本机文件路径被拒绝托管服务器读不到本机文件,这是预期行为。让 Agent 用 get_upload_url 先上传(它通常会自己这么做)。

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

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

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

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

常见问题

怎么把 apimodels 加进 Cursor?

把 https://api.apimodels.app/mcp 加成 MCP 服务器:点本页的「添加到 Cursor」按钮,或在 ~/.cursor/mcp.json 里写 {"mcpServers": {"apimodels": {"url": "https://api.apimodels.app/mcp"}}}。然后打开 Customize → MCPs,点 apimodels 旁边的 Authenticate,登录 apimodels.app 点「授权」。显示 Connected、9 tools enabled 就好了。

在 Cursor 里用 apimodels 需要装 Node.js 或填 API key 吗?

不需要。托管服务器跑在 apimodels 那边,授权时会自动为 Cursor 新建一把名为「MCP · Cursor · 日期」的专用 key,你什么都不用复制,只要有一个有余额的 apimodels 账号。只有改用本地版(能直接读本机文件)时才需要 Node.js。

Cursor 授权时提示 Server did not respond within 30 seconds 怎么办?

几乎都是本机 8787 端口被别的程序占了。Cursor 固定在 8787 等待授权跳回,这个端口在 Cursor 里改不了;wrangler dev 默认就用 8787。用 lsof -nP -iTCP:8787 -sTCP:LISTEN(macOS / Linux)或 netstat -ano | findstr :8787(Windows)找到它,关掉或换端口,然后在 ~/.cursor/mcp.json 里删掉 apimodels 再加回去,重新点 Authenticate。

怎么计费?怎么断开 Cursor?

每次生成按该模型页上的价格从 apimodels 余额扣费,失败不扣费;查余额、列模型、取进行中的任务不收费。要断开,到控制台 → API Keys 删掉「MCP · Cursor · 日期」那把 key 即可。

Cursor 能用我电脑上的图片当参考图吗?

能。托管服务器读不到你的文件,Agent 会先调 get_upload_url,在终端里用 curl 把文件传上来,再把返回的链接交给 generate_image 或 generate_video。Cursor 问你是否运行这条上传命令时同意即可。