PixVerse CLI: 터미널에서 AI 동영상, 이미지, 음성, 음악 생성하기

확인일: 2026-10-13. Node.js >=22.12가 필요합니다. 기본 이미지 모델은 GPT Image 2.5 Flare이며 기본 동영상 모델은 PixVerse V6입니다. 지원 모델과 설정은 생성 모드에 따라 다르므로 실제 작업 전에 설치된 버전의 capabilities와 공식 README를 확인하세요. README · capabilities.json

pixverse --version
pixverse capabilities create --json
pixverse canvas --help

소개

브라우저 기반 생성 인터페이스는 탐색이나 일회성 프로젝트에는 잘 맞습니다. 하지만 몇 가지 상황에서는 다른 접근 방식이 필요합니다.

PixVerse CLI는 AI 동영상, 이미지, 음성, 음악 생성을 터미널 기반 워크플로에 직접 가져옵니다. 브라우저 인터페이스와 개발 환경을 오가는 대신, 코드를 작성하고 빌드를 실행하고 배포를 관리하는 것과 같은 명령줄에서 AI 콘텐츠를 생성, 관리, 다운로드할 수 있습니다. PixVerse CLI

PixVerse CLI는 바로 이 목록을 중심으로 만들어졌으며, 특히 에이전트 기반 사용 사례에 크게 무게를 두고 설계되었습니다. 명령어는 구조화된 JSON을 반환하고, 종료 코드는 예측 가능하며, 모든 단계는 사람이 UI를 클릭하는 것이 아니라 스크립트나 자율 에이전트가 조합하도록 설계되어 있습니다.

사전 요구 사항

시작하기 전에 다음이 필요합니다.

Node.js 22.12 이상 —— node --version으로 확인
PixVerse 계정 —— pixverse.ai에서 가입
활성화된 PixVerse 구독 —— CLI는 웹사이트와 동일한 크레딧 시스템을 사용하므로, 생성하려면 구독 중인 계정이 필요합니다

API 키를 수동으로 복사해서 붙여넣을 필요는 없습니다. 인증은 브라우저 기반 흐름을 통해 이루어지며 토큰은 로컬에 저장됩니다.

설치

npm으로 CLI를 전역 설치합니다.

npm install -g pixverse

설치가 제대로 되었는지 확인합니다.

pixverse --version

전역 설치를 원하지 않는다면 npx로 필요할 때마다 명령어를 실행할 수도 있습니다.

npx pixverse create video --prompt "A cat walking on Mars"

인증

다음 명령어로 로그인합니다.

pixverse auth login

브라우저 창이 열리며 OAuth 인증이 진행됩니다. SSH로 작업하거나 헤드리스 환경에 있다면, 로그인 흐름에서 다른 기기의 브라우저에 붙여넣어 인증을 완료할 수 있는 URL도 제공됩니다. 인증이 완료되면 토큰은 ~/.pixverse/에 저장되고 30일 동안 유효합니다.

로그인 상태와 사용 가능한 크레딧을 확인합니다.

pixverse auth status
pixverse account info
pixverse account slots
pixverse capabilities canvas --json

account info는 구독 등급과 워크스페이스 크레딧을 보여줍니다. account usage는 크레딧이 어떻게 소비되었는지 세부적으로 나타내고, account slots는 동시에 실행할 수 있는 생성 작업 수를 알려줍니다 —— 배치 작업을 시작하기 전에 확인해 볼 가치가 있습니다. CLI 세션은 브라우저나 앱 세션과 상태를 공유하지 않으므로, CLI에서 로그아웃(pixverse auth logout)해도 다른 세션에는 영향을 주지 않습니다.

빠른 시작

설치부터 첫 결과물까지 최대한 빠르게 진행하고 싶다면 다음 순서를 따르면 됩니다.

npm install -g pixverse
pixverse auth login
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
pixverse create video --prompt "A sunset over ocean waves" --model v6 --quality 720p --duration 5 --json

