MCP 接入指南
通过 MCP 把 AI Agent 接入 ToAPIs，调用 200+ 模型生成图片和视频。
通过 MCP 把 ToAPIs 接入你常用的 Agent。浏览器登录授权，无需复制 API Key；Agent 会帮你挑选模型、读取参数、提交任务并取回结果。
请按账号和余额所属站点选择地址。下方示例使用国际站；toapis.cn 账号请将 https://api.toapis.com/mcp 替换为 https://api.toapis.cn/mcp，并使用 toapis.cn 控制台。两站账号和余额不互通。
| 站点 | MCP endpoint |
|---|---|
| 国际站 | https://api.toapis.com/mcp |
| 国内站 | https://api.toapis.cn/mcp |
接入前准备
客户端需要支持远程 MCP 的 Streamable HTTP 传输。ToAPIs skills 可帮助选择模型和编写提示词，属于可选安装；npx skills add 命令需要 Node.js，跳过 skills 安装仍可使用 MCP。
浏览器授权时，登录对应的 ToAPIs 站点，核对客户端名称，选择一个 API Key 或新建有额度限制的专用 Key，再点击允许。使用请求头鉴权时，先在 API 令牌 页面创建专用 Key，在本地替换 <API_KEY>。不要把真实密钥发到对话或提交到版本库。
选择你的客户端，几步完成连接
确认连接成功
新开一个对话，发送下面这句话。能看到余额就说明已经连好（查询免费）。如果提示需要登录、鉴权失败或找不到 ToAPIs 工具，回到上面的步骤检查配置。
我的 ToAPIs 还剩多少额度？今天花了多少？连接后可以做什么
用自然语言描述需求，Agent 会选择模型，按文档准备参数，提交并跟进任务。
生成图片
文生图、参考图编辑，可指定比例和数量。
用 ToAPIs 生成一张 16:9 的海边灯塔日出图生成视频
文生视频、图生视频，默认推荐 Seedance。
把这张产品图做成 5 秒的竖版宣传视频使用本地素材
直接给出本地图片路径，Agent 上传后作为参考图使用。
参考 ./product.png，把产品放到白色背景上Agent 会先读取模型参数文档，通过 create_upload 上传本地参考素材，再用 get_generation 跟进生成状态。任务运行中请等待结果，避免重复提交。如果提交响应丢失，重试时应复用原来的 client_request_id，换一个 ID 可能创建新的计费任务。状态为 unknown 时，先到控制台任务列表核对。请保存返回的结果链接，客户端也可以将结果下载到本地。
可用工具
| 工具 | 用途 |
|---|---|
list_models | 列出当前 Key 可用的图片和视频模型，包含价格与 docs_available。 |
get_model_docs | 生成前读取模型参数文档，请选择 docs_available: true 的模型。 |
generate_image | 生成图片，按模型计费。 |
generate_video | 生成视频，按模型计费。 |
get_generation | 通过 client_request_id 查询 MCP 生成进度与结果。 |
get_task | 通过 task_id 查询图片或视频任务。 |
create_upload | 为本地图片、视频或音频创建一次性上传地址。 |
get_balance | 查询 Key 额度和账户余额。 |
list_tasks | 列出当前 Key 的近期任务。 |
get_usage | 汇总当前 Key 指定时间范围的扣费，最多 31 天，不扣除退款。 |