PixVerse CLI: 터미널에서 AI 비디오와 이미지 생성

PixVerse CLI를 설치해 터미널에서 AI 비디오, 이미지, 음성, 음악을 생성하고 JSON 출력으로 에이전트 워크플로를 자동화하세요.

Product Update •
PixVerse CLI: 터미널에서 AI 비디오와 이미지 생성

소개

모든 크리에이티브 워크플로우에는 병목 현상이 있습니다. 즉, 코드 편집기를 종료하고 브라우저를 열고 웹 인터페이스를 수동으로 클릭하여 미디어를 생성해야 하는 순간입니다. 개발자, AI 에이전트 및 자동화된 콘텐츠 파이프라인을 구축하는 모든 사람에게 이러한 컨텍스트 전환은 빠르게 추가되는 마찰입니다.

PixVerse CLI는 병목 현상을 제거합니다. PixVerse의 공식 명령줄 인터페이스로, 터미널에서 직접 PixVerse 생성 및 작업 공간 워크플로에 액세스할 수 있습니다. 텍스트-비디오, 이미지-비디오, 텍스트-이미지, 이미지-이미지, 전환, 음성 생성, 음악 생성, 참조 비디오, 모션 제어, 템플릿, 업스케일링 및 자산 관리는 모두 스크립트 가능하고 파이프 가능하며 브라우저를 건드리지 않고도 사용할 수 있습니다.

PixVerse CLI가 특히 유용한 이유는 AI 에이전트를 염두에 두고 제작되었다는 디자인 철학 때문입니다. 명령은 --json 또는 -p를 사용하여 구조화된 JSON를 반환할 수 있으며 종료 코드는 결정적이며 모든 파이프라인 단계는 구성 가능합니다. 즉, Claude Code, Cursor, Codex 또는 기타 에이전트에게 더 적은 수의 핸드오프를 통해 사용자를 대신하여 이미지, 비디오, 음성 및 음악을 생성하도록 가르칠 수 있습니다.

이 가이드는 2026년 6월 29일에 확인된 현재 PixVerseAI/cli GitHub README 및 공개 기능 매니페스트와 일치합니다. 모델 가용성, 기본 모델 및 명령 플래그는 에버그린 튜토리얼보다 빠르게 변경될 수 있으므로 프로덕션 스크립트는 대규모 배치 실행 전에 pixverse --version, pixverse create <mode> --help 및 pixverse update를 계속 확인해야 합니다.

전제조건

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

  • 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 "A cat walking on Mars"

2단계: 인증

로그인 명령을 실행하십시오.

pixverse auth login

CLI는 OAuth 장치 인증을 위한 브라우저를 엽니다. 또한 URL을 복사하고 모든 장치의 모든 브라우저에서 인증을 완료할 수 있으며 이는 SSH 및 헤드리스 환경에 유용합니다. 귀하의 토큰은 ~/.pixverse/에 자동으로 저장되며 30일 동안 유효합니다.

로그인했는지 확인하고 사용 가능한 크레딧을 확인하려면:

pixverse auth status pixverse account info pixverse account slots

account info 명령은 구독 계층, 작업 공간 크레딧 및 사용 컨텍스트를 표시합니다. pixverse account usage는 크레딧 소비를 검토하는 데 도움이 되고, pixverse account slots는 이미지 및 비디오 작업에 대한 현재 동시 생성 슬롯을 보여줍니다. CLI 세션은 PixVerse 웹/앱 세션과 독립적이며 pixverse auth logout를 사용하여 저장된 CLI 토큰을 제거할 수 있습니다. 일괄 작업을 실행하기 전에 항상 잔액과 사용 가능한 슬롯을 확인하세요.

빠른 시작 명령

설치부터 생성된 자산까지 최단 경로만 필요한 경우 다음 순서로 시작하세요.

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

에이전트 및 CI 워크플로의 경우 --json 또는 -p를 활성화하여 stdout가 stderr에 유지되는 동안 컴퓨터에서 읽을 수 있는 상태를 유지하도록 합니다. 프로덕션 재시도의 경우 생성 명령에 --idempotency-key <key>를 추가하여 반복 제출로 인해 실수로 중복된 유료 작업이 생성되지 않도록 하세요.

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

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

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

