| name | vidgen-character |
| description | STAGE 2 của pipeline vidgen — tạo NHÂN VẬT + BỐI CẢNH NHẤT QUÁN cho video AI: char sheet → ảnh anchor (T2I flow-agent, miễn phí) → location anchor (khoá bối cảnh, Grid Method 3×3) → upload lấy media_id → gen 1 clip thử → GATE character lock. Dùng khi cần "tạo nhân vật cho video", "anchor nhân vật", "char sheet", "khoá bối cảnh", "nhân vật/bối cảnh bị đổi giữa các cảnh", "giữ nhân vật giống nhau", hoặc khi vidgen-flow gọi STEP 2. |
Vidgen Character (char sheet → anchor → character lock)
Nguyên lý (chi tiết + bằng chứng: references/consistency-and-ai-tells.md): char sheet cho
NGƯỜI duyệt danh tính, anchor cho MÁY bám theo. Nạp nhầm char sheet vào Flow → AI tưởng đám
đông, trộn mặt. Giữ nhất quán bằng ẢNH-anchor (đã verify nguồn chính thức Google), KHÔNG bằng
mô tả chữ hay seed (lối "tả chi tiết = nhất quán" đã bị bác). Ảnh T2I miễn phí — gen tới khi ưng.
PY=~/.venv/claude/bin/python
GEN=.agents/skills/vidgen-clips/scripts/flowgen.py
Bước 1 · MASTER DESIGN SHEET (cho người duyệt — bản thể hiện thị giác của bảng element)
Mỗi nhân vật CHÍNH → gen 1 master design sheet bằng T2I — 1 lần render nên mọi biến thể
cùng ánh sáng/style/tỉ lệ (ưu điểm cốt lõi của sheet). Nội dung chuẩn (theo mẫu đã chốt 07-12):
turnaround đủ góc (front · 3/4-front trái/phải · trái · phải · lưng) + expressions (6-8
biểu cảm) + poses đặc trưng + accessories/hero-prop + color palette + companion
(nhân vật phụ đi kèm nếu có) + close-up chi tiết (mắt, hoạ tiết áo):
$PY $GEN t2i --prompt "character design sheet for <tên>, <desc EN>: full turnaround (front, \
3/4 front left, 3/4 front right, left side, right side, back), 6 facial expressions, key poses, \
accessories laid out separately, color palette swatches, close-up details, consistent outfit \
and lighting across all views, plain background, <style chung của dự án>" \
--aspect landscape --out projects/<tên>/02_characters/<id>_sheet.png
User duyệt danh tính (mặt, trang phục, palette, vibe) TRÊN SHEET trước — sửa ở đây rẻ nhất; sheet
đã duyệt = nguồn sự thật thị giác cho GATE 1A2 (elements.md trỏ tới) và chuẩn so chéo ở GATE 2.
Sheet TUYỆT ĐỐI không nạp vào Flow làm reference (nhiều hình/ảnh → Veo trộn mặt, verify 3-0);
expressions/poses cũng KHÔNG anchor hoá — biểu cảm là việc của emotion/action per shot.
Bước 2 · Anchor (cho máy)
MỌI nhân vật xuất hiện mặt-rõ (medium trở gần) hoặc lặp ≥2 cảnh đều phải có entry + anchor —
KHÔNG phân biệt chính/phụ. Bài học đo được (bé Tuệ An): mẹ/bà cụ/các em chỉ là chữ trong action
→ mỗi generation Veo bịa một người khác — chính là nguồn "chi tiết lệch" lớn nhất. flowgen qc-storyboard (nhóm THỰC THỂ) bắt nhân vật mồ côi; đám đông/người nền thì KHÔNG anchor, viết
action né mặt (turned away / silhouette / out of focus).
Nhân vật CHÍNH → ĐỦ GÓC theo turnaround của master sheet (front · 3q_front_left ·
3q_front_right · left · right · back — nhất quán với luật location 9 góc, mandate chất lượng:
shot đổi góc mà thiếu anchor góc đó là Veo tự bịa). Nhân vật phụ ít cảnh → tối thiểu front + side.
Gen TỪNG anchor riêng (KHÔNG cắt từ sheet — độ phân giải ô sheet thấp), dùng ảnh hero/sheet đã
duyệt làm --ref để anchor bám đúng thiết kế:
$PY $GEN t2i --prompt "<desc EN>, front view, standing, plain white background, \
full body, single character, <style chung>" --aspect portrait \
--ref <media_id ảnh hero đã upload> \
--out projects/<tên>/02_characters/<id>_front.png
Đặt angle đúng tên góc (front/3q_front_left/.../back) — flowgen _pick_anchor chọn anchor
khớp angle của shot.
Yêu cầu anchor: 1 người/ảnh · 1 góc · nền trơn · rõ mặt · style đồng bộ giữa mọi anchor.
Lệnh in ra media_id → ghi ngay vào characters[].anchors[] trong manifest.
Ảnh có sẵn (user đưa) thì upload: $PY $GEN upload-image path.png → lấy media_id.
Đồng bộ ngược desc theo anchor: nếu anchor sinh chi tiết ngoài desc (vd ông cầm gậy tre)
mà bạn muốn giữ → cập nhật characters[].desc cho khớp anchor. Desc là nguồn sự thật đưa vào
prompt mọi cảnh; lệch anchor sẽ làm các cảnh sau mâu thuẫn với nhân vật.
Bước 2b · Location anchor — KHOÁ BỐI CẢNH (chống "mỗi cảnh một kiểu quán")
Nhân vật giữ mặt nhờ anchor; bối cảnh cũng cần anchor — nếu không, cùng "quán cà phê" mỗi cảnh
Veo vẽ một kiểu (đổi cửa sổ, đổi bàn ghế, đổi ánh sáng). Với mỗi locations[] trong manifest:
Grid Method 3×3 (nguồn: CinematicHubClone) — gen NHIỀU góc bối cảnh trong 1 lần render, nên
cùng ánh sáng/chi tiết → đồng nhất tuyệt đối, lại rẻ (1 credit thay vì 9). Dùng làm sheet duyệt:
$PY $GEN t2i --prompt "3x3 grid of 9 frames of THE SAME location from different angles \
(wide, corner, over-the-shoulder, low, high...), <location desc EN>, no people, \
consistent lighting and props across all 9 frames, <style chung>" \
--aspect landscape --out projects/<tên>/02_locations/<id>_grid.png
Rồi gen từng location anchor riêng (KHÔNG người, style chung) để lấy media_id cho máy bám —
ĐỦ 9 GÓC theo grid ngay từ đầu (wide/corner/reverse/left/right/high/low/detail/entrance —
bám sát 9 ô của grid đã duyệt, mỗi góc 1 lệnh t2i, đặt angle đúng tên góc):
$PY $GEN t2i --prompt "<location desc EN>, wide establishing view, no people, \
consistent props, <style chung>" --aspect landscape \
--out projects/<tên>/02_locations/<id>_wide.png
Yêu cầu location anchor: KHÔNG có người · nền/bối cảnh đầy đủ · style + ánh sáng đồng bộ.
Vì sao đủ 9 từ đầu (đã chốt, mandate chất-lượng-trước-credit): cảnh dùng góc THIẾU anchor →
Veo tự bịa layout từ chữ → nhà cửa/hàng cây mỗi cảnh một kiểu; ảnh miễn phí, chỉ tốn công duyệt.
Bước 2c · Hero-prop anchor — KHOÁ ĐẠO CỤ (props[] registry)
Đạo cụ lặp ≥2 cảnh phải có entry trong props[] (desc chuẩn — compiler lặp nguyên văn, hết
"mỗi cảnh tả bát cháo một kiểu"). Trong đó hero-prop (gần camera / mang nghĩa truyện, vd củ
khoai) PHẢI có ảnh anchor:
$PY $GEN t2i --prompt "<prop desc EN>, product still, plain neutral background, \
single object, <style chung>" --aspect square --out projects/<tên>/02_props/<id>.png
Ghi media_id vào props[].anchor. Prop GẮN BỐI CẢNH (nồi trên bếp, chum nước) → đừng anchor
riêng, BAKE thẳng vào ảnh location anchor (Veo neo theo, không tốn slot ref).
Neo TỈ LỆ tại đây: scale vật-với-vật dựng trong location anchor (vd cây khổng lồ cạnh
người) được Veo bảo toàn qua mọi cảnh. Muốn tỉ lệ lệch-thực NHẤT QUÁN theo style archetype
(vidgen-clips/references/veo-prompt-craft.md mục 2b) → bake sẵn vào anchor, đừng chỉ dựa prompt keyword (dễ trôi).
Ghi media_id vào locations[].anchors[]. Cảnh trỏ scenes[].location: "<id>" → flowgen dùng
location anchor + character anchor cùng lúc làm ref (tổng ≤ 3 ref/prompt), compiler lặp nguyên văn
desc bối cảnh vào [Context].
Scene-as-asset (CinematicHubClone): gom tối đa hành động vào CÙNG một location để đỡ vỡ
consistency; đổi location thì chuyển qua yếu tố môi trường (mây → mây phủ rừng), đừng nhảy đột ngột.
Bước 3 · Clip thử (đốt credit NHỎ trước khi đốt LỚN)
Nguyên lý — clip thử là PHÉP THĂM DÒ NĂNG LỰC engine ở tầng đắt nhất, KHÔNG phải "cảnh đại diện trung bình".
Ranh giới ảnh→video có giả định ngầm nguy hiểm: "ảnh T2I gen được thì clip I2V cũng gen được" — SAI.
Veo có safety/giới hạn riêng ở tầng VIDEO mà tầng ảnh không lộ (đã gặp: clip trẻ em + đói bị chặn
MEDIA_GENERATION_STATUS_FAILED dù ảnh gen bình thường). Vì vậy chọn cảnh RỦI RO CAO NHẤT của dự án
làm clip thử — nội dung nhạy cảm nhất (trẻ em/bạo lực/đau khổ/y tế) hoặc tương tác/chuyển động phức tạp nhất.
Cảnh khó nhất qua được thì phần còn lại gần như chắc qua; nó chặn thì biết NGAY (1 credit) thay vì vỡ giữa
batch (chục credit). Đừng chọn cảnh phong cảnh/tĩnh cho "chắc ăn" — chắc ăn kiểu đó là tự lừa.
Dự án có cảnh coverage (shots[], timestamp prompting): clip thử NÊN là (hoặc kèm) MỘT cảnh
coverage — đã kiểm chứng nội bộ 1 mẫu nhưng 1 mẫu ≠ khái quát, mỗi dự án vẫn đo thật TRƯỚC khi cả
batch đặt cược vào nó. Soi: có cắt đúng mốc không? các cú có giữ nhân vật/ánh sáng nội tại không?
Không đạt → hạ cảnh đó về 1 cú hoặc chuyển đường master→regen (scene-grammar.md §6b).
Dự án có cảnh composite (composite:true, cảnh đông thực thể): clip thử PHẢI kèm 1 cảnh đi
đường compose-frame → i2v — đường composite CHƯA kiểm chứng thật trên engine này; soi khung
composite giữ đúng mặt TỪNG nhân vật (không trộn), rồi clip i2v có giữ tiếp không.
Dự án shot-first (workflow v2 — mặc định dự án mới): clip thử PHẢI kèm 1 cảnh ≥2 shot đi trọn
đường master → derive → stitch — kỹ thuật derive (ảnh shot con ref frame master) CHƯA kiểm
chứng thật; soi: shot con giữ đúng không gian/ánh sáng master? mặt vẫn khớp anchor gốc? bản stitch
cắt nội cảnh có mượt không?
Gen thử cảnh rủi ro nhất có nhân vật:
$PY $GEN scene-images --project projects/<tên> --scene <id>
$PY $GEN scene-clips --project projects/<tên> --scene <id> --force
Soi clip thử: nhân vật giống anchor? style đúng? chuyển động tự nhiên? AI-tell (thừa ngón,
mặt biến dạng)?
Bước 4 · GATE 2 (character lock)
Trình user: char sheet + anchors + clip thử. Tự-QC craft trước khi trình (xem
references/consistency-and-ai-tells.md) — chạy checklist ở góc tìm lỗi, rồi nêu thẳng
điểm yếu còn lại thay vì xin gật (phản biện gate: ../vidgen-script/references/decision-grilling.md),
vd "frame nào của clip thử LỆCH anchor nhất — chấp nhận được không?":
☐ anchor 1-người/1-góc/nền trơn/rõ mặt ☐ clip thử giữ mặt khớp anchor qua các frame
☐ không AI-tell (thừa ngón, méo mặt, morphing) ☐ style đồng bộ giữa mọi anchor.
☐ tỉ lệ vật-với-vật khớp style archetype? (tả thực = đúng đời thực; cách điệu = lệch có chủ đích, không phải lỗi).
☐ duyệt anchor theo LÔ — so CHÉO style toàn bộ: bày MỌI anchor cạnh nhau (nhân vật ×N góc +
location ×9 + hero-prop) trong 1 lượt xem; 1 anchor lệch style (màu, nét vẽ, ánh sáng) = mọi cảnh
dùng nó lệch theo — lỗi nhân bản từ gốc, phải bắt TRƯỚC khi lock, gen lại anchor lệch (miễn phí).
User gật → set gates.character_lock = true.
Từ đây danh tính nhân vật KHÓA — không đổi desc/anchor giữa chừng; đổi = gen lại từ đầu.
Chạy lại / sửa
User chê nhân vật sau khi đã lock → cảnh nào đã gen với anchor cũ phải reset
(image.approved=false, clip.status="pending"), báo rõ chi phí gen lại trước khi làm.
