{
  "$schema": "https://docs.vuumake.com/schemas/visual-template.schema.json",
  "id": "h3-character-consistency",
  "version": "1.0.0",
  "name": "角色一致性与参考图控制",
  "name_i18n": {
    "en": "Reference & Character Consistency",
    "zh-CN": "角色一致性与参考图控制"
  },
  "description": "用最多 9 图 + 3 视频 + 3 音频参考锁定角色容貌、服饰、材质与声音，跨镜头保持一致，是长篇/系列内容的基础能力。",
  "type": "style",
  "category": "character-consistency",
  "tags": [
    "video",
    "minimax-h3",
    "character-consistency",
    "scene:多场景延续同一角色",
    "scene:系列内容跨集一致",
    "character:参考图锁定五官",
    "character:参考图锁定服饰/材质",
    "lighting:跨镜头光影统一",
    "genre:系列短剧",
    "genre:虚拟主播",
    "camera:多镜头覆盖同一角色不同景别",
    "action:跨镜头动作延续",
    "editing:前后对照剪辑",
    "editing:跨集连续性检查",
    "story:角色贯穿多个场景/多集",
    "sound:角色专属音色延续",
    "caption:角色姓名条统一样式"
  ],
  "prompt": {
    "template": "Reference assignment — Image 1: {{ref_image_1_role}}. Image 2: {{ref_image_2_role}}. Image 3: {{ref_image_3_role}}. {{video_ref_note}} {{audio_ref_note}} Scene: {{scene_description}}. {{character_name}} must retain identical face, hairstyle, wardrobe and voice across this shot. {{action_description}}, {{camera_style}}, {{lighting_mood}}, {{duration}}s, {{resolution}}.",
    "negative": "identity drift, wardrobe change, voice mismatch, inconsistent proportions, watermark",
    "system": "MiniMax H3 generation parameters — duration: 8s, resolution: 2560x1440, fps: 24, native stereo audio (cannot be disabled), multi_shot: false, seed_strategy: fixed. Reference slots — image: 最多 9 张：分别指定面部/服饰/材质/场景用途；video: 最多 3 段：运镜或动作参考；audio: 最多 3 段：音色/口音参考."
  },
  "variables": [
    {
      "name": "ref_image_1_role",
      "type": "string",
      "label": "参考图1用途",
      "default": "character face"
    },
    {
      "name": "ref_image_2_role",
      "type": "string",
      "label": "参考图2用途",
      "default": "wardrobe / outfit"
    },
    {
      "name": "ref_image_3_role",
      "type": "string",
      "label": "参考图3用途",
      "default": "scene / product"
    },
    {
      "name": "video_ref_note",
      "type": "string",
      "label": "视频参考说明",
      "default": ""
    },
    {
      "name": "audio_ref_note",
      "type": "string",
      "label": "音频参考说明",
      "default": ""
    },
    {
      "name": "character_name",
      "type": "string",
      "label": "角色名",
      "required": true
    },
    {
      "name": "scene_description",
      "type": "multiline",
      "label": "场景描述",
      "required": true
    },
    {
      "name": "action_description",
      "type": "multiline",
      "label": "动作描述",
      "required": true
    },
    {
      "name": "camera_style",
      "type": "string",
      "label": "运镜",
      "default": "medium shot, slight push-in"
    },
    {
      "name": "lighting_mood",
      "type": "string",
      "label": "光影",
      "default": "consistent with reference images"
    },
    {
      "name": "duration",
      "type": "number",
      "label": "时长(秒)",
      "default": 8
    },
    {
      "name": "resolution",
      "type": "enum",
      "label": "分辨率",
      "options": [
        "2560x1440",
        "768p"
      ],
      "default": "2560x1440"
    }
  ],
  "models": [
    "minimax-h3"
  ],
  "outputs": [
    "video"
  ],
  "aspect_ratios": [
    "16:9",
    "9:16",
    "1:1"
  ],
  "examples": [
    {
      "inputs": {
        "ref_image_1_role": "character face",
        "ref_image_2_role": "wardrobe / outfit",
        "ref_image_3_role": "scene / product",
        "video_ref_note": "",
        "audio_ref_note": "",
        "character_name": "Nova",
        "scene_description": "科技感发布会舞台",
        "action_description": "从侧幕走出，向观众挥手示意",
        "camera_style": "medium shot, slight push-in",
        "lighting_mood": "consistent with reference images",
        "duration": 8,
        "resolution": "2560x1440"
      },
      "note": "canonical example：GenPack 用这组变量渲染 h3_prompt_skeleton 后运行一次生成"
    }
  ],
  "source": {
    "origin": "original",
    "author": "VuuMake",
    "retrieved_at": "2026-08-08"
  },
  "license": "CC-BY-4.0",
  "commercial_use": true,
  "attribution": {
    "required": true,
    "text": "Style by VuuMake, CC-BY-4.0"
  },
  "status": "draft",
  "monetization": {
    "mode": "free"
  }
}