UpRes CLI 是 upres.ai 的官方命令行工具与软件开发包（SDK），面向图像、视频和语音修复场景。它通过一个统一的 API 提供 14 个公开别名（alias），输出分辨率最高支持 8K。
用途方面，UpRes CLI 主要用于将图像、视频和语音文件提交至 upres.ai 进行放大/修复处理，并获取处理结果。官方说明中列出其与 Topaz、Upscayl 及其他 SaaS 放大工具的区别：Topaz 价格较高且仅限桌面；Upscayl 适合单次处理但难以支持批量导出或 CI 管道；其他 SaaS 放大器可能存在输出加水印、分辨率限制在 2K 或按图收费且无月度套餐等问题。UpRes 提供干净的 REST API、14 个公开别名、批量处理和可预期的定价（官方称 Creator 启动价为每月 9 美元起）。
主要能力包括：图像、视频和语音修复；最高 8K 输出；14 个公开别名，每个别名会明确说明是“生成细节”还是“不对文件做额外处理”；不进行放大的别名会忽略 --scale 参数；支持批量处理；超过 50 MB 的文件会自动通过 TUS 可恢复上传协议上传；提供 Python SDK，使用 httpx，支持异步且无重量级依赖。完整的模型目录可查看 upres.ai/models，实时规范位于 api.upres.ai/v1/openapi.json。Studio 层级可解锁完整 API、批量处理并去除输出水印。
使用方式上，首先需在 upres.ai 注册（免费，每月 5 次放大），然后在 upres.ai/account/api-keys 生成 API 密钥（密钥仅显示一次）。密钥解析顺序为：--api-key 命令行参数 → UPRES_API_KEY 环境变量 → ~/.config/upres/config.json 配置文件。安装方式支持全局安装，官方文本中未给出具体安装命令内容。此外提供 MCP 支持，适用于 Claude、Cursor、Hermes，并可在 claude_desktop_config.json 或 Cursor 中配置。MCP 工具包括：upres_list_models、upres_get_credits、upres_upscale_image、upres_upscale_video、upres_enhance_audio、upres_get_job。
适用场景包括：需要自动化或批量处理图像、视频、语音修复的开发者；需要将放大能力集成到 CI 管道中的团队；需要 API 对接的 SaaS 或应用开发者；以及使用 MCP 的 Claude、Cursor、Hermes 用户。
限制与补充方面：官方提供免费层级，每月 5 次放大；针对符合条件的开源项目，可发送仓库链接至 support@upres.ai 申请每月 500 次操作额度。SDK 会自动处理部分错误：在 Python 中会抛出 AuthError、QuotaExceededError 或 UpresError。贡献指南见 CONTRIBUTING.md，测试运行方式官方文本未给出具体命令。项目采用 MIT 许可，详见 LICENSE。
