APIMart MCP
official一个 APIKey 使用全球所有模型
What can you do with APIMart MCP?
- Discover available models — Ask your assistant to list image and video models available through APIMart, with names and versions.
- Understand model parameters — Have your assistant read model documentation to explain input parameters, usage limits, and calling conventions.
- Generate images — Ask your assistant to select a suitable model, prepare parameters, submit an image generation task, and return the result file.
- Generate videos — Ask your assistant to submit a video generation task and monitor its progress and final status.
- Configure API key securely — Ask your assistant to guide you through setting the APIMart API key as an environment variable, avoiding exposure in commands or chat.
Hosted MCP Server
npx add-mcp 'https://mcp.apimart.ai/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
agent — APIMart task模拟演示
“帮我找到适合产品主图的模型,生成一张香水广告图,并告诉我任务结果。”
- 01 理解需求 识别图像生成任务
- 02 选择模型 对比能力与参数
- 03 提交任务 调用 APIMart API
- 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。
终端命令
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 文档无需安装,可直接复制提示词。