ModelSell CLI

ModelSell CLI 是 ModelSell 的开源命令行工具。你可以在终端中查找模型、提交生成请求、等待任务完成并下载结果，也可以把这些步骤接入脚本和 Agent 工作流。原有的 Codex、Claude Code、Gemini CLI 和 OpenClaw 一键配置功能继续保留。

本页介绍 v0.2.0。支持 macOS（Apple Silicon / Intel）、Linux（ARM64 / x64）和 Windows x64；独立程序无需安装 Node.js。

开源代码 · 下载版本 · MIT 许可证

适用场景

• 个人创作：直接生成文本、图片、视频、音乐和 3D 内容，保存结果到本地。
• 开发与自动化：用 JSON 输入、流式输出和任务 ID 将模型调用接入脚本。
• Agent 工作流：为项目安装 ModelSell Skill，让 Codex 或 Claude Code 按模型参数调用能力。
• 团队与环境初始化：共享模型别名和默认参数，统一配置常用编程工具。

项目功能

modelsell 同时提供模型 API 调用和编程工具配置。v0.2.0 新增能力如下：

原有配置能力支持 Codex、Claude Code、Gemini CLI、OpenClaw：

• 交互式配置：运行 modelsell 后按提示选择要配置的工具。
• 非交互式配置：适合脚本、自动化部署或快速初始化环境。
• 多工具统一配置：可以一次性配置全部支持的工具，也可以只配置其中一个。
• 默认模型写入：Codex、Claude Code、Gemini CLI 会写入对应默认模型。
• OpenClaw 模型配置：会写入 ModelSell 的 OpenAI Responses 与 Anthropic Messages 兼容模型配置。
• 安全备份：写入前会自动备份已有配置文件，备份后缀为 .bak.<timestamp>。

一键安装

macOS 和 Linux 可以使用安装脚本：

curl -fsSL https://raw.githubusercontent.com/modelsell/modelsell-cli/main/install.sh | sh

如果无法访问 GitHub，可以使用备用安装地址：

curl -fsSL https://static.modelsell.com/modelsell-cli/install.sh | sh

Windows PowerShell 可以使用安装脚本：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/modelsell/modelsell-cli/main/install.ps1 | iex"

如果无法访问 GitHub，可以使用备用安装地址：

powershell -ExecutionPolicy Bypass -c "irm https://static.modelsell.com/modelsell-cli/install.ps1 | iex"

macOS/Linux 安装脚本默认会把 modelsell 安装到：

~/.local/bin/modelsell

Windows 安装脚本默认会把 modelsell.exe 安装到：

%USERPROFILE%\.local\bin\modelsell.exe

安装完成后，先检查版本，再登录并调用模型。直接运行 modelsell 则进入 Agent 配置界面。

modelsell --version
modelsell login

已有旧版 CLI 时，重新运行安装脚本即可更新。独立程序无需安装 Node.js。 也可从 GitHub Releases 下载，或使用 Node.js 18+ 安装 Release 中的 npm 格式包：

npm install -g https://github.com/modelsell/modelsell-cli/releases/download/v0.2.0/modelsell-cli-0.2.0.tgz

该包由 GitHub Release 托管，请使用上面的完整地址安装。

如果输入 modelsell 后提示“找不到命令”或“无法识别”，可以直接使用安装器显示的完整路径。默认路径如下：

macOS / Linux：

~/.local/bin/modelsell

Windows PowerShell：

& "$HOME\.local\bin\modelsell.exe"

Windows 安装器也会尝试把安装目录加入用户 PATH；重新打开 PowerShell 后即可直接输入 modelsell。

手动下载

也可以从 GitHub Releases 下载对应平台的二进制文件：

• macOS Apple Silicon: https://github.com/modelsell/modelsell-cli/releases/latest/download/modelsell-darwin-arm64
• macOS Intel: https://github.com/modelsell/modelsell-cli/releases/latest/download/modelsell-darwin-x64
• Linux ARM64: https://github.com/modelsell/modelsell-cli/releases/latest/download/modelsell-linux-arm64
• Linux x64: https://github.com/modelsell/modelsell-cli/releases/latest/download/modelsell-linux-x64
• Windows x64: https://github.com/modelsell/modelsell-cli/releases/latest/download/modelsell-win-x64.exe

