PixVerse CLI: 개발자를 위한 AI 비디오 및 이미지 생성 도구

소개

모든 크리에이티브 워크플로우에는 병목 지점이 있습니다. 코드 에디터를 벗어나 브라우저를 열고 웹 인터페이스에서 직접 클릭하며 미디어를 생성해야 하는 순간이 바로 그것입니다. 개발자, AI 에이전트, 자동화된 콘텐츠 파이프라인을 구축하는 모든 사람에게 이러한 컨텍스트 전환은 빠르게 누적되는 마찰입니다.

PixVerse CLI는 그 병목 지점을 제거합니다. PixVerse의 공식 커맨드라인 인터페이스로, PixVerse 플랫폼의 모든 모델, 모든 기능, 모든 기능을 터미널에서 직접 사용할 수 있습니다. 텍스트-투-비디오, 이미지-투-비디오, 텍스트-투-이미지, 립싱크 음성, 사운드 이펙트, 업스케일링 — 모두 스크립트로 작성 가능하고, 파이프라인으로 연결 가능하며, 브라우저를 열지 않고도 사용할 수 있습니다.

PixVerse CLI를 특히 강력하게 만드는 것은 설계 철학입니다. AI 에이전트를 염두에 두고 구축되었습니다. 모든 명령은 구조화된 JSON을 출력하고, 모든 종료 코드는 결정론적이며, 모든 파이프라인 단계는 조합 가능합니다. 즉, Claude Code, Cursor, Codex 또는 다른 에이전트에게 이미지와 비디오를 생성하도록 가르칠 수 있으며, 에이전트들은 매번 올바르게 수행합니다.

이 가이드는 설치부터 첫 번째 생성까지, 그리고 다단계 자동화 파이프라인과 에이전트 네이티브 워크플로우까지 전체 여정을 안내합니다.

사전 요구 사항

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

• Node.js 20 이상 — node --version으로 확인
• PixVerse 계정 — pixverse.ai에서 가입
• 활성 PixVerse 구독 — CLI는 웹사이트와 동일한 크레딧 시스템을 사용하며, 구독한 사용자만 콘텐츠를 생성할 수 있습니다

PixVerse CLI는 API 키를 수동으로 복사할 필요가 없습니다. 인증은 브라우저 기반 OAuth 플로우를 통해 처리되며 토큰이 로컬에 저장됩니다.

1단계: CLI 설치

npm으로 전역 설치합니다:

npm install -g pixverse

설치를 확인합니다:

pixverse --version

전역으로 설치하지 않으려면 npx를 통해 명령을 실행할 수도 있습니다:

npx pixverse create video --prompt "화성을 걷는 고양이"

2단계: 인증

로그인 명령을 실행합니다:

pixverse auth login

CLI가 짧은 URL과 코드를 출력합니다. 브라우저에서 URL을 열고 코드를 입력한 후 PixVerse 계정으로 승인합니다. 토큰은 ~/.pixverse/에 자동으로 저장되며 30일간 유효합니다.

로그인 상태와 사용 가능한 크레딧을 확인하려면:

pixverse auth status
pixverse account info

account info 명령은 구독 등급, 남은 크레딧, 일일 크레딧 초기화 일정을 표시합니다. 배치 작업을 실행하기 전에 항상 잔액을 확인하십시오.

3단계: 첫 번째 이미지 생성

텍스트-투-이미지 생성은 설정을 테스트하는 가장 빠른 방법입니다. 다음을 실행합니다:

pixverse create image --prompt "황금빛 시간대의 포토리얼리스틱 숲길" --json

--json 플래그는 구조화된 출력을 반환합니다:

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "황금빛 시간대의 포토리얼리스틱 숲길",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

더 높은 해상도 출력을 위해 이를 지원하는 모델을 지정합니다:

pixverse create image \
  --prompt "황금빛 시간대의 포토리얼리스틱 숲길" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json