스크립트나 에이전트 워크플로에서는 --json(또는 축약형 -p)을 항상 켜 두어 표준 출력이 깔끔하고 파싱 가능한 상태를 유지하고, 진행 메시지와 오류는 stderr로 나가도록 하세요. 네트워크 불안정이나 CI 단계 재시도처럼 작업이 두 번 이상 제출될 가능성이 있다면, --idempotency-key <key>를 추가해 중복 과금되는 작업이 실수로 생성되지 않도록 하세요.

이미지 생성하기

텍스트-이미지 생성은 환경이 제대로 설정되었는지 확인하는 가장 빠른 방법입니다.

pixverse create image --prompt "A photorealistic forest path at golden hour" --json

현재 기본 이미지 모델은 GPT Image 2.5 Flare이지만, 반복해서 실행할 계획이라면 기본값에 의존하지 말고 --model을 명시적으로 설정하세요 —— 새 모델이 출시되면 기본값도 바뀔 수 있습니다. --json은 다음 단계로 바로 전달할 수 있는 응답을 반환합니다.

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "A photorealistic forest path at golden hour",
  "model": "gpt-image-2.5-flare",
  "width": 1440,
  "height": 1440
}

더 높은 해상도가 필요하다면 이를 지원하는 모델을 선택하세요.

pixverse create image \
  --prompt "A photorealistic forest path at golden hour" \
  --model seedream-5.0-lite \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json

이미지 모델 라인업은 다양한 사용 사례를 아우릅니다.

pixverse capabilities create image --json
pixverse capabilities create image --model gpt-image-2.5-flare --json

기존 이미지를 다시 입력해서 변환할 수도 있습니다.

pixverse create image \
  --prompt "Turn this product photo into a clean watercolor illustration" \
  --image ./product-photo.png \
  --model gpt-image-2.0 \
  --json

생성된 이미지를 로컬로 다운로드합니다.

pixverse asset download 789012 --type image

동영상 생성하기

텍스트-동영상 생성도 같은 방식입니다. 빠르게 5초짜리 클립을 만들어 봅니다.

pixverse create video --prompt "A sunset over ocean waves" --json

또는 모든 파라미터를 지정한 생성:

pixverse create video \
  --prompt "A cinematic drone shot over a misty mountain valley at dawn" \
  --model v6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

네이티브 오디오를 지원하는 모델에 한해: --audio는 장면에 맞는 AI 생성 환경음을 추가합니다. 생성이 완료되면 JSON 응답에 video_url이 포함되어, 다운로드 단계나 파이프라인의 다음 단계로 바로 전달할 수 있습니다.

동영상 모델은 해상도 상한, 지원하는 길이 범위, 생성 모드 지원 여부에서 상당한 차이가 있습니다.

pixverse capabilities create video --json
pixverse capabilities create reference --model seedance-2.5 --json

Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine, HappyHorse 같은 파트너 모델도 PixVerse에서 선택할 수 있습니다. 같은 CLI에서 PixVerse V6, C1과 비교할 수 있습니다.

정지 이미지를 동영상으로 만들기

--image를 전달하면 사진이나 생성된 이미지를 동영상으로 만들 수 있습니다.

pixverse create video \
  --prompt "Gentle wind moves through the scene" \
  --image ./product-photo.jpg \
  --model v6 \
  --quality 1080p \
  --json

--image는 로컬 파일 경로나 원격 URL을 가리킬 수 있습니다 —— 로컬 파일은 자동으로 업로드되므로 별도의 업로드 단계가 필요 없습니다. 1920×1920 또는 5MB를 초과하는 로컬 이미지는 업로드 전에 자동으로 크기 조정되거나 압축됩니다. 원격 URL은 백엔드에서 있는 그대로 검증됩니다.

Grok Imagine 1.5는 특수한 경우로, --image가 필수이며 출력 종횡비가 원본 이미지의 비율로 고정됩니다.

