Model Context Protocol

在你的 AI Agent 里用 ToAPIs 生成图片和视频

通过 MCP 把 ToAPIs 接入你常用的 Agent。浏览器登录授权，无需复制 API Key；Agent 会帮你挑选模型、读取参数、提交任务并取回结果。

200+ 模型
浏览器授权
专用 Key 额度可控
与 API 同价

开始连接查看可用模型

Connect

选择你的客户端，几步完成连接

MCP 地址

https://api.toapis.com/mcp

复制提示词发给 Claude Code

Claude Code 会在运行每条命令前询问，点允许即可。

帮我把 ToAPIs 接入 Claude Code，用来生成图片和视频。
1. 安装 ToAPIs Skill：`npx skills add toapis/skills -g --agent claude-code -y`。如果找不到 npx，先按当前系统的标准方式安装 Node.js LTS（自带 npx）；装好后仍找不到 npx 时，用 Node.js 安装目录里的完整路径运行。如果无法安装（例如需要管理员密码或被拦截），跳过这一步继续，最后提醒我装好 Node.js 后再补装。
2. 添加 ToAPIs MCP 服务：`claude mcp add --transport http --scope user toapis https://api.toapis.com/mcp --header "X-Locale: zh"`
3. 提醒我输入 /mcp，选择 toapis，在浏览器中完成授权（列表里没有 toapis 时先重启 Claude Code）。等我告诉你完成后，运行 `claude mcp list` 确认 toapis 显示已连接（Connected）；如果没有，告诉我它显示的状态，并帮我判断问题。

2
在 /mcp 中授权
在 Claude Code 中输入 /mcp，选择 toapis，按提示在浏览器登录并允许。列表里没有 toapis 时，先重启 Claude Code。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

1
添加到 Claude
打开 Claude 的“添加自定义连接器”，名称和地址已经填好。
添加到 Claude
2
连接并授权
点 Add，再点 Connect，在 ToAPIs 授权页登录，选择 Key 并允许。
Claude 从 Anthropic 的服务器访问 ToAPIs，不要选设置了 IP 白名单的 Key。免费版只能添加 1 个自定义连接器。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

手动添加

打开设置 → 连接器，添加自定义连接器。名称填 ToAPIs，URL 填下面的地址，OAuth Client ID 和 Secret 留空。

https://api.toapis.com/mcp

切换到完全访问

Codex 默认不允许 Agent 修改工作区以外的配置。在对话框下方把权限模式切到 Full access（完全访问），配置完成后再切回。

Codex CLI 和桌面版共用一份配置，设置一次两边都能用。

复制提示词发给 Codex

帮我把 ToAPIs 接入 Codex，用来生成图片和视频。
1. 安装 ToAPIs Skill：`npx skills add toapis/skills -g --agent codex -y`。如果找不到 npx，先按当前系统的标准方式安装 Node.js LTS（自带 npx）；装好后仍找不到 npx 时，用 Node.js 安装目录里的完整路径运行。如果无法安装（例如需要管理员密码或被拦截），跳过这一步继续，最后提醒我装好 Node.js 后再补装。
2. 添加 ToAPIs MCP 服务：`codex mcp add toapis --url https://api.toapis.com/mcp`。新版 Codex 添加后会自动打开浏览器授权，并等授权完成才结束：提醒我在浏览器里登录并点允许，然后等这条命令结束。
3. 确认登录：运行 `codex mcp list`，toapis 的 Auth 一栏显示 OAuth 就是成功。如果显示 Not logged in，运行 `codex mcp login toapis`，同样提醒我在浏览器完成授权，等命令结束后再检查一次。如果命令在我完成授权前就超时结束，等我告诉你完成后再运行 `codex mcp list` 检查。
如果某条命令因为要写工作区以外的位置被拦截，停下来告诉我。
最后告诉我结果：成功就提醒我新开一个对话来使用；失败就说明卡在哪一步。

2
在浏览器中授权
Codex 会打开 ToAPIs 授权页：登录后核对客户端名称，选择一个 Key 或新建一个设好额度上限的专用 Key，然后点“允许”。桌面版也可以在设置 → MCP servers 中点 toapis 旁边的 Authenticate。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

不想切换权限？在终端自己运行这几条命令

npx skills add toapis/skills -g --agent codex -y
codex mcp add toapis --url https://api.toapis.com/mcp
codex mcp list
# 如果 toapis 的 Auth 一栏显示 Not logged in，再运行：codex mcp login toapis

1
添加 ToAPIs
点下面的按钮并在 Cursor 中确认，或把下面的配置粘贴到 ~/.cursor/mcp.json。
添加到 Cursor
2
登录授权
在 Cursor 的 MCP 设置里，点 toapis 旁边的 Connect，在浏览器登录 ToAPIs，选择 Key 并允许。
3
安装 Skill（推荐）
让 Agent 更会挑模型、写提示词（需要 Node.js，不装也不影响使用 MCP）：
```
npx skills add toapis/skills -g --agent cursor -y
```
4
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
5
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

手动配置 mcp.json

