MiniMax H3 参考槽位规划

适用场景

在 MiniMax H3 的 T2VA、I2VA、FL2VA、L2VA 或参考生成任务中，为脱敏的图片、视频和音频建立稳定的 <Subject N>、<Picture N>、<Video N>、<Audio N> 标签，并检查引用角色是否与任务模式相符。

前置条件

• - Python 3.9 或更高版本
• 一份不含原始媒体路径、账号和密钥的 JSON 资产清单
• 已确定的 H3 任务模式和每个资产的角色

输入与输出

输入包含 project_id、mode 和 assets。每项资产包含脱敏 asset_id、kind、role 和可选的 display_name。输出目录生成 reference_registry.json 与 reference_registry.md，提供稳定标签、角色、任务类型提示和错误信息。

安装或导入

保持技能目录结构，直接运行 scripts/build_reference_registry.py。只依赖 Python 标准库。

执行步骤

CODEBLOCK0

脚本按输入顺序为同类资源编号；同一个 asset_id 不会重复分配标签。keyframe 只能绑定图片，source_video 只能绑定视频，audio_reference 只能绑定音频。

错误恢复

脚本以非零退出码停止并列出字段级原因。修正媒体类型、角色或任务模式后重新运行；不要在注册表失败时手工改标签继续写提示词。

权限、隐私与不可逆边界

只读取脱敏标识和媒体角色，不读取原始媒体、不上传、不调用模型、不读取密钥，也不创建或删除用户文件。标签注册表只是提示词准备资产，实际任务仍由用户人工确认。

验收方法

运行示例输入，确认生成的标签稳定且角色合法。将 keyframe 资产的 kind 改为 video，确认脚本以退出码 1 阻断。