AtlasCloudAI/cli

Atlas Cloud CLI

在 shell、脚本和 CI 任务中调用 Atlas Cloud 的 LLM、图像和视频 API —— 支持为多模态聊天提供图像/视频/音频输入。

→ 获取你的免费 Atlas Cloud API 密钥 —— 300+ 模型，一个密钥，兼容 OpenAI。

本仓库托管 atlas CLI 的公开安装程序、发布产物以及轻量级包管理器封装。Go 源码仓库单独维护。

支持的模型

- 🎬 视频 (200) —— MiniMax H3 Max · MiniMax H3 Fast · Gemini Omni 1.1 Flash · MiniMax H3 · Wan-3.0-Prime · Wan-3.0
- 🎨 图像 (130) —— GPT Image 2.5 Sunburst · GPT Image 2.5 Flare · Seedream v4.7 · MAI-Image-2.6-Flash
- 🧊 3D (10) —— Seed3D 2.0 · Tripo H3.1 · Hunyuan 3D Rapid · Hunyuan 3D Pro
- 💬 LLM (72) —— DeepSeek V4.1 Flash · DeepSeek V4 Pro 0813 · Grok 4.6 · DeepSeek V4 Flash Vision Exp

- 📚 探索更多 —— 全部 449 个实时模型 »

🎬 最新视频模型 —— Seedance 2.5 · Kling 4.0 · Wan 3.0 · Kling Video O3。

ℹ️ 音频：CLI 接受音频作为多模态聊天的输入（atlas chat --audio @file.mp3，例如使用 qwen/qwen3-vl-8b-instruct 进行转录）。音频生成（TTS / 音乐）以及专用的 3D/音频子命令尚未在 CLI 中提供 —— 请关注 #3，或在此期间使用 MCP 服务器 / REST API。

可用性、参数和定价因模型而异。在自动化计费调用之前，请针对实时目录使用 atlas models get 和
atlas generate cost。

目录

- 支持的模型
- 安装
- API 调用方工作流
- 指南
- 命令
- 全局标志
- 更新
- 卸载
- 故障排除
- 支持
- 更多 Atlas Cloud 工具
- 许可证

安装

macOS / Linux

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

选项：

INSTALLER=https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.sh

自定义前缀，如果目录可写则无需 sudo
curl -fsSL "$INSTALLER" | sh -s -- --prefix="$HOME/.local"

安装程序始终使用最新的 GitHub Release，下载匹配的归档文件，并根据 checksums.txt 进行校验。

Windows

irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex

选项：

自定义安装目录
$env:ATLAS_INSTALL_DIR="$HOME\bin"; irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex

跳过将 atlas.exe 添加到用户 PATH
$env:ATLAS_NO_PATH="1"; irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex

Windows 安装程序始终使用最新的 GitHub Release，下载匹配的 windows_amd64 或 windows_arm64 zip 文件，根据 checksums.txt 进行校验，安装 atlas.exe，并默认将安装目录添加到用户 PATH。

Homebrew

brew install AtlasCloudAI/tap/atlascloud

该 formula 名为 atlascloud，但它安装的是 atlas 命令。

npm

npm install -g atlascloud-cli

npm 包是一个轻量封装。其 postinstall 脚本会下载匹配的预构建发布归档文件，并在暴露 atlas 之前校验校验和。

手动安装

从 Releases 下载适用于你的操作系统和架构的归档文件，解压后，将二进制文件放入你的 PATH 中。

API 调用方工作流

认证一次，然后选择与你想要发起的 API 调用相匹配的命令路径。发现和费用命令在开始计费生成之前运行是安全的。

atlas auth login                               # 交互式
atlas auth login --token "$ATLASCLOUD_API_KEY" # CI / 非交互式
atlas auth status

