让 Agent 调用模型
通过 MCP 服务、Codex 插件或项目 Skill，让 Codex、Claude Code、Gemini CLI 等 Agent 在对话中直接生成图片、视频、音频和 3D 内容。
配置 Agent 工具（见配置 Agent 工具）解决的是“Agent 用哪个模型写代码”。本页解决另一件事：让 Agent 在工作中调用 ModelSell 的其他模型，例如为网页生成配图、制作演示视频或合成语音。
| 方式 | 适合 | 准备 |
|---|---|---|
| MCP 服务 | 支持 MCP 的 Agent：Codex、Claude Code、Gemini CLI 等 | 注册 modelsell mcp |
| Codex 插件 | Codex，所有项目通用 | 安装插件，已内置 MCP 服务 |
| 项目 Skill | 只想在某个项目里启用，或 Agent 不支持 MCP | 在项目中运行 modelsell skill install |
三种方式都需要先安装 CLI 并登录（modelsell login 或设置 MODELSELL_API_KEY）。Agent 不会接触到你的 Key。
MCP 服务
modelsell mcp 是一个本地运行的 MCP 服务（stdio），为 Agent 提供以下工具：
| 工具 | 作用 |
|---|---|
modelsell_list_models | 按关键词或类型搜索当前 Key 可用的模型 |
modelsell_describe_model | 查看模型的协议、参数和文档链接 |
modelsell_run_model | 调用模型，支持提示词、原生参数、上传文件、下载结果和 dry-run |
modelsell_get_task | 查询或继续等待异步任务，不会重复提交 |
modelsell_list_tasks | 查看本机提交过的任务 |
modelsell_api_request | 调用原生 API 路径 |
modelsell_status | 查看登录状态，不返回 Key |
在 Agent 中注册：
# Claude Code
claude mcp add modelsell -- modelsell mcp
# Codex
codex mcp add modelsell -- modelsell mcp
# Gemini CLI
gemini mcp add modelsell modelsell mcp其他支持 MCP 的工具，按其文档添加一个 stdio 服务：命令为 modelsell，参数为 ["mcp"]。
注册后直接用自然语言提需求即可，例如“用 ModelSell 生成一张水彩风格的海边小屋图片，保存到 ./images”。查询类工具可直接使用；modelsell_run_model 等可能产生费用的调用，Agent 通常会先请你确认。
视频等长任务
生成视频可能需要几分钟，可能超过 Agent 的工具调用超时。可以调大超时（Codex 插件已设为 900 秒），或让 Agent 用 wait: false 提交，再用 modelsell_get_task 查询。超时后工具会返回“进行中”和任务 ID，Agent 不会重新提交。
Codex 插件
插件把 MCP 服务和使用说明打包在一起，安装一次即可在所有项目中使用：
codex plugin marketplace add modelsell/modelsell-cli
codex plugin add modelsell@modelsell插件包含 modelsell（模型调用）和 modelsell-setup（安装与登录引导）两个技能。Codex 默认沙箱会禁止联网，而 MCP 服务在沙箱外运行，因此不受影响。
项目 Skill
在项目目录中运行，为 Codex 和 Claude Code 写入模型调用说明：
modelsell skill install # 同时写入两者
modelsell skill install --target codex # 只写入 .agents/skills/modelsell/SKILL.md
modelsell skill install --target claude # 只写入 .claude/skills/modelsell/SKILL.mdSkill 让 Agent 通过命令行调用模型。Codex 默认沙箱禁止联网，此时 CLI 会提示 fetch failed，需要在 Codex 中允许联网，或改用上面的 MCP 服务或插件。