pixverse create video \
  --prompt "Slow camera push-in, subtle fabric motion, clean native ambience" \
  --image ./campaign-poster.png \
  --model grok-imagine-1.5 \
  --quality 720p \
  --duration 6 \
  --json

레퍼런스, 트랜지션, 모션 컨트롤, 템플릿

단순한 텍스트-동영상, 이미지-동영상을 넘어, CLI는 캐릭터, 키프레임, 효과에 대해 더 정교한 제어가 필요할 때 유용한 몇 가지 전문 생성 모드를 제공합니다.

# Create a transition between keyframes
pixverse create transition --images ./frame1.png ./frame2.png

# Generate speech audio from text
pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3

# Generate music from a prompt
pixverse create music --prompt "A cinematic synth-pop intro with bright percussion" --auto-lyrics
pixverse create music --prompt "Uplifting piano theme for a product reveal" --instrumental --duration-seconds 60

# Extend a generated video
pixverse create extend --video <video_id>

# Modify an existing video
pixverse create modify --video <video_id> --prompt "Change the background to a beach"

# Upscale video resolution to 2160p
pixverse create upscale --video <video_id> --quality 2160p

# Generate video with reference images
pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"

# Seedance 2.0 reference can mix image and video inputs
pixverse create reference \
  --model seedance-2.0-standard \
  --images ./character.png \
  --videos ./motion.mp4 \
  --prompt "@image1 follows the motion in @video1"

# Seedance 2.0 models support up to 9 reference images
pixverse create reference \
  --model seedance-2.0-standard \
  --images ./char1.png ./char2.png ./char3.png ./char4.png \
  --prompt "@image1 and @image2 walk through the scene together"

# Motion control with a character image and motion reference video
pixverse create motion-control --image ./character.png --video ./dance.mp4

# Create from a template or effect
pixverse create template --template-id 12345 --image ./photo.png

음성과 음악 생성하기

독립적인 오디오 생성은 두 개의 전용 명령어로 제공됩니다. create voice는 텍스트-음성 변환용이고, create music은 프롬프트 기반 음악 생성용입니다. 두 명령 모두 결과물을 오디오 애셋으로 저장하므로 task로 추적하고, asset list --type audio로 목록을 확인하고, asset download로 다운로드할 수 있습니다. 동영상에 환경음만 넣고 싶다면 지원되는 동영상 생성 명령어에서 --audio / --no-audio를 사용하세요 —— 이는 독립적인 오디오 명령어와는 별개의 경로입니다.

음성 클립을 생성합니다.

pixverse create voice \
  --text "Welcome to the launch. Here is what changed this week." \
  --model speech-2.8-hd \
  --voice-id <preset_voice_id> \
  --output ./voiceover.mp3 \
  --json

결정하기 전에 사용 가능한 음성 모델과 프리셋 보이스를 확인합니다.

pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --json

음악 트랙을 생성합니다.

pixverse create music \
  --prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
  --auto-lyrics \
  --duration-seconds 30 \
  --json

보컬이 없는 트랙에는 --instrumental을 추가하세요. 가사를 원한다면 --lyrics는 리터럴 텍스트, 로컬 파일 경로, 또는 파이프로 전달되는 표준 입력을 받을 수 있습니다.

pixverse create music \
  --prompt "Uplifting electronic pop with a confident chorus" \
  --lyrics ./lyrics.txt \
  --json

현재 음성 옵션은 MiniMax Speech 2.8과 ElevenLabs 계열을 아우르며, 음악 생성은 현재 MiniMax Music, ElevenLabs Music, Google Lyria 3 Pro에서 제공됩니다. 이러한 라인업은 시간이 지나면서 바뀌므로, 재사용할 계획인 스크립트를 작성하기 전에 pixverse voice models와 pixverse music models를 실행해서 현재 사용 가능한 목록을 확인하세요.

대화형 마법사

아직 어떤 플래그가 있는지 잘 모른다면 인자 없이 생성 명령어를 실행해 보세요.

pixverse create video
pixverse create image