현재 GitHub README에는 GPT Image 2가 기본 이미지 모델로 나열되어 있습니다. 재현 가능한 자동화를 위해 여전히 --model를 명시적으로 설정하고 일괄 작업 전에 실시간 CLI 도움말 또는 capabilities.json를 확인하세요. --json 플래그는 구조화된 출력을 반환합니다.

{ "image_id": 789012, "status": "completed", "image_url": "https://...", "prompt": "A photorealistic forest path at golden hour", "model": "gpt-image-2.0", "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는 각각 서로 다른 해상도 한도와 종횡비를 지원하는 여러 이미지 모델을 지원합니다.

모델--model value품질메모
GPT Image 2gpt-image-2.01080p, 1440p, 2160p기본 이미지 모델 넓고 긴 종횡비를 지원합니다.
Nano Banana 2gemini-3.1-flash512p, 1080p, 1440p, 2160p유연한 auto 및 표준 종횡비
Qwen Imageqwen-image720p, 1080p일반적인 창의적 작업을 위한 빠른 생성
Nano Banana Progemini-3.01080p, 1440p, 2160p더 큰 크기로 고품질 이미지 생성
Nano Bananagemini-2.5-flash1080p빠른 처리로 경량 이미지 생성
Seedream 5.0 Liteseedream-5.0-lite1440p, 1800p, 2160p매우 세밀한 크리에이티브 이미지
Seedream 4.5seedream-4.51440p, 2160p고해상도 이미지 생성
Seedream 4.0seedream-4.01080p, 1440p, 2160p이미지 워크플로를 위한 추가 Seedream 옵션
Kling Image O3kling-image-o31080p, 1440p, 2160p유연한 프레이밍을 갖춘 스타일화된 시각적 출력
Kling Image V3kling-image-v31080p, 1440p품질과 속도의 균형

이미지 대 이미지를 사용하여 기존 이미지를 변환할 수도 있습니다.

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

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

텍스트-비디오도 같은 방식으로 작동합니다. 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는 다양한 품질, 지속 시간 및 모드 지원을 갖춘 여러 비디오 모델을 제공합니다.

모델--model value최대 품질기간메모
PixVerse V6v61080p1~15초기본 비디오 모델 광범위한 종횡비 지원
PixVerse C1pixverse-c11080p1~15초비디오, 참조 및 전환 워크플로 전반에 걸친 강력한 지원
Seedance 2.0 Standardseedance-2.0-standard2160p4~15초비디오, 참조 및 전환 모드 지원
Seedance 2.0 Fastseedance-2.0-fast720p4~15초비디오, 참조 및 전환 모드를 위한 더 빠른 시딩 옵션
Seedance 2.0 Miniseedance-2.0-mini720p4~15초비디오, 참조 및 전환 모드를 위한 경량 시딩 옵션
Happy Horse 1.0happyhorse-1.01080p3~15초create video에 사용 가능한 오디오 인식 비디오 옵션
Kling O3 Prokling-o3-pro720p3~15초비디오, 참조 및 전환 워크플로 지원
Kling O3 Standardkling-o3-standard720p3~15초표준 클링 O3 옵션
Kling 3.0 Prokling-3.0-pro720p3~15초비디오 및 전환 워크플로 지원
Kling 3.0 Standardkling-3.0-standard720p3~15초표준 Kling 3.0 옵션
Grok Imagine 1.5grok-imagine-1.5720p1~15초이미지-비디오 전용; --image가 필요하며 입력 이미지 종횡비를 따릅니다.
Grok Imaginegrok-imagine720p1~15초이전 Grok 옵션; 비디오, 확장 및 참조 워크플로 지원
Veo 3.1 Liteveo-3.1-lite1080p4, 6, 8초비디오 및 2프레임 전환 워크플로우 지원
Veo 3.1 Standardveo-3.1-standard2160p4, 6, 8초고해상도 Veo 옵션
Veo 3.1 Fastveo-3.1-fast2160p4, 6, 8초더 빠른 Veo 옵션
Sora 2 Prosora-2-pro1080p4, 8, 12초고정 기간 소라 옵션
Sora 2sora-2720p4, 8, 12초스탠다드 소라 옵션
PixVerse v5.6v5.61080p1~10초모션 제어 및 선택된 생성 워크플로우에 계속 사용됩니다.
PixVerse v5.5v5.51080p1~10초create modify 워크플로에 사용됩니다.
PixVerse v5v51080p1~10초3개 이상의 프레임 전환 워크플로우에 사용됨

정적 이미지에 애니메이션 적용

사진이나 생성된 이미지를 비디오로 변환하려면 --image 플래그를 제공하세요.

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

로컬 파일 경로나 URL을 전달할 수 있습니다. 로컬 파일은 자동으로 업로드되므로 수동 업로드 단계가 필요하지 않습니다. 1920x1920 또는 5MB보다 큰 로컬 이미지 입력은 업로드하기 전에 자동으로 크기가 조정되거나 압축됩니다. 원격 이미지 URL은 백엔드에서 있는 그대로 검증됩니다.

Grok Imagine 1.5의 경우 이미지가 필요하며 출력 종횡비는 해당 이미지를 따릅니다.

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 # 텍스트에서 음성 오디오 생성 pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3 # 프롬프트에서 음악 생성 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 # 생성된 비디오 확장 pixverse create extend --video <video_id> # 기존 비디오 수정 pixverse create modify --video <video_id> --prompt "Change the background to a beach" # 고급 비디오 해상도 pixverse create upscale --video <video_id> --quality 1080p # 참조 이미지로 비디오 생성 pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park" # Seedance 2.0 레퍼런스는 이미지와 비디오 입력을 혼합할 수 있습니다. pixverse create reference \ --model seedance-2.0-standard \ --images ./character.png \ --videos ./motion.mp4 \ --prompt "@image1 follows the motion in @video1" # Seedance 2.0 모델은 최대 9개의 참조 이미지를 지원합니다. 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" # 캐릭터 이미지와 모션 레퍼런스 영상을 이용한 모션 제어 pixverse create motion-control --image ./character.png --video ./dance.mp4 # 템플릿 또는 효과에서 만들기 pixverse create template --template-id 12345 --image ./photo.png

모든 모델이 모든 생성 모드를 지원하는 것은 아닙니다. 현재 README 매트릭스에서 create video는 v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 및 v5.6를 지원합니다. grok-imagine-1.5는 이미지-비디오 전용이며 --image가 필요합니다. create extend는 v6 및 grok-imagine를 지원합니다. create reference는 v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Kling O3, grok-imagine 및 v5.6를 지원합니다. 2프레임 전환은 최신 비디오 제품군을 지원합니다. 3개 이상의 프레임 전환은 v5를 사용합니다. create modify는 v5.5를 사용합니다. create motion-control는 v5.6를 사용합니다.

5단계: 음성 및 음악 생성

현재 GitHub README는 전용 생성 명령을 통해 독립형 오디오를 문서화합니다. 텍스트 음성 변환에는 create voice를 사용하고 음악 프롬프트 생성에는 create music를 사용합니다. 음성 및 음악 출력은 오디오 자산으로 저장되므로 task로 추적하고, asset list --type audio로 나열하고, asset download --type audio로 다운로드할 수 있습니다. 기본 비디오 분위기를 위해서는 지원되는 비디오 생성 명령에서 --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를 사용하세요. 가사 가능 모델의 경우 가사를 리터럴 텍스트, 로컬 파일 경로 또는 stdin으로 전달합니다.

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를 사용하십시오.

6단계: 대화형 마법사 실행

처음 탐색 중이고 사용 가능한 모든 플래그에 아직 익숙하지 않은 경우 인수 없이 생성 명령을 실행하여 안내 마법사를 시작하세요.

pixverse create video pixverse create image

마법사는 프롬프트, 모델 선택, 품질, 종횡비, 기간 및 기타 옵션을 단계별로 안내하므로 스크립트를 작성하기 전에 사용 가능한 매개변수를 찾는 데 유용합니다.

세대를 넘어: 자산 및 작업 공간 관리

현재 PixVerse 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는 개인 작업 공간을 대상으로 합니다.

스크립트 친화적인 플래그

대부분의 자동화는 예측 가능한 출력과 예측 가능한 런타임 동작에 따라 달라집니다. 이러한 플래그는 스크립트 및 AI 에이전트 워크플로에 특히 유용합니다.

깃발용도
--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를 API 요청에 연결합니다.
--idempotency-key <key>실수로 중복된 유료 작업을 생성하지 않고 생성 요청을 안전하게 재시도

이제 텍스트 입력 플래그를 자동화하기가 더 쉬워졌습니다. --prompt, --text 및 --lyrics는 리터럴 문자열, 로컬 파일 경로 또는 stdin용 -를 허용할 수 있습니다.

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 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, Claude Code, Codex 및 기타 에이전트 프레임워크의 경우 이 기술은 에이전트가 처음부터 강제로 추론하도록 하는 대신 명시적인 제약 조건을 에이전트에 제공하여 안정성을 향상시킵니다.

PixVerse CLI는 또한 dist/capabilities.json에 기계 판독 가능한 소형 명령 매니페스트를 제공하며 공개 소스는 GitHub 저장소에서 capabilities.json로 제공됩니다. 이 매니페스트는 명령, 플래그, 종료 코드, JSON 출력 예상 및 효과 범주를 설명하므로 에이전트는 도움말 텍스트를 스크랩하지 않고도 CLI 계약을 검사할 수 있습니다.

에이전트에 PixVerse 기술이 로드되면 다음과 같은 자연어 지침을 제공할 수 있습니다.

  • “이 스크린샷으로 10초짜리 제품 데모 비디오를 생성하세요”
  • “16:9 형식으로 이 블로그 표지 이미지의 네 가지 변형을 만듭니다.”
  • “이 다이어그램을 주변 소리와 함께 5초 설명 클립으로 애니메이션화”
  • “다양한 카메라 모션을 사용하여 8초짜리 16:9 프로모션 클립 3개를 생성합니다.”

에이전트는 해당 지침을 올바른 CLI 명령으로 변환하고, JSON 출력을 구문 분석하고, 폴링 및 다운로드를 처리하므로 수동 개입이 필요하지 않습니다.

Claude Code

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

Generate a cover image for this blog post about machine learning, use the seedream-5.0-lite model at 2160p in 16:9 format, download it to ./assets/cover.webp

Claude Code는 올바른 CLI 명령을 호출하고, JSON 응답에서 이미지 URL을 구문 분석하고, 지정된 경로에 파일을 다운로드합니다. 이 모든 작업은 코드를 작성하는 동일한 세션 내에서 이루어집니다.

일반적인 Claude Code 작업 흐름:

# 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') # 그런 다음 애니메이션을 적용합니다. pixverse create video \ --prompt "Slow pan across glowing neural connections" \ --image "$IMG" \ --model v6 \ --quality 1080p \ --duration 6 \ --json

Cursor

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

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

Codex 및 기타 에이전트

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

종료 코드 계약을 사용하면 오류 처리가 간단해집니다.

코드의미에이전트 작업
0성공JSON 출력 구문 분석
1일반 오류stderr를 확인하고 검증된 입력으로 다시 시도하세요.
2시간 초과더 긴 --timeout로 다시 시도하세요.
3인증이 만료되었습니다.pixverse auth login를 다시 실행하세요.
4크레딧 부족잔액 확인, 사용자에게 알림
5생성 실패다른 매개변수를 사용해 보세요
6유효성 검사 오류플래그 값 검토

자동화 파이프라인

개별 명령을 이해하면 PixVerse CLI는 사용자 상호 작용 없이 완전히 실행되는 강력한 다단계 작업 흐름을 잠금 해제합니다.

텍스트를 이미지로, 비디오로

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

# 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') # 2단계: 동영상에 애니메이션 적용 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') # 3단계: 최종 비디오 다운로드 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') # 2단계: 기간 연장 EXTENDED=$(pixverse create extend \ --video "$VID" \ --json | jq -r '.video_id') pixverse task wait "$EXTENDED" --json # 3단계: 1080p로 업스케일 FINAL=$(pixverse create upscale \ --video "$EXTENDED" \ --quality 1080p \ --json | jq -r '.video_id') pixverse task wait "$FINAL" --json # 4단계: 다운로드 pixverse asset download "$FINAL" --json # 선택사항: 별도의 음성 해설 자산 생성 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 # 4개의 병렬 세대 제출 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 # 한 번의 일괄 상태 호출에서 반환된 모든 작업 ID를 확인하세요. 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 # 각각 기다렸다가 다운로드하세요. 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>를 추가하세요.

당신이 만들 수 있는 것

PixVerse CLI를 에이전트 워크플로에 통합하면 자동화 가능한 작업 범위가 상당히 확장됩니다.

  • 문서화— 문서 작성 프로세스의 일부로 제품 데모 비디오 및 스크린샷을 자동 생성합니다.
  • 마케팅— 단일 프롬프트 라이브러리에서 소셜 미디어 콘텐츠 변형을 생성하는 야간 일괄 작업 실행
  • 앱 개발— UI를 구축하는 동안 코딩 에이전트가 자리 표시자 시각적 개체, 모형 애니메이션 또는 로딩 화면 비디오를 생성하도록 허용
  • 오디오 워크플로우— 나중에 편집할 수 있도록 음성 해설 초안, 음악 프롬프트 트랙 또는 오디오 자산을 생성합니다.
  • 콘텐츠 파이프라인— 완전히 자동화된 미디어 제작 워크플로를 구축하기 위해 다른 도구(ffmpeg, ImageMagick, 클라우드 스토리지)와 CLI 호출을 연결합니다.
  • 프로토타이핑— 전체 생산에 착수하기 전에 아이디어를 검증하기 위해 몇 초 만에 퀵 모션 컨셉을 생성합니다.

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

시작하기 체크리스트

  • Node.js 20 이상 설치
  • npm install -g pixverse 실행
  • pixverse auth login를 실행하고 브라우저에서 승인
  • pixverse account info를 실행하여 크레딧 확인
  • 동시 일괄 작업 전에 pixverse account slots 실행
  • 첫 번째 이미지 생성: pixverse create image --prompt "..." --json
  • 첫 번째 비디오 생성: pixverse create video --prompt "..." --json
  • 첫 번째 음성 자산 생성: pixverse create voice --text "..." --json
  • 첫 번째 음악 자산 생성: pixverse create music --prompt "..." --json
  • pixverse template list로 템플릿 탐색
  • 에이전트(Claude Code, Cursor 또는 Codex)에 대해 PixVerse Skills를 설치합니다.
  • pixverse config defaults set를 사용하여 원하는 기본값을 설정하세요.
  • 첫 번째 자동화 파이프라인 구축

CLI를 최신 상태로 유지

내장된 업데이트 프로그램을 사용하여 로컬 CLI를 최신 상태로 유지하세요.

pixverse update

npm을 직접 사용할 수도 있습니다.

npm install -g pixverse@latest

릴리스 수준 변경 사항 및 새로 지원되는 모델에 대해서는 공식 CLI 소스를 확인하세요.

현재 문서에서는 PixVerse V6를 기본 비디오 모델로, GPT Image 2를 기본 이미지 모델로, Seedance 2.0 Mini 지원, 모드별 PixVerse v5 및 v5.5 워크플로, 전용 create voice 및 create music 명령, 오디오 자산 관리, 저장된 폴더, 작업 공간 전환, 에이전트를 위한 config defaults, capabilities.json, pixverse update, 텍스트 입력을 위한 stdin 지원을 강조합니다. 보다 안전한 재시도를 위한 --trace-id 및 --idempotency-key.

다음 단계

GitHub의 PixVerse CLI 및 npm(npm install -g pixverse)을 사용하면 단일 인터페이스에서 생성, 작업 폴링, 자산 관리, 템플릿, 저장된 폴더, 계정 확인, 오디오 모델 검색 및 작업 공간 제어에 즉시 액세스할 수 있습니다. PixVerse Skills 저장소에는 에이전트 지원 지침이 추가되어 Claude Code, Cursor, Codex 및 기타 도구가 이러한 워크플로를 더욱 안정적으로 실행할 수 있습니다.

신뢰할 수 있는 CLI와 에이전트 지원 기술 라이브러리의 결합은 이미지, 비디오, 음성 및 음악 생성이 코드와 동일한 워크플로우에서 실행될 수 있음을 의미합니다. 즉, 도구를 전환하지 않고도 동일한 터미널에서 동일한 에이전트에 의해 관리됩니다.

단일 명령으로 시작하십시오. 거기에서 빌드하십시오.