{
  "mcpServers": {
    "toapis": {
      "url": "https://api.toapis.com/mcp",
      "headers": {
        "X-Locale": "zh"
      }
    }
  }
}

1
添加 ToAPIs
Devin Desktop 和 Devin CLI 共用一份配置。在终端运行下面的命令，或让 Devin 帮你运行：
```
devin mcp add -s user toapis https://api.toapis.com/mcp
devin mcp login toapis
```
2
在浏览器中授权
devin mcp login toapis 会打开浏览器：登录 ToAPIs，选择 Key 并允许。不运行这条命令时，Devin 首次使用 toapis 也会提示登录。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

1
添加到 MCP 配置
Antigravity App、IDE 和 CLI 共用 ~/.gemini/config/mcp_config.json。把下面的配置合并进去并保存，然后在 CLI 输入 /mcp 或在设置中重新加载。
```
{
  "mcpServers": {
    "toapis": {
      "serverUrl": "https://api.toapis.com/mcp",
      "headers": {
        "X-Locale": "zh"
      }
    }
  }
}
```
2
授权并粘贴授权码
按 Cmd + ,（Windows 为 Ctrl + ,）打开 Antigravity 设置，进入 Customizations，点 toapis 旁边的 Authenticate。在浏览器登录 ToAPIs 并允许后，页面会显示授权码，把它粘贴回设置面板并点 Submit。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

1
新建一个专用 Key
这个客户端只支持在请求头里填 Key。在 ToAPIs 控制台新建一个 Key，建议设好额度上限，复制备用；下面配置里的 <API_KEY> 要换成这个 Key。
打开 API 令牌
2
新建自定义插件
打开豆包电脑版，点击左侧“插件·技能·伙伴”，在“插件”页面右上角点“+ 添加”，选择“新建自定义插件”。服务器名称填 ToAPIs，传输类型选 HTTP，服务器 URL 填下面的地址。
```
https://api.toapis.com/mcp
```
3
填写鉴权并保存
在“自定义 Headers”区域点“+ 添加”，请求头名称填 Authorization，值填下面这行（把 <API_KEY> 换成你的 Key），然后点“保存”。
```
Bearer <API_KEY>
```
请在豆包电脑版（Windows 或 macOS）中添加。企业账号能否使用自定义插件，以管理员的设置为准。
4
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
5
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

1
新建一个专用 Key
这个客户端只支持在请求头里填 Key。在 ToAPIs 控制台新建一个 Key，建议设好额度上限，复制备用；下面配置里的 <API_KEY> 要换成这个 Key。
打开 API 令牌
2
粘贴 JSON 配置
在千问办公左侧打开“扩展”→“连接器”，点右上角“+ 添加”→“粘贴 JSON 配置”，粘贴下面的配置（把 <API_KEY> 换成你的 Key），然后点“导入”。
```
{
  "mcpServers": {
    "toapis": {
      "type": "streamable-http",
      "url": "https://api.toapis.com/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "X-Locale": "zh"
      }
    }
  }
}
```
3
打开连接器
连接器默认是关闭的：在连接器列表里打开 toapis，然后新建一个对话任务才会生效，原来的对话里用不了。
4
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
5
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

在终端运行

第一条安装 ToAPIs Skill（需要 Node.js，不装也不影响使用 MCP），第二条添加 ToAPIs MCP 服务：

npx skills add toapis/skills -g --agent qwen-code -y
qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "X-Locale: zh"

2
在浏览器中授权
运行 qwen 启动 Qwen Code，连接 ToAPIs 时会打开浏览器授权页：登录后选择 Key 并允许。在 Qwen Code 中输入 /mcp 可以查看 toapis 的连接和授权状态。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

浏览器授权用不了？改用 API Key

在控制台“API 令牌”中新建一个 Key，把下面命令里的 <API_KEY> 换成这个 Key 后运行。

qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "Authorization: Bearer <API_KEY>" --header "X-Locale: zh"

1
新建一个专用 Key
这个客户端只支持在请求头里填 Key。在 ToAPIs 控制台新建一个 Key，建议设好额度上限，复制备用；下面配置里的 <API_KEY> 要换成这个 Key。
打开 API 令牌
2
手动添加 MCP Server
在 Trae 中打开“设置”>“MCP”，在“MCP Servers 管理”右上角点“添加”>“手动添加”，粘贴下面的配置（把 <API_KEY> 换成你的 Key），然后点“确认”。
```
{
  "mcpServers": {
    "toapis": {
      "url": "https://api.toapis.com/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "X-Locale": "zh"
      }
    }
  }
}
```
3
安装 Skill（推荐）
让 Agent 更会挑模型、写提示词（需要 Node.js，不装也不影响使用 MCP）：
```
npx skills add toapis/skills -g --agent trae-cn -y
```
4
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
5
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

1
添加自定义连接器
在 WorkBuddy 左侧栏打开“专家·技能·连接器”，选择“连接器”页签，点右上角“自定义连接器”，在弹窗中点“添加 MCP”，再粘贴下面的配置并保存。
```
{
  "mcpServers": {
    "toapis": {
      "type": "http",
      "url": "https://api.toapis.com/mcp"
    }
  }
}
```
2
连接并授权
点击“信任”，然后在浏览器打开的 ToAPIs 授权页登录，选择 Key 并允许；登录完成后回到 WorkBuddy 点击“连接”。
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