macOS / Linux 下载后执行（下面以 Apple Silicon 为例，其它平台替换文件名）：

chmod +x modelsell-darwin-arm64
./modelsell-darwin-arm64

Windows PowerShell 下载后执行：

.\modelsell-win-x64.exe

模型调用快速上手

在 ModelSell 控制台创建 API Key，确保令牌拥有目标模型权限和可用额度。默认 API 地址为 https://www.modelsell.com。

# 登录时隐藏密钥输入
modelsell login
modelsell status

# 查找当前 Key 可用的模型，查看调用参数
modelsell models
modelsell models seedance --type video
modelsell schema gpt-image-2 --json
modelsell run gpt-image-2 --help

# 文本流与图片下载
modelsell run gpt-6-sol -p '用中文解释一下什么是向量数据库' --stream
modelsell run gpt-image-2 -p '清晨海边的小屋，水彩风格' --download ./images

模型 ID 以 modelsell models 的结果和当前 Key 权限为准。未登录或加 --all 时展示公开目录；公开可见不代表当前 Key 有调用权限。

登录信息默认保存在 ~/.config/modelsell/credentials.json。自动化环境可注入 MODELSELL_API_KEY，或通过标准输入使用 modelsell login --key-stdin。 API 地址默认为 https://www.modelsell.com，可用 MODELSELL_BASE_URL 或 --base-url 指定；已保存的 Key 只用于登录时的 API 地址。

视频、音频、3D 与向量

# 视频：提交任务后返回 task_id
modelsell run grok-imagine-video -p '镜头缓慢越过海面' --no-wait --json

# 将 TASK_ID 替换为返回的 task_id，恢复等待并下载视频
modelsell wait TASK_ID --download ./videos --json

# Seedance：显式选择原生协议，传入原生参数
modelsell run doubao-seedance-2-0-260128 \
  --endpoint seedance2-native-video -p '镜头缓慢越过海面' \
  -i duration=4 -i watermark=false --json

# 音乐、3D、向量
modelsell run suno_music -p '轻快的夏日纯音乐' -i make_instrumental=true --json
modelsell run Tripo/Tripo-H3.1 -p 'a small red robot' --json
modelsell run text-embedding-v4 --endpoint embeddings \
  -i 'input=["第一段文字","第二段文字"]' --json

语音识别和语音合成可使用文件输入与二进制输出。将下面的 AUDIO_MODEL 替换为支持相应协议的模型 ID：

modelsell run AUDIO_MODEL --endpoint transcription --file file=./speech.wav --json
modelsell run AUDIO_MODEL --endpoint speech -p '你好，世界' \
  -i voice=alloy --output ./speech.mp3 --json

原生参数、文件与脚本

CLI 根据模型元信息选择协议，也可用 --endpoint 明确指定。例如 openai、openai-response、anthropic、gemini、image-generation、openai-video、seedance2-native-video、speech、transcription、embeddings、jina-rerank。用 modelsell endpoints --json 查看完整列表。

-p 将提示词放入对应协议的输入字段；-i key=value 可重复使用，支持数组、 对象、嵌套字段，并保留显式 0 和 false。多轮消息、工具调用和多模态内容 可通过 JSON 文件完整传入；已有 messages 等输入字段时不要再叠加 -p。

# request.json 应包含完整的原生请求参数
modelsell run gpt-6-sol --input-file request.json --json
cat request.json | modelsell run gpt-6-sol --input-file - --json
modelsell run gpt-image-2 -p '水彩小屋' --dry-run --json

# 图片编辑使用 multipart 文件输入
modelsell run gpt-image-2 --endpoint openai-image-edit \
  --file image=./photo.png -p '替换为蓝色背景' --download ./edited

# 原生 API：示例文件包含该端点要求的完整 JSON 请求
modelsell request /v1/responses/compact --method POST --input-file compact.json --json
modelsell upload --input-file asset.json

例如，将以下内容保存为 request.json，即可传入多轮消息：

{
  "messages": [
    { "role": "system", "content": "你是一名中文写作助手。" },
    { "role": "user", "content": "为海边民宿写一句简短介绍。" }
  ]
}

参数优先级从低到高为：别名默认输入 → JSON 文件 → -i → 动态参数 → -p。 --dry-run 只预览请求，不提交生成任务。未知的 --参数名 会报错；原生字段可用 -i 或 JSON 文件传入。

