CLI

Установите и используйте Atlas Cloud CLI, чтобы работать с чат-моделями, смотреть schemas и генерировать изображения или видео из терминала.

Atlas Cloud CLI предоставляет команду atlas для доступа к Atlas Cloud из терминала или автоматизированного скрипта. CLI поддерживает аутентификацию, LLM chat, просмотр schemas моделей, генерацию изображений, генерацию видео и polling задач.

GitHub репозиторий: AtlasCloudAI/cli

Установка

Homebrew

brew install AtlasCloudAI/tap/atlascloud

Homebrew formula называется atlascloud, но устанавливаемая команда — atlas.

npm

npm install -g atlascloud-cli

npm-пакет — это тонкий wrapper, который загружает подходящий готовый Release binary для поддерживаемых платформ.

Windows PowerShell

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

PowerShell installer загружает подходящий Windows Release zip, проверяет его через checksums.txt, устанавливает atlas.exe и по умолчанию добавляет его в пользовательский PATH.

macOS / Linux Shell Installer

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

Shell installer поддерживает macOS и Linux. Для ручной загрузки используйте GitHub Releases.

Проверка

atlas version

Аутентификация

Создайте API Key в Atlas Cloud Console, затем выполните вход:

atlas auth login

Для CI и неинтерактивных окружений передайте ключ через --token:

atlas auth login --token "$ATLASCLOUD_API_KEY"

Проверьте локальный статус входа без вызова account API:

atlas auth status

Команды account и billing сейчас отмечены как upcoming. Пока серверные endpoints недоступны, используйте Console.

Чат

Используйте atlas chat для OpenAI-совместимых чат-моделей:

atlas chat "Explain UUID v7 in two sentences" \
  --model deepseek-ai/DeepSeek-V3-0324

Можно передать ввод из другой команды:

cat error.log | atlas chat "Find the root cause and suggest a fix"

Если stdout не является TTY, CLI автоматически выводит JSON. Также можно явно указать --json:

atlas chat "say only OK" \
  --model deepseek-ai/DeepSeek-V3-0324 \
  --json | jq -r '.choices[0].message.content'

Модели

Список и поиск моделей:

atlas models list --json
atlas models search deepseek --json

Просмотр schema модели:

atlas models get deepseek-ai/DeepSeek-V3-0324 --json
atlas models get google/nano-banana-2/text-to-image --json
atlas models get google/veo3.1/image-to-video --json
atlas models get bytedance/seedance-2.0-fast/image-to-video --json
atlas models get alibaba/wan-2.7/image-to-video --json

models list и models search сейчас лучше всего покрывают chat-модели. Некоторые image/video модели доступны по прямым ID до появления в списке. Для media моделей используйте документацию или atlas models get с известным ID.

Генерация изображений

Сгенерировать изображение и дождаться завершения:

atlas generate image google/nano-banana-2/text-to-image \
  -p "a tiny cat"

Сразу вернуть prediction id:

atlas generate image google/nano-banana-2/text-to-image \
  -p "a tiny cat" \
  --no-wait \
  --json

Проверить или дождаться асинхронной задачи:

atlas generate get <prediction_id> --json
atlas generate wait <prediction_id> --json --no-download

По умолчанию atlas generate image ждет завершения и скачивает outputs в текущий каталог. Используйте --no-download, если agent или скрипту нужны только URL.

Генерация видео

Image-to-video моделям требуется URL изображения или локальный файл:

atlas generate video google/veo3.1/image-to-video \
  -p "A cinematic camera push-in" \
  --image "https://example.com/input.png" \
  --resolution 1080p \
  --duration 8 \
  --no-wait \
  --json

Позже можно опрашивать задачу через atlas generate wait <prediction_id>.

Schemas видео моделей отличаются. Общие поля --image, --images, --end-image, --video, --audio, --resolution, --size и --duration имеют отдельные flags. Новые или vendor-specific поля передавайте через --params-json или повторяющийся --param key=value:

atlas generate video google/veo3.1/image-to-video \
  --params-json '{"prompt":"A cinematic camera push-in","image":"https://example.com/input.png","resolution":"1080p","duration":8}' \
  --no-wait \
  --json

Удобно для agents

Для скриптов и AI agents предпочитайте стабильный machine-readable output:

atlas models get google/nano-banana-2/text-to-image --json

atlas generate image google/nano-banana-2/text-to-image \
  -p "a tiny cat" \
  --no-wait \
  --json

atlas generate video google/veo3.1/image-to-video \
  --params-json '{"prompt":"A cinematic camera push-in","image":"https://example.com/input.png","resolution":"1080p","duration":8}' \
  --no-wait \
  --json

atlas generate wait <prediction_id> \
  --json \
  --no-download

Рекомендуемые flags:

Flag	Назначение
`--json`	Force JSON output for parsing
`--no-wait`	Start a generation job and return the prediction ID immediately
`--no-download`	Print result URLs without writing files
`--quiet`	Suppress progress text in automation
`--params-json`	Pass an exact model input object from the model schema
`--param`	Add or override one model-specific field

Переменные окружения

Variable	Описание
`ATLAS_API_BASE`	Override the API base URL. A trailing `/v1` is normalized automatically.
`ATLAS_TOKEN_FILE`	Store the CLI token in a custom file, useful for multiple accounts or CI.
`NO_COLOR`	Disable color output.

Известные ограничения

atlas account и atlas auth whoami остаются upcoming до появления серверных account endpoints.
atlas models list --type image и atlas models list --type video могут быть неполными, пока /v1/models ориентирован на chat-модели. Для известных media model IDs используйте atlas models get MODEL_ID --json.
install.sh поддерживает macOS и Linux. В Windows используйте PowerShell installer. Scoop/Winget можно добавить позже как каналы package manager.

Содержание