1
添加远程 MCP 服务
在客户端中添加一个远程 MCP 服务（Streamable HTTP），地址填下面的 URL，鉴权方式选 OAuth，Client ID 和 Secret 留空。
```
https://api.toapis.com/mcp
```
2
不支持浏览器登录？
部分客户端只支持请求头鉴权，或无法完成浏览器授权。可以在控制台创建专用 Key，用 Authorization: Bearer 请求头连接。
查看 API Key 接入文档
3
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
```
我的 ToAPIs 还剩多少额度？今天花了多少？
```
4
开始创作
直接描述想要的图片或视频，例如：
```
用 ToAPIs 生成一张 16:9 的海边灯塔日出图
```

Capabilities

连接后可以做什么

用自然语言描述需求，Agent 会选择模型，按文档准备参数，提交并跟进任务。

生成图片

文生图、参考图编辑，可指定比例和数量。

用 ToAPIs 生成一张 16:9 的海边灯塔日出图

工具: generate_image

生成视频

文生视频、图生视频，默认推荐 Seedance。

把这张产品图做成 5 秒的竖版宣传视频

工具: generate_video

使用本地素材

直接给出本地图片路径，Agent 上传后作为参考图使用。

参考 ./product.png，把产品放到白色背景上

工具: create_upload

查询账户

余额、最近任务、失败原因，以及今天花了多少。

我的 ToAPIs 还剩多少额度？今天花了多少？

工具: get_balance / get_usage

Why MCP

无需复制 API Key

浏览器登录授权，连接绑定你选择的 Key，Key 不会出现在 Agent 的配置和对话里。

额度可控

为连接新建专用 Key 并设置额度上限，随时可以在控制台“已连接应用”中断开。

与 API 同价

按现有额度和模型价格计费，失败任务按规则退款。

一次连接，全部模型

GPT Image、Nano Banana、Seedance、Kling 等 200+ 模型，新模型上线即可使用。

常见问题

精选高频问题，点击问题即可展开答案。问题较多时可点击下方按钮切换显示。

不需要手动复制。授权时在 ToAPIs 页面选择一个已有的 Key，或新建一个专用 Key，Agent 通过授权令牌使用它。只支持请求头鉴权的客户端可以改用 API Key 方式连接。

和直接调用 API 一样，按模型价格从所选 Key 和账户额度中扣除。查询模型、余额和任务都免费，只有生成图片和视频会扣费。

安装 Skill 和添加 MCP 服务需要写入你电脑上的 Codex 配置，默认权限模式不允许 Agent 修改工作区以外的文件。只在配置这一次需要，完成后可以切回；也可以在终端自己运行这几条命令。

在控制台“已连接应用”中断开：会撤销授权，并停用为这个连接新建的专用 Key（仍被其他连接使用时除外）。在客户端中删除 toapis（例如 codex mcp remove toapis）只会删除本机配置。

两个站的账号和额度相互独立。toapis.com 的账号使用 api.toapis.com/mcp，toapis.cn 的账号使用 api.toapis.cn/mcp；在另一个站登录会提示站点不匹配。

大多数支持远程 MCP 和 OAuth 的桌面或命令行客户端，都可以按“其他客户端”的方式连接；如果授权失败，可以改用 API Key 连接。我们会陆续补充更多客户端的步骤。

把 ToAPIs 接入你的 Agent

注册即可开始，连接后直接在对话里生成图片和视频。

开始连接免费注册

在你的 AI Agent 里用 ToAPIs 生成图片和视频

选择你的客户端，几步完成连接

复制提示词发给 Claude Code

在 /mcp 中授权

确认连接成功

开始创作

添加到 Claude

连接并授权

确认连接成功

开始创作

复制提示词发给 Codex

在浏览器中授权

确认连接成功

开始创作

添加 ToAPIs

登录授权

安装 Skill（推荐）

确认连接成功

开始创作

添加 ToAPIs

在浏览器中授权

确认连接成功

开始创作

添加到 MCP 配置

授权并粘贴授权码

确认连接成功

开始创作

新建一个专用 Key

新建自定义插件

填写鉴权并保存

确认连接成功

开始创作

新建一个专用 Key

粘贴 JSON 配置

打开连接器

确认连接成功

开始创作

在终端运行

在浏览器中授权

确认连接成功

开始创作

新建一个专用 Key

手动添加 MCP Server

安装 Skill（推荐）

确认连接成功

开始创作

添加自定义连接器

连接并授权

确认连接成功

开始创作

添加远程 MCP 服务

不支持浏览器登录？

确认连接成功

开始创作

连接后可以做什么

生成图片

生成视频

使用本地素材

查询账户

无需复制 API Key

额度可控

与 API 同价

一次连接，全部模型

常见问题

需要 API Key 吗？

怎么计费？

Codex 为什么要切换到完全访问？

怎么断开连接？

国际站和国内站有什么区别？

还支持哪些客户端？

把 ToAPIs 接入你的 Agent