JSON 参数中的显式 @./file 会读取文件并转为 data URI，要求目标模型支持此格式； 普通路径字符串不会自动读取。upload 对应平台 /api/assets/upload，接受供应商 定义的 JSON 资源参数，不是通用文件托管服务。每个本地输入文件最多 100 MiB；更大的素材请按模型要求提供可访问的 HTTPS URL。

--json 将结果写入 stdout，进度写入 stderr；原生响应保留在 response 字段。 --stream --json 输出 JSONL 事件，调用失败返回非零退出码。 modelsell realtime MODEL_ID 以 JSONL 收发实时协议事件，音频编码和输入由调用者提供，CLI 不会自动采集麦克风。MiMo 音频模型使用 Chat Completions，应按模型文档传入 JSON，不要强制指定 speech。

任务恢复与下载

modelsell show TASK_ID --json
modelsell wait TASK_ID --timeout 1200 --json
modelsell history --limit 20 --json

# 查询其他机器提交的任务时，指定对应的查询路径
modelsell wait TASK_ID --fetch-path '/v1/videos/{task_id}' --json

异步任务默认每 2 秒查询一次，最长等待 600 秒，可通过 --poll-interval 和 --timeout 调整。客户端超时后使用 wait 恢复等待，无需重复提交。 history 只包含本机保存的任务，记录位于配置目录的 tasks/ 中；--no-wait 返回表示提交成功，不代表生成完成。

--download DIR 保存生成的媒体文件，download URL --output FILE 下载指定结果。 下载失败会返回错误，默认不覆盖已有文件；确认替换时使用 --force。

项目别名与 Agent Skill

运行 modelsell init 创建当前目录的 modelsell.json，然后设置默认模型或别名：

{
  "defaultModel": "hero",
  "aliases": {
    "hero": {
      "model": "gpt-image-2",
      "endpoint": "image-generation",
      "input": { "size": "1024x1024" }
    }
  }
}

modelsell run hero -p '适合官网的水彩插画' --download ./images
modelsell aliases --json
modelsell skill install

Skill 默认安装到当前项目的 .agents/skills/modelsell/SKILL.md 和 .claude/skills/modelsell/SKILL.md；可通过 --target codex 或 --target claude 选择目标。项目配置用于共享模型和参数，不存放 API Key。设置 defaultModel 后，run 可以省略模型名；命令行参数仍可覆盖别名默认值。安装 Skill 会为 Agent 提供发现模型、检查参数、调用和排查错误的操作说明。

配额、价格与能力范围

modelsell usage --json
modelsell price gpt-image-2 --json
modelsell endpoints --json

usage 返回当前 Key 的服务器 quota，不是账户现金余额；price 返回公开元信息， 不是当前用户分组的精确报价。参数帮助来自在线端点元信息和协议默认值，可能不完整； 供应商专有参数可用 -i 或 --input-file 传入。

CLI 提供 Modelsell 已接入能力的协议入口，具体可用性取决于服务端支持和 Key 权限。 目录和协议覆盖不代表每个模型均已完成真实生成验证。完整行为、协议列表及边界见 模型调用指南；设计参考见 WaveSpeed CLI 调研记录。

编程工具配置

直接运行 modelsell、modelsell configure 或 modelsell config 会进入原有配置流程。模型登录命令 login 与编程工具配置是独立操作。

交互式配置：

modelsell

配置全部支持的工具：

modelsell configure --api-key sk-xxx --yes

只配置一个工具：

modelsell configure --target codex --api-key sk-xxx --yes

支持的 --target 值：

all, codex, claude, gemini, openclaw

也可以通过环境变量传入 API Key：

MODELSELL_API_KEY=sk-xxx modelsell configure --yes

CLI 会根据所选工具写入 API 地址、密钥和模型，写入前备份已有配置，文件后缀为 .bak.<timestamp>。

写入的配置文件

• Codex: ~/.codex/config.toml、~/.codex/auth.json
• Claude Code: ~/.claude/settings.json
• Gemini CLI: ~/.gemini/settings.json、~/.gemini/.env
• OpenClaw: ~/.openclaw/openclaw.json、~/.openclaw/.env

常见问题

更多 Agent 工具配置入口

以下卡片与 接入 Agent 工具 页面保持一致。你可以继续查看每个工具的详细配置方式。