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-TW"`
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-TW"
      }
    }
  }
}

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-TW"
      }
    }
  }
}
```
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-TW"
      }
    }
  }
}
```
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-TW"

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-TW"

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-TW"
      }
    }
  }
}
```
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 左側欄開啟「專家·技能·連接器」，選擇「連接器」分頁，點右上角「自訂連接器」，貼上下方設定並儲存。
```
{
  "mcpServers": {
    "toapis": {
      "type": "http",
      "url": "https://api.toapis.com/mcp"
    }
  }
}
```
2
連接並授權
點 Trust 與 Connect，在開啟的 ToAPIs 授權頁登入，選擇 Key 並允許。
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