이렇게 하면 프롬프트, 모델, 품질, 종횡비, 길이 및 기타 관련 옵션을 단계별로 안내하는 가이드 마법사가 실행됩니다 —— 스크립트로 옮기기 전에 사용 가능한 플래그를 발견하기 좋은 방법입니다.

애셋과 워크스페이스 관리하기

생성은 전체 그림의 일부일 뿐입니다. CLI는 그 주변의 모든 것을 다루는 관리 명령어도 제공합니다.

pixverse task status <id> 및 pixverse task wait <id> —— 단일 작업 폴링
pixverse task status --ids 123,456,789 --type video --json —— 한 번의 호출로 여러 작업 확인
pixverse asset list, asset upload, asset info, asset download, asset delete —— 동영상, 이미지, 오디오 애셋 전반의 라이프사이클 작업
pixverse saved list, saved items, saved new, saved rename, saved add, saved remove, saved delete —— 저장된 폴더용
pixverse template categories, template list, template search, template info —— 이펙트와 템플릿 탐색
pixverse voice models, voice presets, music models —— 실시간 오디오 모델 검색
pixverse workspace list, workspace status, workspace switch, workspace manage —— 다중 워크스페이스 환경용
pixverse account info, account usage, account slots —— 크레딧, 사용량, 동시성 확인
pixverse config set, config list, config path, config defaults —— 반복 가능한 로컬 설정

이를 조합하면 하나의 스크립트로 생성, 정리, 템플릿 탐색, 다운로드, 워크스페이스 라우팅을 터미널을 떠나지 않고 처리할 수 있습니다. 기본값이 아닌 다른 워크스페이스를 특정 명령어 한 번에 대상으로 하려면 --workspace-id <id>를 추가하세요(개인 워크스페이스는 0).

Canvas 프로젝트와 현재 지원 모델

CLI는 Canvas 프로젝트, 그래프, 노드, 패치, 디스패치 작업을 지원합니다. 프로젝트 자동화 전에 pixverse canvas --help와 pixverse capabilities canvas --json을 확인하세요. Canvas 기능 정보는 로그인 후 서비스에서 조회하고, 생성 기능 정보는 설치된 CLI에 포함됩니다. 필요한 모델이 없으면 CLI를 업데이트하세요.

현재 목록에는 Seedance 2.5, MiniMax H3/H3 Max, FLUX 3, Wan 3.0, Kling 4K, GPT Image 2.5 Flare/Sunburst, Nano Banana 2.1이 포함됩니다. 모델과 모드별 기능을 확인하고 다른 모델의 길이, 오디오, 참조, 해상도 설정을 그대로 재사용하지 마세요.

스크립트에서 알아두면 좋은 플래그

자동화에서는 예측 가능한 출력이 무엇보다 중요합니다. 다음 플래그들은 스크립트와 에이전트 워크플로에서 자주 사용됩니다.

플래그	용도
`--json`	구조화된 JSON 출력 반환
`-p`	`--json`의 축약형
`--count <n>`	한 번의 요청으로 1–4개의 변형 생성
`--seed <number>`	생성 결과를 재현하기 쉽게 만듦
`--off-peak`	가능한 경우 비피크 요금 사용
`--audio` / `--no-audio`	지원되는 동영상 생성 명령어에서 오디오 켜기/끄기
`--multi-shot` / `--no-multi-shot`	동영상의 멀티샷 모드 켜기/끄기
`--no-wait`	대기하지 않고 작업을 제출한 즉시 반환
`--timeout <sec>`	폴링 타임아웃 설정(기본값 300초)
`--workspace-id <id>`	한 번의 명령어에 대해 활성 워크스페이스 재정의
`--trace-id <uuid>`	디버깅을 위해 호출자가 지정한 UUIDv4를 요청에 첨부
`--idempotency-key <key>`	중복 과금 없이 생성 요청을 안전하게 재시도

