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

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