CLI

Atlas Cloud CLI를 설치하고 사용하여 터미널에서 채팅, 모델 Schema 확인, 이미지와 동영상 생성을 실행합니다.

Atlas Cloud CLI는 터미널이나 자동화 스크립트에서 Atlas Cloud에 접근하는 atlas 명령을 제공합니다. 인증, LLM 채팅, 모델 Schema 조회, 이미지 생성, 동영상 생성, 비동기 작업 폴링을 지원합니다.

GitHub 저장소: AtlasCloudAI/cli

설치

Homebrew

brew install AtlasCloudAI/tap/atlascloud

Homebrew formula 이름은 atlascloud이지만 설치되는 명령은 atlas입니다.

npm

npm install -g atlascloud-cli

npm 패키지는 가벼운 wrapper이며 지원 플랫폼에 맞는 사전 빌드 Release 바이너리를 다운로드합니다.

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

인증

Atlas Cloud Console에서 API Key를 만든 뒤 로그인합니다:

atlas auth login

CI 또는 비대화형 환경에서는 --token을 전달합니다:

atlas auth login --token "$ATLASCLOUD_API_KEY"

계정 API를 호출하지 않고 로컬 로그인 상태를 확인합니다:

atlas auth status

계정 및 결제 관련 CLI 명령은 현재 upcoming입니다. 서버 계정 엔드포인트가 제공되기 전까지는 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는 채팅 모델에 가장 강합니다. 일부 이미지 및 동영상 모델은 목록에 나타나기 전에도 알려진 model id로 직접 사용할 수 있습니다. 미디어 모델은 모델 문서 또는 atlas models get으로 확인하세요.

이미지 생성

이미지를 생성하고 완료까지 기다립니다:

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는 완료까지 기다리고 출력을 현재 디렉터리에 다운로드합니다. Agent나 스크립트가 URL만 필요하면 --no-download를 사용하세요.

동영상 생성

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>로 작업을 폴링할 수 있습니다.

동영상 모델 Schema는 모델마다 다릅니다. --image, --images, --end-image, --video, --audio, --resolution, --size, --duration 같은 일반 필드는 일급 flag로 제공됩니다. 새 모델이나 벤더 전용 필드는 --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

Agent 친화적 사용법

스크립트와 AI Agent에서는 안정적인 기계 판독 가능 출력을 우선 사용하세요:

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입니다.
/v1/models가 채팅 모델 중심인 동안 atlas models list --type image와 atlas models list --type video는 불완전할 수 있습니다. 알려진 미디어 model id는 atlas models get MODEL_ID --json을 사용하세요.
install.sh는 macOS와 Linux를 지원합니다. Windows에서는 PowerShell installer를 사용하세요. Scoop/Winget은 나중에 package manager 채널로 추가할 수 있습니다.

목차