텍스트 입력 플래그는 이제 인라인 문자열 이상을 받아들입니다. --prompt, --text, --lyrics는 모두 리터럴 문자열, 로컬 파일 경로, 또는 표준 입력을 위한 -를 받을 수 있습니다.

pixverse create video --prompt ./scene.txt --json
cat scene.txt | pixverse create image --prompt - --json
echo "Hello from the command line" | pixverse create voice --text - --json
pixverse create music --prompt "Bright synth-pop" --lyrics ./lyrics.txt --json

AI 에이전트에게 미디어 생성 가르치기

명령줄 자동화 전에 앱에서 에이전트 기반 제작을 체험하고 싶다면 PixVerse Agent로 시작하세요.

바로 여기서 CLI는 단순한 편의 도구에서 능력 배가 장치로 변신합니다. 모든 명령어가 구조화된 JSON을 반환하고 결정론적 코드로 종료되므로, 셸 명령어를 실행할 수 있는 에이전트라면 당신을 대신해 이미지, 동영상, 음성, 음악을 생성하도록 가르칠 수 있습니다.

PixVerse Skills 설치하기

PixVerse Skills는 에이전트가 도움말 텍스트에서 추측하도록 두는 대신, CLI의 플래그, 모델 제약, 다단계 파이프라인, 오류 처리 패턴을 가르치기 위해 만들어진 스킬 라이브러리입니다.

Claude Code와 스킬 형식을 지원하는 다른 도구에서는 다음과 같이 추가합니다.

npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator

로드되면 에이전트는 시행착오로 동작을 추론하는 대신 명확한 제약 조건을 갖고 작업하게 됩니다 —— 이는 Cursor, Claude Code, Codex 등 여러 프레임워크에서의 신뢰성에 큰 영향을 줍니다.

PixVerse Skills가 로드되면, 에이전트에게 다음과 같은 자연어 지시를 내릴 수 있습니다.

“이 스크린샷으로 10초짜리 제품 데모 동영상을 만들어줘”
“이 블로그 커버 이미지의 4가지 변형을 16:9 형식으로 만들어줘”
“이 다이어그램을 환경음이 있는 5초짜리 설명 클립으로 애니메이션화해줘”
“서로 다른 카메라 움직임을 가진 8초짜리 16:9 프로모 클립 세 개를 만들어줘”

에이전트는 이를 올바른 CLI 호출로 변환하고, JSON 응답을 파싱하고, 폴링을 처리하고, 결과를 다운로드합니다 —— 중간에 수동 개입이 필요하지 않습니다.

Claude Code

Claude Code 안에서 CLI는 에이전트가 스스로 사용하는 도구가 됩니다. PixVerse Skills가 로드된 후에는 어떤 작업에도 미디어 생성을 포함할 수 있습니다.

머신러닝 블로그 글의 표지 이미지를 seedream-5.0-lite 모델로 2160p, 16:9로 생성하고 ./assets/cover.webp에 다운로드하세요.

Claude Code는 올바른 명령어를 실행하고, JSON에서 이미지 URL을 추출하고, 지정한 경로에 파일을 저장합니다 —— 이 모든 것이 코드를 편집하는 것과 같은 세션 안에서 이루어집니다.

대표적인 워크플로 예시:

# Claude Code runs this autonomously based on your instruction
IMG=$(pixverse create image \
  --prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \
  --model seedream-5.0-lite \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')

# Then animates it
pixverse create video \
  --prompt "Slow pan across glowing neural connections" \
  --image "$IMG" \
  --model v6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

Cursor 사용자는 관련 PixVerse Skills 파일을 .cursor/ 디렉터리나 작업 공간 규칙에 추가할 수 있습니다. 로드한 뒤 에이전트는 CLI 가이드를 활용해 코딩 작업 중 미디어를 생성할 수 있습니다.

예를 들어 개발 중인 디자인의 목업 이미지를 Cursor에 요청하고 같은 편집기 세션에서 바로 참조할 수 있습니다.

Codex 및 기타 에이전트

셸 명령어를 실행하고 JSON을 파싱할 수 있는 에이전트라면 이 CLI를 구동할 수 있습니다. 일관된 필드 이름, 예측 가능한 오류 코드, stderr로 분리된 오류 메시지 덕분에 단순한 스크립팅 에이전트도 특별한 처리 없이 생성 기능을 통합할 수 있습니다.

종료 코드는 에이전트에게 명확한 의사결정 흐름을 제공합니다.

코드	의미	에이전트의 조치
0	성공	JSON 출력 파싱
1	일반 오류	stderr 확인 후 검증된 입력으로 재시도
2	타임아웃	더 긴 `--timeout`으로 재시도
3	인증 만료	`pixverse auth login` 재실행
4	크레딧 부족	잔액 확인 후 사용자에게 알림
5	생성 실패	다른 파라미터로 시도
6	검증 오류	플래그 값 검토
7	동시 실행 제한	빈 슬롯을 기다린 후 재시도

자동화 파이프라인

개별 명령어에 익숙해지고 나면, 진짜 가치는 아무도 지켜보지 않아도 실행되는 다단계 파이프라인에서 나타납니다.

텍스트에서 이미지로, 그리고 동영상으로

프롬프트에서 고해상도 이미지를 생성한 다음 이를 애니메이션화합니다.

# Step 1: Generate a base image
IMG_RESULT=$(pixverse create image \
  --prompt "A cyberpunk cityscape at night, neon lights reflecting on wet pavement" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)

IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')

# Step 2: Animate it into a video
VID_RESULT=$(pixverse create video \
  --prompt "Camera slowly pans across the neon-lit streets" \
  --image "$IMAGE_URL" \
  --model v6 \
  --quality 1080p \
  --duration 8 \
  --json)

VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')

# Step 3: Download the final video
pixverse asset download "$VIDEO_ID" --json

전체 동영상 제작 파이프라인

더 완성도 높은 결과물을 원한다면, 생성 작업을 후처리와 연결하세요. 지원되는 동영상 모델의 네이티브 사운드로 충분할 때는 --audio 또는 --no-audio를 사용하고, 나중에 결합할 별도의 오디오 애셋이 필요할 때는 create voice나 create music을 활용하세요.

# Step 1: Create the base video
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --audio \
  --json)

VID=$(echo "$RESULT" | jq -r '.video_id')

# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --json | jq -r '.video_id')

pixverse task wait "$EXTENDED" --json

# Step 3: Upscale to 2160p
FINAL=$(pixverse create upscale \
  --video "$EXTENDED" \
  --quality 2160p \
  --json | jq -r '.video_id')

pixverse task wait "$FINAL" --json

# Step 4: Download
pixverse asset download "$FINAL" --json

# Optional: create a separate voiceover asset
pixverse create voice \
  --text "The final reveal starts now." \
  --voice-id <preset_voice_id> \
  --output ./voiceover.mp3 \
  --json

배치 생성

여러 변형이 동시에 필요한 콘텐츠 파이프라인에서는 순차적으로 처리하지 말고 작업을 동시에 실행하세요.

# Check credits and concurrent generation slots first
pixverse account info --json
pixverse account slots --json

# Submit four parallel generations
pixverse create video --prompt "Sunrise over mountains" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Sunset over ocean" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Stars over a desert" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Aurora over a frozen lake" --no-wait --json > /tmp/v4.json &
wait

# Check all returned task IDs in one batch status call
IDS=$(jq -r '.video_id' /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json | paste -sd, -)
pixverse task status --ids "$IDS" --type video --json

# Wait for each and download
for f in /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json; do
  ID=$(jq -r '.video_id' "$f")
  pixverse task wait "$ID" --json
  pixverse asset download "$ID" --json
done