PixVerse는 각각 다른 해상도 한도와 강점을 가진 여러 이미지 모델을 지원합니다:

생성된 이미지를 다운로드하려면:

pixverse asset download 789012

4단계: 첫 번째 비디오 생성

텍스트-투-비디오도 동일한 방식으로 작동합니다. 5초 클립을 생성합니다:

pixverse create video --prompt "바다 파도 위의 석양" --json

완전히 커스터마이징된 생성을 위해:

pixverse create video \
  --prompt "새벽 안개 낀 산골짜기 위를 나는 시네마틱 드론 샷" \
  --model v5.6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

--audio 플래그는 비디오 콘텐츠에 맞는 AI 생성 주변 사운드를 활성화합니다. --json 플래그는 완료 시 video_url을 반환하여 다운로드 명령이나 파이프라인의 다음 단계로 직접 전달할 수 있습니다.

PixVerse는 다양한 기능을 가진 여러 비디오 모델을 제공합니다:

정적 이미지 애니메이션

사진이나 생성된 이미지를 비디오로 변환하려면 --image 플래그를 제공합니다:

pixverse create video \
  --prompt "장면을 통해 부드러운 바람이 움직입니다" \
  --image ./product-photo.jpg \
  --model v5.6 \
  --quality 1080p \
  --json

로컬 파일 경로나 URL을 전달할 수 있습니다. 로컬 파일은 자동으로 업로드되며 수동 업로드 단계가 필요하지 않습니다.

5단계: 인터랙티브 마법사 실행

처음 탐색하고 있어 모든 사용 가능한 플래그에 익숙하지 않다면, 인수 없이 생성 명령을 실행하여 가이드 마법사로 진입합니다:

pixverse create video
pixverse create image

마법사는 프롬프트, 모델 선택, 품질, 화면 비율, 지속 시간 및 기타 옵션을 단계별로 안내합니다. 스크립팅하기 전에 어떤 매개변수가 사용 가능한지 확인하는 데 유용합니다.

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

이 부분에서 PixVerse CLI는 진정으로 혁신적으로 변합니다. 모든 명령이 구조화된 JSON을 반환하고 결정론적 종료 코드를 사용하기 때문에, 셸 명령을 실행할 수 있는 모든 AI 에이전트가 요청 시 이미지와 비디오를 생성하도록 가르칠 수 있습니다.

PixVerse Skills 설치

PixVerse Skills는 에이전트에게 CLI 사용 방법을 정확히 가르치는 구조화된 스킬 파일 라이브러리입니다. 각 명령이 허용하는 플래그, 어떤 모델이 어떤 매개변수를 지원하는지, 명령을 파이프라인으로 연결하는 방법, 오류를 처리하는 방법이 포함되어 있습니다.

Claude Code 및 스킬 형식을 지원하는 다른 에이전트의 경우 PixVerse 스킬을 직접 추가합니다:

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

Cursor의 경우 스킬은 PixVerse Skills GitHub 저장소의 skills/ 디렉토리에 있으며 에디터에 직접 컨텍스트로 로드할 수 있습니다. Codex 및 LangChain 기반 에이전트의 경우 각 스킬 파일은 에이전트의 시스템 프롬프트에 삽입할 수 있는 독립적인 마크다운입니다.

에이전트에 PixVerse 스킬이 로드되면 다음과 같은 자연어 지시를 할 수 있습니다:

• “이 스크린샷에서 10초짜리 제품 데모 비디오를 생성해”
• “이 블로그 표지 이미지의 16:9 형식 변형 4가지를 만들어”
• “이 다이어그램을 주변 사운드가 있는 5초 설명 클립으로 애니메이션화해”

에이전트는 해당 지시를 올바른 CLI 명령으로 변환하고, JSON 출력을 파싱하며, 폴링과 다운로드를 처리합니다. 수동 개입이 필요하지 않습니다.

Claude Code

