APIMart MCP

npx add-mcp 'https://mcp.apimart.ai/mcp'

agent — APIMart task 模擬演示

「幫我找到適合產品主圖的模型，生成一張香水廣告圖，並告訴我任務結果。」

1. 01 理解需求 識別圖像生成任務
2. 02 選擇模型 對比能力與參數
3. 03 提交任務 呼叫 APIMart API
4. 04 返回結果 取得狀態與檔案

任務完成示意

Agent 依模型文件準備參數、提交任務並取得結果。此處僅展示流程，不發送請求、不消耗額度。 查看更多對話範例

使用 APIMart MCP 的 list_models 列出 5 個可用模型，不要生成內容。

→ APIMart / list_models
  {"limit": 5}

模型展示名称（示例，非 API 模型 ID）：
01  GPT Image 2.5
02  Nano Banana Pro
03  Seedream 5.0 Pro
04  Z-Image Turbo
05  Midjourney

✓ 示例数据。实际数量与模型 ID 以当前 Key 的返回结果为准。

三種方式，按需接入

依使用習慣選擇文件、遠端工具或本機技能。具體支援的操作取決於對應介面、工具和用戶端。

跟著步驟完成接入

選擇一種方式，跟隨步驟完成配置。命令可直接複製，測試提示詞也已準備好。

APIMart Agent Tools

macOS · zsh · Codex 桌面端 · 生產環境

安全設定 API Key

生產環境可用

先在 APIMart 建立有效 API Key，再在 macOS 的 zsh 終端機中執行下方命令，依提示隱藏輸入 Key。

取得 API Key

終端機命令

read -s "APIMART_API_KEY?APIMart API Key: "
echo
launchctl setenv APIMART_API_KEY "$APIMART_API_KEY"
unset APIMART_API_KEY

真實 Key 僅在終端機提示輸入時貼上。不要把它寫進命令、聊天或截圖；已洩漏的 Key 應作廢後重新建立。

更多說明與適用範圍

此配置用於目前登入工作階段中重新啟動的桌面應用程式。設定完成後徹底退出並重新開啟 Codex 桌面端。若使用終端機版，應在隱藏輸入 Key 後執行 export APIMART_API_KEY，再從同一終端機啟動 Codex；不要執行此處的 unset。下方僅為金鑰格式示意，無需執行或替換。

金鑰格式示意 · 無需執行 sk-••••••••••••••••

怎麼選，取決於你的使用習慣

快速查文件選 AI 文件，日常工具呼叫選 MCP，需要本機腳本與固定流程選 Skill。

接入方式	最適合	安裝與配置	能力執行位置	主要優勢	需要注意	快速開始
AI 文件 llms.txt	臨時查詢、生成呼叫程式碼	無需安裝，複製提示詞	Agent 閱讀文件並執行程式碼	輕量上手，靈活呼叫介面	需要網頁讀取能力，執行程式碼仍需憑證	查看接入步驟
MCP 推薦	高頻互動、日常創作	配置遠端服務與 Key	APIMart 遠端 MCP	結構化工具，無需本機 MCP 套件	依賴網路與用戶端支援，限已提供的工具	查看接入步驟
Agent Skill 本機技能包	固定流程、團隊標準化	透過 GitHub 安裝完整目錄	本機腳本呼叫 APIMart API	流程可重用，獨立於 MCP	需要 Node.js，更新時可能需重新安裝	查看接入步驟

Agent 可以幫你完成什麼

圍繞模型發現、文件理解與常見圖像和影片任務展開。使用前請確認所選模型、工具或本機用戶端支援對應操作。

模型發現

根據任務目標查找可用模型，確認適合目前需求的能力與版本。

參數與文件

讀取輸入參數、使用說明與限制條件，理解模型的呼叫方式。

圖像生成

完成模型選擇、參數準備、任務提交、狀態查詢與結果取得。

影片生成

呼叫影片模型，持續取得任務進度、執行狀態與最終結果。

API Key 不出現在安裝命令裡

透過環境變數傳遞憑證，減少 Key 被終端機歷史、截圖或聊天記錄意外儲存的風險。

• 先讀文件，再配置憑證 AI 文件幫助 Agent 理解介面，不會自動發起模型呼叫。
• 透過環境變數讀取 MCP 與 Skill 從環境變數讀取 Key，不要將 Key 寫進提示詞或安裝命令。
• 先查詢模型驗證連線 實際生成依 APIMart 帳戶規則計費。接入後先用模型查詢驗證配置。

常見問題

選一種方式，開始使用

MCP 與 Skill 獨立可用；AI 文件無需安裝，可直接複製提示詞。