--no-wait는 작업을 제출하고 즉시 작업 ID를 반환하므로, 폴링을 시작하기 전에 여러 작업을 큐에 넣을 수 있습니다. 각 --no-wait --json 응답에서 작업 ID와 확정된 파라미터를 기록해 두세요 —— 이 기록이 나중에 배치 실행을 재현 가능하게 만드는 핵심입니다. 하나의 프롬프트에서 여러 변형이 필요할 때는 --count <n>을 사용하고, 여러 실행 중인 작업을 하나씩 폴링하는 대신 하나의 상태 응답으로 확인하고 싶을 때는 배치용 task status --ids를 활용하세요. pixverse task wait는 적응형 폴링을 알아서 처리해 줍니다.

기본값 설정하기

매번 같은 모델, 품질, 종횡비를 반복해서 지정하고 있다면, 한 번에 설정해 두세요.

pixverse config defaults set video model v6
pixverse config defaults set video quality 1080p
pixverse config defaults set image model seedream-5.0-lite
pixverse config set output-dir ~/Downloads/pixverse
pixverse config defaults show
pixverse config list
pixverse config path

명령줄의 플래그는 항상 설정된 기본값보다 우선하므로, 기본값을 설정해도 유연성이 줄어들지 않습니다. 기본값이 아닌 워크스페이스에 대해 한 번만 실행하려면 평소 기본값 위에 --workspace-id <id>를 추가하세요.

무엇을 만들 수 있을까

CLI를 에이전트나 스크립트에 연결하면 자동화할 수 있는 범위가 상당히 넓어집니다.

문서화 —— 문서 빌드 과정의 일부로 제품 데모 동영상과 스크린샷을 자동 생성
마케팅 —— 하나의 프롬프트 라이브러리에서 매일 밤 배치 작업으로 소셜 콘텐츠 변형을 생성
앱 개발 —— 실제 UI를 구축하는 동안 코딩 에이전트가 자리 표시용 비주얼, 목업 애니메이션, 로딩 화면 동영상을 생성하도록 함
오디오 워크플로 —— 내레이션 초안, 프롬프트 기반 음악 트랙, 후반 편집용 독립 오디오 애셋 생성
콘텐츠 파이프라인 —— CLI 호출을 ffmpeg, ImageMagick, 클라우드 스토리지 도구와 연결해 완전 자동화된 제작 파이프라인 구축
프로토타이핑 —— 전체 제작에 착수하기 전에 아이디어를 검증할 빠른 모션 콘셉트를 몇 초 만에 생성

셸 명령어일 뿐이므로, 이 CLI는 별도의 통합 작업 없이 bash, Python, Node, CI/CD에 그대로 들어맞습니다.

시작 체크리스트

CLI 최신 상태 유지하기

내장 업데이터로 로컬 CLI를 최신 상태로 유지하세요.

pixverse update

또는 npm을 통해 직접 업데이트할 수도 있습니다.

npm install -g pixverse@latest

모델과 플래그는 대부분의 문서보다 빠르게 변화하므로, 릴리스 수준의 변경 사항은 원본 소스에서 직접 확인하세요.

이번 업데이트 기준으로 PixVerse V6은 여전히 기본 동영상 모델이고 GPT Image 2.5 Flare는 기본 이미지 모델이며, Seedance 2.0 Mini, 전용 create voice/create music 명령어, 오디오 애셋 관리, 저장 폴더, 워크스페이스 전환, config defaults, capabilities.json 매니페스트, pixverse update, 텍스트 입력의 표준 입력 지원, --trace-id, --idempotency-key가 모두 현재 도구 세트에 포함되어 있습니다. PixVerse CLI

CLI가 가능하게 하는 것

PixVerse CLI, GitHub, npm(npm install -g pixverse)에서 생성, 작업 확인, 애셋, 템플릿, 음성, 음악, 작업 공간 관리 기능을 제공합니다. PixVerse Skills는 에이전트 사용 가이드를 제공합니다.

CLI와 에이전트 스킬을 결합하면 같은 에이전트와 터미널에서 이미지, 동영상, 음성, 음악을 처리하고 코드 작업 흐름에 포함할 수 있습니다.

명령 하나로 시작하고 점차 작업 흐름을 확장하세요.