🎬 AIVI — Hướng dẫn sử dụng

AIVI biến ảnh sản phẩm thành video affiliate dọc 9:16 (24–48 giây): Claude Fable 5.1 phân tích ảnh và viết kịch bản bán hàng, Gemini Image dựng khung hình bối cảnh từ chính sản phẩm, Veo 3.1 làm chuyển động 8 giây/cảnh, Gemini TTS đọc tiếng Việt, ffmpeg ghép và in caption.

Quy trình 3 bước

  1. Ảnh & thông tin — tải 1–8 ảnh sản phẩm rõ nét, điền tên, mô tả, giá/ưu đãi thật, khách hàng mục tiêu, số cảnh. Bấm Tạo kịch bản. Chỉ tốn tiền Claude (~$0.3–0.8).
  2. Kịch bản — xem phân tích, sửa lời đọc (16–22 từ/cảnh), caption (≤7 từ), prompt khung hình & chuyển động. Bấm chip hook để thay lời đọc cảnh 1. "Viết lại theo góp ý" nếu muốn Claude làm lại.
  3. Dựng video — chọn model Veo (Lite rẻ nhất, Fast cân bằng, Standard đẹp nhất), giọng đọc, bấm Dựng video. Mỗi cảnh 1–4 phút, chạy song song. Xong vào tab Kết quả: tải MP4, copy caption + hashtag.
Sửa 1 cảnh rồi bấm Dựng video lại: chỉ cảnh đã sửa được tạo lại, cảnh khác dùng lại → tiết kiệm tiền. Muốn làm mới toàn bộ dùng Dựng lại từ đầu.

Lấy API key

1. Claude (Anthropic)

  1. Vào console.anthropic.com, đăng nhập.
  2. Billing → Add credits: nạp tối thiểu $5 bằng thẻ Visa/Master.
  3. API Keys → Create Key → copy chuỗi sk-ant-api03-....

2. Gemini / Veo (Google)

  1. Vào aistudio.google.com/apikey → Create API key → copy chuỗi AIza....
  2. Bật thanh toán (Veo không có gói miễn phí): bấm Set up Billing trong trang API keys, hoặc console.cloud.google.com/billing → thêm thẻ → gắn vào project chứa key. Cột Plan phải hiện Paid.

3. Điền key lên server

ssh -i ~/.ssh/id_ed25519 root@66.42.54.31
nano /var/www/aivi.click/.env      # điền ANTHROPIC_API_KEY=... và GEMINI_API_KEY=...
cd /var/www/aivi.click && npm run check
pm2 restart aivi

Sau đó bấm Kiểm tra API ở góc trái trang chính để chắc chắn 2 key và 3 model (Veo / Image / TTS) đều hoạt động.

Nếu Claude báo 403/404 với claude-fable-5-1, đổi CLAUDE_MODEL=claude-opus-5 trong .env rồi pm2 restart aivi.

Chi phí tham khảo (10/2026)

Model Veo 3.1720p1 cảnh 8sVideo 4 cảnh
Lite$0.05/s$0.40~$1.6
Fast (mặc định)$0.10/s$0.80~$3.2
Standard$0.40/s$3.20~$12.8

Cộng ~$0.04/cảnh ảnh khung hình, vài cent giọng đọc, ~$0.3–0.8 Claude. Ước tính hiện ngay trong tab Dựng video.

Video affiliate cần gì để ra đơn

Chi tiết và nguồn: file docs/NGHIEN-CUU-VIDEO-AFFILIATE.md trong mã nguồn.

Xử lý lỗi thường gặp

LỗiCách xử lý
Veo 403 / "billing"Project Google chưa bật thanh toán. Gắn thẻ rồi thử lại.
Veo 404 modelGoogle đổi tên model. Bấm Kiểm tra API xem danh sách Veo hiện có, sửa VEO_MODEL trong .env.
Veo 429Hết quota song song. Đặt VEO_CONCURRENCY=1, đợi vài phút.
Veo chặn bởi bộ lọc an toànSửa prompt cảnh đó (bỏ người/trẻ em/da thịt/thương hiệu), lưu rồi dựng lại — chỉ cảnh đó chạy lại.
Sản phẩm trong video khác ảnhDùng ảnh nền trắng rõ nét, thêm mô tả màu/chất liệu; chọn Veo Standard cho cảnh demo quan trọng.
Server khởi động lại giữa chừngBấm Dựng video lại: cảnh đã xong được giữ.