pixelle-video

Pixelle-Video Skill

Tự động tạo video AI từ một chủ đề hoặc đoạn văn bản — script → ảnh AI → voice → BGM → video hoàn chỉnh. Dùng AIDC-AI/Pixelle-Video (REST API, FastAPI, ComfyUI backend).

Prerequisites

Pixelle-Video phải đang chạy trước khi gọi skill này:

# Kiểm tra server có đang chạy không
curl -s http://localhost:8000/api/health | jq .

# Nếu chưa chạy — khởi động bằng Docker
docker compose up -d    # trong thư mục Pixelle-Video

# Hoặc chạy thẳng
pip install -e .
pixelle-video start

Workflow

Step 1 — Xác nhận input từ user

Thu thập 3 thông tin:

• text: Chủ đề hoặc đoạn văn bản nguồn (vd: "Atomic Habits dạy chúng ta thay đổi thói quen nhỏ")
• mode: generate (AI tự viết lời) hoặc fixed (dùng text nguyên)
• n_scenes: Số cảnh, mặc định 5 (1–20)

Nếu user chỉ cung cấp chủ đề ngắn → dùng mode: generate. Nếu user cung cấp script đầy đủ → dùng mode: fixed.

Step 2 — Kiểm tra server health

curl -s http://localhost:8000/api/health

Nếu server không phản hồi → báo user khởi động server, dừng.

Step 3 — Tạo video (async)

curl -s -X POST http://localhost:8000/api/video/async \
  -H "Content-Type: application/json" \
  -d '{
    "text": "<user_text>",
    "mode": "generate",
    "n_scenes": 5,
    "frame_template": "1080x1920/image_default.html",
    "video_fps": 30,
    "bgm_volume": 0.3
  }' | jq .

Ghi lại task_id từ response.

Step 4 — Poll task status

TASK_ID="<task_id_from_step3>"
while true; do
  STATUS=$(curl -s "http://localhost:8000/api/tasks/$TASK_ID" | jq -r '.status')
  echo "Status: $STATUS"
  if [[ "$STATUS" == "completed" || "$STATUS" == "failed" ]]; then break; fi
  sleep 5
done
curl -s "http://localhost:8000/api/tasks/$TASK_ID" | jq .

Step 5 — Lấy kết quả

Khi status = completed, response chứa video_url:

curl -s "http://localhost:8000/api/tasks/$TASK_ID" | jq '{
  video_url: .result.video_url,
  duration: .result.duration,
  file_size: .result.file_size
}'

Download video:

VIDEO_URL=$(curl -s "http://localhost:8000/api/tasks/$TASK_ID" | jq -r '.result.video_url')
curl -L "$VIDEO_URL" -o output_video.mp4
echo "Video saved → output_video.mp4"

Step 6 — Báo cáo kết quả

Trả về cho user:

• Đường dẫn file video đã download
• Thời lượng (duration) + kích thước file
• URL nếu user muốn xem trực tiếp qua browser (http://localhost:8000 + video_url)

Options nâng cao

Param	Mặc định	Mô tả
frame_template	1080x1920/image_default.html	Template kích thước + layout (portrait/landscape)
tts_workflow	default config	Workflow TTS (giọng đọc)
ref_audio	none	Audio mẫu để clone giọng
bgm_path	none	Đường dẫn file nhạc nền tuỳ chỉnh
bgm_volume	0.3	Âm lượng nhạc nền (0.0–1.0)
prompt_prefix	none	Style prefix cho ảnh AI (vd: "cinematic, 4K")
template_params	none	Màu sắc, background tuỳ chỉnh cho template

Ví dụ nhanh

# Video 5 cảnh về thói quen tốt
curl -X POST http://localhost:8000/api/video/async \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Thói quen nhỏ mỗi ngày tạo nên sự khác biệt lớn trong cuộc đời bạn.",
    "mode": "generate",
    "n_scenes": 5,
    "title": "Sức mạnh của thói quen nhỏ"
  }'

Xử lý lỗi

Lỗi	Nguyên nhân	Fix
Connection refused	Server chưa chạy	docker compose up -d
task status: failed	ComfyUI chưa start / thiếu model	Xem log: docker compose logs
Video trống / âm thanh không có	TTS workflow chưa config	Kiểm tra config.yaml → tts_workflow
Ảnh không generate	ComfyUI API key / model chưa cài	Xem README → Image Generation Setup