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 文档无需安装，可直接复制提示词。