공식 커맨드라인 도구
ZOOOP AI CLI: 터미널에서 이미지, 비디오, 오디오 생성
npm 패키지 하나로 터미널에서 GPT Image, Nano Banana, Seedance, Kling, ElevenLabs 등 70개 이상의 AI 모델을 사용할 수 있습니다. 브라우저로 로그인한 뒤 명령어 하나로 가격 확인, 생성, 다운로드까지 끝내거나 CI에서 스크립트로 실행하세요.
npx zooop loginmacOS, Linux, Windows 지원 · Node.js 18 이상 · 다른 의존성 없음
이미 쓰고 있는 모델을 그대로
- GPT Image 2.5
- Nano Banana 2.1
- Seedream 5.0
- Midjourney V8.2
- Seedance 2.5
- Kling
- Wan 3.0
- Vidu Q4
- MiniMax H3
- Gemini Omni
- Grok Imagine
- ElevenLabs
- AI 모델
- 70+
- 가지 미디어 유형
- 3
- 개 명령어로 로그인
- 1
- 개의 추가 의존성
- 0
모든 인기 모델을 명령어 하나로
CLI는 ZOOOP 모델 카탈로그를 실시간으로 읽기 때문에 새로운 이미지, 비디오, 오디오 모델도 출시 당일부터 쓸 수 있습니다. 따로 업데이트할 필요가 없습니다.
$zooop models --type video터미널과 스크립트를 위한 설계
모든 명령어가 --json을 지원하고, stdout은 파이프에 바로 연결할 수 있게 깔끔하며, 진행 상황은 stderr로 출력되고, 종료 코드도 의미가 명확합니다. 셸 스크립트, Makefile, CI 작업에 그대로 넣어 쓰세요.
$zooop tasks --json | jq .tasks[0].status사용한 만큼 내는 크레딧
실행 비용은 ZOOOP 잔액에서 차감됩니다. 구독이 필요 없고 크레딧은 만료되지 않으며, 실행 전에 정확한 가격을 확인할 수 있습니다.
$zooop quote --template claymation-me생성할 수 있는 것
ZOOOP 공개 API가 제공하는 모든 기능에 더해, 갤러리의 원클릭 템플릿과 배경 제거, 업스케일 같은 전용 AI 도구까지 사용할 수 있습니다.
이미지
텍스트로 이미지 생성, 이미지로 이미지 변환, 프롬프트 기반 편집, 인페인팅, SVG 벡터 출력, 업스케일, 배경 제거.
비디오
텍스트로 비디오 생성, 정지 이미지 애니메이션, 첫/마지막 프레임 보간, 모션 전이, 립싱크, 영상 연장, 스타일 변환.
오디오
원하는 목소리로 텍스트 음성 변환, 샘플 기반 음성 복제, 효과음, 완성된 음악 트랙.
모델 목록은 카탈로그에서 실시간으로 불러오므로 오늘 공개된 모델도 당일 바로 쓸 수 있습니다. 모든 모델 보기.
모든 템플릿을 명령어 하나로
갤러리의 원클릭 템플릿도 터미널에서 실행할 수 있습니다. zooop templates show로 템플릿에 필요한 입력값을 확인하고, zooop run --template으로 내 사진을 넣어 바로 생성하세요.
세 단계로 시작하기
약 2분 걸립니다. 터미널과 ZOOOP 계정만 있으면 됩니다.
- 1
CLI 설치
패키지 매니저로 전역 설치하거나 npx로 필요할 때 바로 실행하세요. Node.js 18 이상만 있으면 됩니다.
npm install -g zooopzooop --help현재 사용자 계정에 zooop 명령어를 설치합니다.
- 2
브라우저로 로그인
zooop login을 실행하면 짧은 코드가 표시되고 zooop.ai/cli/login가 열립니다. 브라우저에 같은 코드가 표시되는지 확인하고 계정과 프로젝트를 선택한 뒤 ‘승인’을 클릭하세요. 키를 복사하거나 붙여넣을 필요가 없습니다.
CI용 API 키 만들기직접 시작한 로그인의 코드만 승인하세요. 키는 API 키 페이지나 zooop logout으로 언제든지 취소할 수 있습니다.
zooop login기본 브라우저가 열립니다. 키는 이 컴퓨터에만 저장되며, 본인만 읽을 수 있는 파일에 보관됩니다.
- 3
첫 생성 실행
모델을 찾고 가격을 확인한 뒤 실행하세요. CLI가 결과를 기다렸다가 현재 디렉터리에 저장합니다.
첫 실행zooop models --type image --subtype defaultzooop quote --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"zooop run --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"
키 붙여넣기 없이 브라우저로 로그인
zooop login을 실행하면 짧은 코드가 표시되고 zooop.ai/cli/login가 열립니다. 두 코드가 일치하는지 확인하고 승인하면 CLI 로그인이 완료됩니다. 키는 클립보드를 거치지 않습니다.
터미널에 일회용 코드가 표시됩니다
브라우저에 같은 코드가 표시되면 승인하세요
CLI 로그인이 완료되고 키는 로컬에 저장됩니다
명령어 레퍼런스
모든 명령어는 --json과 -h를 지원합니다. 명령어 뒤에 --help를 붙이면 모든 옵션을 볼 수 있습니다.
- zooop login
브라우저로 로그인하고 이 컴퓨터용 키를 저장합니다.
zooop login- zooop whoami
계정, 프로젝트, 크레딧 잔액, 키 만료일을 표시합니다.
zooop whoami- zooop models
모델 목록을 버전, 입력값, 대략적인 가격과 함께 표시합니다.
zooop models --type video --subtype text-ref- zooop templates
갤러리 템플릿을 살펴보고 각 템플릿에 필요한 입력값을 확인합니다.
zooop templates show <slug>- zooop tools
배경 제거, 업스케일 같은 AI 도구 목록을 표시합니다.
zooop tools- zooop quote
실행하지 않고 요청 가격만 확인합니다.
zooop quote --model <id> --version <id> -p prompt="..."- zooop run
요청을 제출하고 결과를 기다린 뒤 다운로드합니다. 로컬 파일은 자동으로 업로드됩니다.
zooop run --template <slug> -p image_url=@photo.jpg- zooop tasks
최근 작업을 나열하고, 특정 작업을 확인하거나 완료를 기다리거나, 대기 중인 작업을 취소합니다.
zooop tasks get <task-id> --wait- zooop upload
이미지, 비디오, 오디오 파일을 업로드하고 URL을 출력합니다.
zooop upload ./clip.mp4- zooop describe
이미지를 재사용 가능한 프롬프트로 변환합니다(1크레딧).
zooop describe @./reference.jpg- zooop logout
저장된 키를 서버에서 취소하고 로컬에서도 삭제합니다.
zooop logout
예시
하나를 복사하고 zooop models에서 찾은 모델 ID로 바꾼 뒤 실행하세요.
텍스트로 이미지 생성
와이드스크린 이미지를 생성해 ./renders에 저장합니다.
zooop run --model <model-id> --version <version-id> \ -p prompt="a neon-lit rainy Tokyo alley, cinematic" \ -p aspect_ratio=16:9 --out ./renders이미지로 비디오 생성
로컬 사진에 움직임을 줍니다. 파일이 먼저 업로드되며, 입력 이름은 zooop models에서 확인할 수 있습니다.
zooop run --model <model-id> --version <version-id> \ -p prompt="slow push-in, hair moving in the wind" \ -p image_url=@./portrait.jpg -p duration=5갤러리 템플릿 실행
템플릿을 고르고 사진을 넣으세요.
zooop templates --type videozooop run --template <slug> -p 'image_urls=["@./me.jpg"]' --out ./results스크립트로 일괄 생성
여러 프롬프트를 한 번에 대기열에 넣고 jq로 작업 ID를 모읍니다.
for subject in "red fox" "snow owl" "arctic hare"; do zooop run --model <model-id> --version <version-id> \ -p prompt="$subject, studio photo" --no-wait --json | jq -r .taskIddonezooop tasks --status running기본부터 안전하게
CLI는 실제 크레딧을 사용하므로 키와 비용을 신중하게 다룹니다.
- 셸 기록에 키가 남지 않습니다
- 브라우저 로그인으로 키가 CLI에 바로 전달됩니다. 붙여넣을 필요가 없고, 키는 본인만 읽을 수 있는 파일에 저장됩니다.
- 모든 키에는 한도가 있습니다
- 각 CLI 키는 30일, 90일 또는 365일 후 만료되고 프로젝트 하나에만 연결되며, 승인할 때 일일 크레딧 한도를 설정할 수 있습니다.
- 가격부터 확인
- zooop quote는 실행 전에 정확한 크레딧 비용과 예상 소요 시간을 알려 줍니다.
- 재시도해도 두 번 결제되지 않습니다
- 실행마다 멱등성 키가 붙기 때문에 24시간 안에 같은 명령어를 다시 실행하면 다시 과금하지 않고 기존 작업을 반환합니다.
자주 묻는 질문
ZOOOP AI CLI란 무엇인가요?
ZOOOP의 무료 커맨드라인 클라이언트입니다. 터미널이나 스크립트에서 AI 이미지, 비디오, 오디오를 생성할 수 있으며, 웹 앱과 같은 모델과 크레딧을 사용합니다.
실행하려면 무엇이 필요한가요?
macOS, Linux 또는 Windows에서 Node.js 18.17 이상과 ZOOOP 계정이 필요합니다. 패키지에는 다른 의존성이 없습니다.
어떤 모델을 사용할 수 있나요?
ZOOOP 공개 API의 모든 모델을 사용할 수 있습니다. GPT Image, Nano Banana 같은 이미지 모델, Seedance, Kling, Wan 같은 비디오 모델, 그리고 음성 합성, 음성 복제, 효과음, 음악용 오디오 모델이 있습니다. 최신 목록은 zooop models로 확인하세요.
비용은 얼마인가요?
CLI 자체는 무료입니다. 생성할 때마다 웹사이트와 같은 크레딧이 들며, zooop quote로 실행 전에 정확한 가격을 확인할 수 있습니다.
CI나 스크립트에서 사용할 수 있나요?
네. 로그인 대신 ZOOOP_API_KEY를 설정하고, 기계가 읽을 수 있는 출력이 필요하면 --json을 추가한 뒤 종료 코드를 확인하세요. 0은 성공, 1은 API 또는 작업 실패, 2는 사용법 오류입니다.
로그아웃하거나 액세스를 취소하려면 어떻게 하나요?
zooop logout을 실행하면 키가 취소되고 컴퓨터에서 삭제됩니다. API 키 페이지에서 취소할 수도 있습니다. 취소된 키는 어디에서도 작동하지 않습니다.
ZOOOP 에이전트 스킬과 무엇이 다른가요?
CLI는 사용자 본인을 위한 도구로, 명령어를 직접 입력하거나 자신의 스크립트에서 호출할 수 있습니다. 스킬은 Claude Code나 Codex 같은 AI 에이전트가 대화 중에 ZOOOP를 사용하도록 알려 줍니다.