PixVerse CLI: สร้างวิดีโอและภาพ AI สำหรับนักพัฒนา
เรียนรู้การติดตั้ง PixVerse CLI สร้างภาพและวิดีโอ AI ครั้งแรก และทำเวิร์กโฟลว์ครีเอทีฟให้เป็นอัตโนมัติใน Claude Code, Cursor และเอเจนต์ AI
บทนำ
ทุกเวิร์กโฟลว์ด้านครีเอทีฟมักมีคอขวดอยู่จุดหนึ่ง — ช่วงเวลาที่คุณต้องออกจากตัวแก้ไขโค้ด เปิดเบราว์เซอร์ และคลิกผ่านหน้าเว็บด้วยตนเองเพื่อสร้างสื่อหนึ่งชิ้น สำหรับนักพัฒนา เอเจนต์ AI และทีมที่กำลังสร้าง pipeline คอนเทนต์แบบอัตโนมัติ การสลับบริบทแบบนี้คือแรงเสียดทานที่สะสมอย่างรวดเร็ว
PixVerse CLI ออกแบบมาเพื่อแก้คอขวดนั้นโดยตรง นี่คือ command-line interface อย่างเป็นทางการของ PixVerse ที่เปิดให้เข้าถึงทุกโมเดล ทุกฟีเจอร์ และทุกความสามารถบนแพลตฟอร์ม PixVerse ได้จากเทอร์มินัลทันที ไม่ว่าจะเป็น text-to-video, image-to-video, text-to-image, lip-sync speech, sound effects หรือ upscaling — ทั้งหมดสคริปต์ได้ ต่อท่อได้ และใช้งานได้โดยไม่ต้องเปิดเบราว์เซอร์
จุดแข็งสำคัญของ PixVerse CLI คือแนวคิดการออกแบบที่คำนึงถึงเอเจนต์ AI ตั้งแต่ต้น ทุกคำสั่งส่งออก JSON แบบมีโครงสร้าง รหัสออกแต่ละแบบเป็น deterministic และทุกขั้นใน pipeline สามารถนำไปประกอบต่อได้ นั่นหมายความว่าคุณสามารถสอน Claude Code, Cursor, Codex หรือเอเจนต์อื่นให้สร้างภาพและวิดีโอแทนคุณได้อย่างแม่นยำสม่ำเสมอ
คู่มือนี้จะพาคุณตั้งแต่การติดตั้ง การสร้างงานครั้งแรก ไปจนถึงการทำระบบอัตโนมัติหลายขั้นตอนและเวิร์กโฟลว์แบบ agent-native
ข้อกำหนดเบื้องต้น
ก่อนเริ่มต้น คุณควรมี:
- Node.js 20 ขึ้นไป — ตรวจสอบด้วย
node --version - บัญชี PixVerse — สมัครได้ที่ pixverse.ai
- แพ็กเกจสมาชิก PixVerse ที่ใช้งานอยู่ — CLI ใช้ระบบเครดิตเดียวกับเว็บไซต์ และผู้ใช้ที่สมัครสมาชิกเท่านั้นที่สร้างคอนเทนต์ได้
PixVerse CLI ไม่ต้องคัดลอก API key ด้วยตนเอง การยืนยันตัวตนทำผ่าน OAuth บนเบราว์เซอร์ และบันทึก token ไว้ในเครื่องอัตโนมัติ
ขั้นตอนที่ 1: ติดตั้ง CLI
ติดตั้งแบบ global ด้วย npm:
npm install -g pixverseตรวจสอบการติดตั้ง:
pixverse --versionหากไม่ต้องการติดตั้งแบบ global คุณสามารถรันผ่าน npx ได้:
npx pixverse create video --prompt "A cat walking on Mars"ขั้นตอนที่ 2: ยืนยันตัวตน
รันคำสั่งเข้าสู่ระบบ:
pixverse auth loginCLI จะเปิดเบราว์เซอร์เพื่อทำ OAuth device authorization คุณยังสามารถคัดลอก URL แล้วไปยืนยันสิทธิ์จากเบราว์เซอร์ใดก็ได้บนอุปกรณ์ใดก็ได้ ซึ่งเหมาะกับสภาพแวดล้อมแบบ SSH หรือ headless โดย token จะถูกบันทึกอัตโนมัติใน ~/.pixverse/ และใช้งานได้ 30 วัน
ตรวจสอบสถานะการล็อกอินและเครดิตคงเหลือ:
pixverse auth status
pixverse account infoคำสั่ง account info จะแสดงแพ็กเกจสมาชิก เครดิตคงเหลือ และรอบรีเซ็ตเครดิตรายวันของคุณ ควรตรวจสอบยอดเครดิตก่อนรันงานแบบแบตช์ทุกครั้ง
ขั้นตอนที่ 3: สร้างภาพแรกของคุณ
การสร้างภาพจากข้อความเป็นวิธีที่เร็วที่สุดในการทดสอบระบบ ให้รัน:
pixverse create image --prompt "A photorealistic forest path at golden hour" --jsonแฟล็ก --json จะส่งคืนผลลัพธ์แบบมีโครงสร้าง:
{
"image_id": 789012,
"status": "completed",
"image_url": "https://...",
"prompt": "A photorealistic forest path at golden hour",
"model": "qwen-image",
"width": 1024,
"height": 1024
}หากต้องการความละเอียดที่สูงขึ้น ให้ระบุโมเดลที่รองรับ:
pixverse create image \
--prompt "A photorealistic forest path at golden hour" \
--model seedream-5.0-lite \
--quality 1800p \
--aspect-ratio 16:9 \
--jsonPixVerse รองรับโมเดลภาพหลายรายการ โดยแต่ละโมเดลมีขีดจำกัดความละเอียดและจุดเด่นต่างกัน:
| โมเดล | ความละเอียดสูงสุด | เหมาะกับงาน |
|---|---|---|
qwen-image | 1080p | สร้างเร็ว ใช้งานทั่วไป |
gpt-image-2.0 | 2160p | งานครีเอทีฟความละเอียดสูงหลายรูปแบบ |
seedream-5.0-lite | 1800p | ภาพครีเอทีฟรายละเอียดสูง |
seedream-4.5 | 2160p | ความละเอียดสูงพิเศษ |
gemini-3.1-flash (Nano Banana 2) | 2160p | ช่วงความละเอียดกว้างและรวดเร็ว |
gemini-3.0 (Nano Banana Pro) | 2160p | คุณภาพสูงในงานสเกลใหญ่ |
gemini-2.5-flash (Nano Banana) | 1080p | เบาและตอบสนองเร็ว |
kling-image-o3 | 2160p | งานภาพสไตล์เฉพาะและจัดเฟรมยืดหยุ่น |
kling-image-v3 | 1440p | สมดุลระหว่างคุณภาพและความเร็ว |
ดาวน์โหลดภาพที่สร้างแล้ว:
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 เมื่อสร้างเสร็จ เพื่อนำไปใช้กับคำสั่งดาวน์โหลดหรือขั้นตอนถัดไปใน pipeline ได้ทันที
PixVerse มีโมเดลวิดีโอหลายแบบที่รองรับความสามารถต่างกัน:
| โมเดล | คุณภาพสูงสุด | ช่วงความยาว | หมายเหตุ |
|---|---|---|---|
v6 | 1080p | 1–15 sec | โมเดลมาตรฐานของ PixVerse รองรับอัตราส่วนภาพหลากหลาย |
pixverse-c1 | 1080p | 1–15 sec | รองรับเวิร์กโฟลว์วิดีโอและงานอ้างอิงได้ดี |
v5.6 | 1080p | 1–10 sec | รองรับโหมดสร้างแบบ motion-control |
veo-3.1-standard | 2160p | 4, 6, 8 sec | รองรับทั้งวิดีโอและเวิร์กโฟลว์ทรานซิชัน |
grok-imagine | 720p | 1–15 sec | รองรับ create video, extend และ reference |
sora-2-pro | 1080p | 4, 8, 12 sec | ผลลัพธ์คุณภาพสูงพร้อมตัวเลือกความยาวคงที่ |
ทำภาพนิ่งให้เคลื่อนไหว
หากต้องการแปลงภาพถ่ายหรือภาพที่สร้างไว้แล้วให้เป็นวิดีโอ ให้ใช้แฟล็ก --image:
pixverse create video \
--prompt "Gentle wind moves through the scene" \
--image ./product-photo.jpg \
--model v6 \
--quality 1080p \
--jsonคุณสามารถส่งเป็นพาธไฟล์ในเครื่องหรือ URL ก็ได้ ไฟล์ในเครื่องจะอัปโหลดให้อัตโนมัติ ไม่ต้องมีขั้นตอนอัปโหลดแยก
ขั้นตอนที่ 5: ใช้ Interactive Wizard
ถ้าคุณกำลังทดลองครั้งแรกและยังไม่คุ้นเคยกับแฟล็กทั้งหมด ให้รันคำสั่งสร้างโดยไม่ใส่อาร์กิวเมนต์เพื่อเข้าสู่ wizard แบบแนะนำ:
pixverse create video
pixverse create imagewizard จะพาคุณเลือก prompt, โมเดล, คุณภาพ, อัตราส่วนภาพ, ระยะเวลา และตัวเลือกอื่นแบบทีละขั้น ซึ่งเหมาะสำหรับสำรวจพารามิเตอร์ก่อนนำไปเขียนสคริปต์
นอกเหนือจากการสร้าง: จัดการไฟล์และเวิร์กสเปซ
PixVerse CLI รุ่นล่าสุดยังมีคำสั่งสำหรับงานจัดการที่ช่วยให้สร้างเวิร์กโฟลว์ปลายทางถึงปลายทางบนเทอร์มินัลได้สะดวก:
pixverse task status <id>และpixverse task wait <id>สำหรับ polling สถานะงานpixverse asset list|upload|info|download|deleteสำหรับจัดการวงจรชีวิตของไฟล์pixverse saved list|items|new|rename|add|remove|deleteสำหรับโฟลเดอร์บันทึกpixverse workspace list|status|switch|manageสำหรับการทำงานหลายเวิร์กสเปซ
จึงสามารถทำอัตโนมัติได้ครบทั้งการสร้าง การจัดระเบียบ การดาวน์โหลด และการส่งมอบภายในสคริปต์เดียว
สอนเอเจนต์ AI ของคุณให้สร้างสื่อ
นี่คือจุดที่ PixVerse CLI เปลี่ยนวิธีทำงานอย่างชัดเจน เพราะทุกคำสั่งคืนค่า JSON แบบมีโครงสร้างและใช้ exit code ที่ deterministic เอเจนต์ AI ใดก็ตามที่รันคำสั่งเชลล์ได้ ก็สามารถเรียนรู้ให้สร้างภาพและวิดีโอตามคำสั่งได้ทันที
การติดตั้ง PixVerse Skills
PixVerse Skills คือคลังทักษะแบบมีโครงสร้างที่สอนเอเจนต์ให้ใช้ CLI ได้ถูกต้อง ทั้งแฟล็กของคำสั่ง ข้อจำกัดของโมเดล pipeline หลายขั้น และแนวทางจัดการข้อผิดพลาดอย่างรัดกุม
สำหรับ Claude Code และเอเจนต์ที่รองรับรูปแบบ skills ให้เพิ่ม PixVerse skills ได้โดยตรง:
npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generatorสำหรับ Cursor, Claude Code, Codex และเฟรมเวิร์กเอเจนต์อื่น skill นี้ช่วยเพิ่มความน่าเชื่อถือเพราะให้ข้อกำหนดที่ชัดเจนกับเอเจนต์ แทนการเดาเงื่อนไขเองทั้งหมด
เมื่อโหลด PixVerse skills แล้ว คุณสามารถสั่งงานด้วยภาษาธรรมชาติ เช่น:
- “Generate a 10-second product demo video from this screenshot”
- “Create four variations of this blog cover image in 16:9 format”
- “Animate this diagram into a 5-second explainer clip with ambient sound”
- “Generate three 8-second 16:9 promo clips with different camera motions”
เอเจนต์จะถอดความคำสั่งเป็น CLI command ที่ถูกต้อง แยกวิเคราะห์ JSON output และจัดการ polling กับการดาวน์โหลดให้โดยอัตโนมัติ
Claude Code
ใน Claude Code, PixVerse CLI จะเป็นเครื่องมือแบบ native ที่เอเจนต์ใช้งานได้เอง หลังโหลด PixVerse skills แล้ว คุณสามารถรวมการสร้างสื่อไว้ในทุกงานได้ทันที:
Generate a cover image for this blog post about machine learning,
use the seedream-5.0-lite model at 1800p in 16:9 format,
download it to ./assets/cover.webp
Claude Code จะเรียกคำสั่ง CLI ที่ถูกต้อง ดึง image URL จาก JSON response และดาวน์โหลดไฟล์ไปยังพาธที่กำหนด ทั้งหมดในเซสชันเดียวกับที่กำลังเขียนโค้ดของคุณ
ตัวอย่างเวิร์กโฟลว์ 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 1800p \
--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 \
--jsonCursor
ผู้ใช้ Cursor สามารถโหลด PixVerse Skills เป็นไฟล์ context ของโปรเจกต์ได้ โดยวางไฟล์ skill ที่เกี่ยวข้องไว้ใน .cursor/ หรือเพิ่มไว้ใน workspace rules เมื่อโหลดแล้ว Cursor จะเข้าใจคำสั่ง PixVerse CLI ทุกตัวและสร้างสื่อเป็นส่วนหนึ่งของงานโค้ดได้ทันที
เวิร์กโฟลว์ที่พบบ่อยใน Cursor คือให้เอเจนต์สร้างภาพ mockup จากดีไซน์ที่คุณกำลังพัฒนา แล้วนำไปใช้อ้างอิงต่อใน IDE ได้เลยโดยไม่ต้องออกจาก editor
Codex และเอเจนต์อื่น
PixVerse CLI ใช้ร่วมกับเอเจนต์ใดก็ได้ที่รันคำสั่งเชลล์และแยกวิเคราะห์ JSON ได้ รูปแบบ output ที่มีโครงสร้าง — ชื่อฟิลด์คงที่ รหัสข้อผิดพลาดคาดการณ์ได้ และข้อความผิดพลาดที่แยกผ่าน stderr — ช่วยให้แม้แต่เอเจนต์สคริปต์แบบง่ายก็เชื่อมต่อการสร้างสื่อได้อย่างเสถียร
สัญญาเรื่อง exit code ช่วยให้การจัดการข้อผิดพลาดตรงไปตรงมา:
| Code | Meaning | Agent Action |
|---|---|---|
| 1 | General error | Check stderr and retry with validated inputs |
| 0 | Success | Parse JSON output |
| 2 | Timeout | Retry with longer --timeout |
| 3 | Auth expired | Re-run pixverse auth login |
| 4 | Out of credits | Check balance, notify user |
| 5 | Generation failed | Try different parameters |
| 6 | Validation error | Review flag values |
Automation Pipelines
เมื่อเข้าใจคำสั่งพื้นฐานแต่ละตัวแล้ว PixVerse CLI จะเปิดทางให้ทำเวิร์กโฟลว์หลายขั้นตอนที่ทรงพลัง โดยรันได้ทั้งหมดแบบไม่ต้องให้ผู้ใช้โต้ตอบ
Text to Image to Video
หนึ่งใน pipeline ที่ใช้งานบ่อยที่สุดคือสร้างภาพความละเอียดสูงจาก text prompt แล้วทำให้กลายเป็นวิดีโอ:
# 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" --jsonFull Video Production Pipeline
หากต้องการผลลัพธ์ที่สมบูรณ์มากขึ้น ให้เชื่อมขั้นตอนสร้างเข้ากับ post-processing:
# Step 1: Create the base video
RESULT=$(pixverse create video \
--prompt "A product being assembled in slow motion" \
--model v6 \
--quality 720p \
--duration 5 \
--json)
VID=$(echo "$RESULT" | jq -r '.video_id')
# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
--video "$VID" \
--prompt "Continue the assembly sequence" \
--duration 5 \
--json | jq -r '.video_id')
pixverse task wait "$EXTENDED" --json
# Step 3: Add ambient sound
WITH_SOUND=$(pixverse create sound \
--video "$EXTENDED" \
--prompt "Industrial workshop ambience, soft mechanical sounds" \
--json | jq -r '.video_id')
pixverse task wait "$WITH_SOUND" --json
# Step 4: Upscale to 1080p
FINAL=$(pixverse create upscale \
--video "$WITH_SOUND" \
--quality 1080p \
--json | jq -r '.video_id')
pixverse task wait "$FINAL" --json
# Step 5: Download
pixverse asset download "$FINAL" --jsonBatch Generation
สำหรับ pipeline คอนเทนต์ที่ต้องทำหลายเวอร์ชัน ให้ส่งงานแบบขนาน:
# Check credits first
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Available credits: $CREDITS"
# 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
# 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 จะส่งงานแล้วคืนค่า task ID ทันที ทำให้ส่งหลายงานต่อเนื่องก่อน polling ได้ และคำสั่ง pixverse task wait จะดูแล adaptive polling ให้เองโดยไม่ต้องเขียน sleep loop
ตั้งค่า Defaults
ถ้าคุณใช้โมเดล คุณภาพ หรืออัตราส่วนภาพเดิมซ้ำๆ ควรตั้งค่าเป็นค่าเริ่มต้นเพื่อลดการพิมพ์แฟล็กซ้ำ:
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แฟล็กบน command line จะ override ค่า default ที่ตั้งไว้เสมอ คุณจึงยังคงยืดหยุ่นได้เต็มที่พร้อมลดงานซ้ำ
สิ่งที่คุณสามารถสร้างได้
เมื่อผสาน PixVerse CLI เข้ากับเวิร์กโฟลว์เอเจนต์ งานที่ทำอัตโนมัติได้จะขยายขึ้นอย่างมาก:
- Documentation — สร้างวิดีโอเดโมสินค้าและสกรีนช็อตอัตโนมัติเป็นส่วนหนึ่งของกระบวนการ build เอกสาร
- Marketing — รันงานแบตช์ทุกคืนเพื่อสร้างคอนเทนต์โซเชียลหลายเวอร์ชันจากคลัง prompt เดียว
- App development — ให้ coding agent สร้างภาพ placeholder, mockup animation หรือวิดีโอ loading screen ระหว่างที่คุณพัฒนา UI
- Content pipelines — เชื่อม CLI กับเครื่องมืออื่น เช่น ffmpeg, ImageMagick และ cloud storage เพื่อสร้างระบบผลิตสื่ออัตโนมัติครบวงจร
- Prototyping — สร้างแนวคิดการเคลื่อนไหวได้ภายในไม่กี่วินาทีเพื่อทดสอบไอเดียก่อนลงทุนผลิตจริง
CLI ถูกออกแบบให้เข้ากับเวิร์กโฟลว์ที่ใช้เชลล์ได้อย่างเป็นธรรมชาติ หากระบบอัตโนมัติเดิมของคุณอยู่บน bash, Python, Node หรือ CI/CD pipeline ก็สามารถเพิ่ม PixVerse CLI ได้ทันทีโดยมี overhead ต่ำ
เช็กลิสต์เริ่มต้นใช้งาน
- ติดตั้ง 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)
- ตั้งค่า default ที่ต้องการด้วย
pixverse config defaults set - สร้าง automation pipeline แรกของคุณ
อัปเดต CLI ให้ทันสมัย
ใช้งาน npm เพื่ออัปเดต CLI ในเครื่อง:
npm update -g pixverseสำหรับความเปลี่ยนแปลงระดับรีลีสและโมเดลใหม่ที่รองรับ ให้ตรวจสอบ changelog อย่างเป็นทางการ:
ขั้นตอนถัดไป
PixVerse CLI บน npm (npm install -g pixverse) ช่วยให้เข้าถึงความสามารถด้านการสร้าง การ polling งาน การจัดการไฟล์ โฟลเดอร์บันทึก และการควบคุม workspace ได้ทันทีจากอินเทอร์เฟซเดียว ขณะที่ PixVerse Skills repository ช่วยเพิ่มคำแนะนำพร้อมใช้สำหรับเอเจนต์ ทำให้ Claude Code, Cursor, Codex และเครื่องมืออื่นรันเวิร์กโฟลว์เหล่านี้ได้เสถียรยิ่งขึ้น
เมื่อรวม CLI ที่เชื่อถือได้เข้ากับคลัง skills ที่พร้อมสำหรับเอเจนต์ การสร้างภาพและวิดีโอจะอยู่ในเวิร์กโฟลว์เดียวกับโค้ดของคุณได้ทันที — ใช้เอเจนต์ตัวเดิม เทอร์มินัลเดิม และไม่ต้องสลับเครื่องมือ
เริ่มจากคำสั่งเดียว แล้วค่อยต่อยอดจากตรงนั้น