| 任务 | 命令模式 | 备注 |
|---|---|---|
| 发现可用模型 | atlas models list --type video --json | 将 video 替换为 chat 或 image；避免硬编码过时的模型 ID。 |
| 查看模型参数 | atlas models get MODEL_ID --json | 阅读必填字段、默认值以及供应商特定的参数名称。 |
| 估算生成费用 | atlas generate cost video MODEL_ID ... --json | 使用 cost image 或 cost video；仅调用定价端点。 |
| 调用聊天或多模态模型 | atlas chat --model MODEL_ID "prompt" | 支持文本，以及针对具备相应能力的模型使用 --image、--video 和 --audio。 |
| 启动图像/视频任务 | atlas generate image MODEL_ID ... | 使用 generate image 或 generate video；为异步脚本添加 --no-wait --json。 |
| 继续异步任务 | atlas generate get PREDICTION_ID / atlas generate wait PREDICTION_ID | 轮询状态或等待完成。 |
| 脚本和 CI 用法 | atlas --json ... \| jq ... | 非 TTY 输出默认是 JSON；--json 使其显式化。 |

无需模型调用即可探索

atlas models list --type video --json | jq -r '.models[].id'
atlas models search seedance --type video --json
atlas models get bytedance/seedance-2.5/text-to-video --json

在生成前估算成本

atlas generate cost video bytedance/seedance-2.5/text-to-video \
-p "A product shot slowly rotates on a clean white background" \
--duration 5 \
--resolution 720p \
--param generate_audio=false \
--json

发起 API 调用

atlas chat --model deepseek-ai/DeepSeek-V3-0324 "Return only a JSON object with status=ok"

PRED=$(atlas generate image google/nano-banana-2/text-to-image \
-p "minimal product photo on a white background" \
--no-wait --json | jq -r '.id')
atlas generate wait "$PRED"

更喜欢环境变量？将 .env.example 复制为 .env 并设置 ATLASCLOUD_API_KEY。

更多 API 调用脚本（发现优先调用 → 成本感知生成 → 脚本化流水线 → CI JSON 任务）位于 examples/。

指南

- API 调用者工作流 — 如何在本地脚本、CI 任务和后端自动化中将 Atlas CLI 用作 shell 优先的 API 客户端。

命令

| 命令 | 用途 |
|---|---|
| atlas auth | 登录、登出、检查本地认证状态 |
| atlas chat | 发送聊天补全请求 |
| atlas models | 列出并检查可用模型 |
| atlas generate | 生成图像和视频，轮询任务状态 |
| atlas account | 管理账户选择 |
| atlas version | 打印构建信息 |

运行 atlas --help 或 atlas  --help 获取完整标志参考。

全局标志

| 标志 | 用途 |
|---|---|
| --json | 强制输出机器可读的 JSON |
| --no-color | 禁用 ANSI 颜色 |
| --quiet | 抑制加载动画和进度文本 |
| --verbose | 将调试输出打印到 stderr |

更新

curl 安装程序
curl -fsSL https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.sh | sh

Homebrew
brew update && brew upgrade atlascloud

npm
npm install -g atlascloud-cli@latest

卸载

curl 安装程序，默认前缀
sudo rm -f /usr/local/bin/atlas

Homebrew
brew uninstall atlascloud

npm
npm uninstall -g atlascloud-cli

故障排除

Not logged in — 运行 atlas auth login。

Unknown model — 运行 atlas models list 或 atlas models search 。

安装程序校验和失败 — 不要运行下载的归档文件。重试安装，或使用确切的 URL 和版本打开 issue。

支持
Bug 和功能请求：GitHub Issues。请附上 atlas version、你的操作系统/架构、安装方式，以及失败的确切命令。

更多 Atlas Cloud 工具

- 🧰 想在终端中使用？ → atlascloud-cli
- 🤖 想在 Claude Code / Cursor 中使用？ → 安装 Atlas Cloud MCP Server
- 🎬 想作为 Claude Code / Codex / Gemini CLI Skill 使用？ → 安装 atlas-cloud-skills
- 🎨 ComfyUI 节点 → atlascloud_comfyui
- 🔁 n8n 节点 → n8n-nodes-atlascloud
- 💬 加入我们的 Discord → discord.gg/MWmMr4q9es
- 🌐 网站 → atlascloud.ai

许可证

MIT