Claude Code에서 PixVerse CLI는 에이전트가 자율적으로 사용하는 네이티브 도구가 됩니다. PixVerse 스킬을 로드한 후 모든 작업에 미디어 생성을 직접 포함할 수 있습니다:

머신 러닝에 관한 이 블로그 포스트의 표지 이미지를 생성해,
seedream-5.0-lite 모델을 16:9 형식 1800p로 사용하고,
./assets/cover.webp에 다운로드해줘

Claude Code는 올바른 CLI 명령을 호출하고, JSON 응답에서 이미지 URL을 파싱하며, 지정된 경로에 파일을 다운로드합니다. 코드를 작성하는 동일한 세션 내에서 모두 처리됩니다.

일반적인 Claude Code 워크플로우:

# Claude Code가 지시에 따라 자율적으로 실행합니다
IMG=$(pixverse create image \
  --prompt "신경망 레이어의 추상적 시각화, 어두운 배경, 파란색과 보라색 톤" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# 그런 다음 애니메이션화합니다
pixverse create video \
  --prompt "빛나는 신경 연결을 가로지르는 느린 패닝" \
  --image "$IMG" \
  --model v5.6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

Cursor 사용자는 PixVerse Skills를 프로젝트 컨텍스트 파일로 로드할 수 있습니다. 관련 스킬 파일을 .cursor/ 디렉토리에 배치하거나 워크스페이스 규칙에 추가합니다. 로드되면 Cursor는 모든 PixVerse CLI 명령을 완전히 인식하고 코딩 작업의 일부로 미디어를 생성할 수 있습니다.

일반적인 Cursor 워크플로우: 에이전트에게 구축 중인 디자인을 기반으로 목업 이미지를 생성하도록 요청한 다음, 에디터를 벗어나지 않고 IDE 세션에서 직접 참조로 사용합니다.

Codex 및 기타 에이전트

PixVerse CLI는 셸 명령을 실행하고 JSON을 파싱할 수 있는 모든 에이전트와 호환됩니다. 구조화된 출력 형식(일관된 필드 이름, 예측 가능한 오류 코드, stderr로 분리된 오류 메시지)은 간단한 스크립팅 에이전트도 생성을 안정적으로 통합할 수 있도록 합니다.

종료 코드 규약으로 오류 처리가 간단합니다:

자동화 파이프라인

개별 명령을 이해하면 PixVerse CLI는 사용자 개입 없이 완전히 실행되는 강력한 다단계 워크플로우를 활용할 수 있습니다.

텍스트에서 이미지로, 이미지에서 비디오로

가장 유용한 파이프라인 중 하나: 텍스트 프롬프트에서 고해상도 이미지를 생성한 다음 비디오로 애니메이션화합니다.

# 1단계: 기본 이미지 생성
IMG_RESULT=$(pixverse create image \
  --prompt "밤의 사이버펑크 도시 경관, 젖은 포장도로에 반사되는 네온 불빛" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)
 
IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')
 
# 2단계: 비디오로 애니메이션화
VID_RESULT=$(pixverse create video \
  --prompt "카메라가 네온 불빛 거리를 천천히 패닝합니다" \
  --image "$IMAGE_URL" \
  --model v5.6 \
  --quality 1080p \
  --duration 8 \
  --json)
 
VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')
 
# 3단계: 최종 비디오 다운로드
pixverse asset download "$VIDEO_ID" --json

전체 비디오 프로덕션 파이프라인

완성도 높은 출력을 위해 생성과 후처리 단계를 연결합니다:

# 1단계: 기본 비디오 생성
RESULT=$(pixverse create video \
  --prompt "슬로우 모션으로 조립되는 제품" \
  --model v5.6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# 2단계: 지속 시간 연장
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "조립 시퀀스 계속" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# 3단계: 주변 사운드 추가
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "산업용 작업장 분위기, 부드러운 기계 소리" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# 4단계: 1080p로 업스케일
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# 5단계: 다운로드
pixverse asset download "$FINAL" --json

배치 생성

여러 변형이 필요한 콘텐츠 파이프라인의 경우 병렬로 작업을 실행합니다:

# 먼저 크레딧 확인
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "사용 가능한 크레딧: $CREDITS"
 
# 4개의 병렬 생성 제출
pixverse create video --prompt "산 위로 솟아오르는 일출" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "바다 위의 석양" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "사막 위의 별" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "얼어붙은 호수 위의 오로라" --no-wait --json > /tmp/v4.json &
wait
 
# 각각 기다리고 다운로드
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와 함께 즉시 반환하여 폴링 전에 여러 작업을 제출할 수 있습니다. pixverse task wait 명령은 적응형 폴링을 처리합니다. 수동 sleep 루프가 필요하지 않습니다.

기본값 설정

동일한 모델, 품질 또는 화면 비율을 일관되게 사용한다면, 매번 플래그를 반복하지 않도록 기본값으로 설정합니다:

pixverse config defaults set --mode video --model v5.6 --quality 1080p --aspect-ratio 16:9
pixverse config defaults set --mode image --model seedream-5.0-lite --quality 1800p
pixverse config set output-dir ~/Downloads/pixverse

커맨드라인 플래그는 항상 설정된 기본값을 재정의하므로, 반복을 줄이면서도 완전한 유연성을 유지할 수 있습니다.

구축 가능한 것들

에이전트 워크플로우에 PixVerse CLI를 통합하면 자동화 가능한 작업의 범위가 크게 확장됩니다:

• 문서화 — 문서 빌드 프로세스의 일부로 제품 데모 비디오 및 스크린샷 자동 생성
• 마케팅 — 단일 프롬프트 라이브러리에서 소셜 미디어 콘텐츠 변형을 생성하는 야간 배치 작업 실행
• 앱 개발 — UI를 구축하는 동안 코딩 에이전트가 플레이스홀더 시각 자료, 목업 애니메이션 또는 로딩 화면 비디오 생성
• 콘텐츠 파이프라인 — CLI 호출을 다른 도구(ffmpeg, ImageMagick, 클라우드 스토리지)와 연결하여 완전 자동화된 미디어 프로덕션 워크플로우 구축
• 프로토타이핑 — 전체 프로덕션에 투자하기 전에 아이디어를 검증하기 위해 몇 초 만에 빠른 모션 컨셉 생성

CLI는 모든 셸 기반 워크플로우에 자연스럽게 맞도록 설계되었습니다. 기존 자동화가 bash, Python, Node 또는 CI/CD 파이프라인에서 실행된다면 PixVerse CLI는 추가적인 통합 오버헤드 없이 적용됩니다.

시작하기 체크리스트

• Node.js 20 이상 설치
• npm install -g pixverse 실행
• pixverse auth login 실행 및 브라우저에서 승인
• pixverse account info 실행으로 크레딧 확인
• 첫 번째 이미지 생성: pixverse create image --prompt "..." --json
• 첫 번째 비디오 생성: pixverse create video --prompt "..." --json
• 에이전트용 PixVerse Skills 설치 (Claude Code, Cursor 또는 Codex)
• pixverse config defaults set으로 기본 설정 구성
• 첫 번째 자동화 파이프라인 구축

다음 단계

npm의 PixVerse CLI(npm install -g pixverse)를 통해 모든 생성 기능에 즉시 접근할 수 있습니다. PixVerse Skills 저장소는 AI 에이전트에게 모든 컨텍스트에서 해당 기능을 올바르게 사용하는 방법을 가르치는 구조화된 스킬 파일을 제공합니다.

신뢰할 수 있는 CLI와 에이전트 친화적인 스킬 라이브러리의 조합은 이미지 및 비디오 생성이 이제 코드와 동일한 워크플로우 내에 있을 수 있음을 의미합니다. 도구를 전환하지 않고, 동일한 에디터에서, 동일한 에이전트가 관리합니다.

단 하나의 명령으로 시작하여 그 위에 구축하십시오.