CAP / 01
模型发现
根据任务目标查找可用模型，确认适合当前需求的能力与版本。
AGENT TOOLS / APIMART
让你的 Agent 直接使用 APIMart
选择适合你的接入方式，让 Codex、Claude、Cursor 等 Agent 查找模型、理解参数并执行图像与视频任务。
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 的返回结果为准。CHOOSE A PATH
三种方式，按需接入
按使用习惯选择文档、远程工具或本地技能。具体支持的操作取决于对应接口、工具和客户端。
SETUP GUIDE
跟着步骤完成接入
选择一种方式，跟随步骤完成配置。命令可直接复制，测试提示词也已准备好。
APIMart Agent Tools
macOS · zsh · Codex 桌面端 · 生产环境
MCP / 步骤 01
安全设置 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-••••••••••••••••COMPARISON
怎么选，取决于你的使用习惯
快速查文档选 AI 文档，日常工具调用选 MCP，需要本地脚本与固定流程选 Skill。
| 接入方式 | 最适合 | 安装与配置 | 能力执行位置 | 主要优势 | 需要注意 | 快速开始 |
|---|---|---|---|---|---|---|
| AI 文档llms.txt | 临时查询、生成调用代码 | 无需安装，复制提示词 | Agent 阅读文档并运行代码 | 轻量上手，灵活调用接口 | 需要网页读取能力，执行代码仍需凭证 | |
| MCP推荐 | 高频交互、日常创作 | 配置远程服务与 Key | APIMart 远程 MCP | 结构化工具，无需本地 MCP 包 | 依赖网络与客户端支持，限已提供的工具 | |
| Agent Skill本地技能包 | 固定流程、团队标准化 | 通过 GitHub 安装完整目录 | 本地脚本调用 APIMart API | 流程可复用，独立于 MCP | 需要 Node.js，更新时可能需重新安装 |
CAPABILITIES
Agent 可以帮你完成什么
围绕模型发现、文档理解与常见图像和视频任务展开。使用前请确认所选模型、工具或本地客户端支持对应操作。
CAP / 02
参数与文档
读取输入参数、使用说明与限制条件，理解模型的调用方式。
CAP / 03
图像生成
完成模型选择、参数准备、任务提交、状态查询与结果获取。
CAP / 04
视频生成
调用视频模型，持续获取任务进度、执行状态与最终结果。
SECURITY FIRST
API Key 不出现在安装命令里
通过环境变量传递凭证，减少 Key 被终端历史、截图或聊天记录意外保存的风险。
- 先读文档，再配置凭证
AI 文档帮助 Agent 理解接口，不会自动发起模型调用。
- 通过环境变量读取
MCP 与 Skill 从环境变量读取 Key，不要将 Key 写进提示词或安装命令。
- 先查询模型验证连接
实际生成按 APIMart 账户规则计费。接入后先用模型查询验证配置。
FAQ
常见问题
三种方式都可用于常见图像与视频任务，但支持范围取决于对应接口、工具和客户端。AI 文档由 Agent 按文档编写调用代码；MCP 和 Skill 使用已提供的工具或本地命令。文档提到其他专用接口时，需先确认当前接入方式是否支持，不能仅凭读取到文档就直接调用。
选一种方式，开始使用
MCP 与 Skill 独立可用；AI 文档无需安装，可直接复制提示词。