千鹿AI画布接入 MiniMax H3 API：从创建密钥到生成视频

完整操作只有 5 个环节：千鹿AI画布的自定义模型入口可以接入 MiniMax H3。整个流程只需要对齐四项信息：API 地址、API Token、模型标识和自定义名称。保存后，在视频节点里选中这套模型，就能提交一条 H3模型视频生成任务。

立即使用千鹿AI画布：【点击进入直接使用】；

邀请码：【6d8tgs】，立领100算力，体验更多功能噢！

开始前准备好两项内容：一个可以正常使用的千鹿AI画布，以及一个已登录并具有可用按量付费资源的 MiniMax 开放平台账号。API Key 是调用凭证，相关的任何截图、录屏或公开文档都不能展示完整内容。

在千鹿画布打开自定义模型表单

进入需要制作视频的项目，打开对应的视频节点，再展开底部的模型列表。录屏中可验证的路径是：选择一项名称右侧带“自定义”标记的模型，随后会打开自定义模型配置表单。

在打开的表单中会看到四个字段：

Key 创建后要立即复制并存放在安全位置。MiniMax 官方明确提醒，API Key 不应共享，也不应暴露在浏览器代码、截图或公开教程中。如果一条 Key 曾经完整出现在录屏或截图里，应先删除旧 Key，再创建一条新的 Key。

MiniMax 的按量付费 API Key 与 Token Plan 的订阅 Key 不是同一个入口。接入 H3 前，要确认使用的是当前 H3 API 页面要求的凭证，并检查账户资源是否可用。

打开 MiniMax H3 的“创建视频生成任务”文档，核对下面两项：

API 地址：https://api.minimaxi.com/v2/video_generation
模型标识：MiniMax-H3

官方 HTTP 示例使用 Authorization: Bearer API_key。在当前千鹿表单中，只需要把 Key 本体粘贴到 API Token 字段，不要复制文档里的 <token> 占位符。

按下面的对应关系填写：

勾选自定义模型使用协议后点击“保存”。保存成功后，关闭表单并重新打开视频节点的模型列表，应该能看到刚才的名称，并带有“自定义”标记。录屏中不需要刷新整个页面，新名称就已经出现。

如果模型没有出现，先关闭模型菜单再重新打开；仍然没有时，再刷新页面，并回到自定义模型表单检查必填项和协议勾选状态。

需要改显示名称时，不要把“重命名”和“覆盖原模型”当成同一件事。按本次录屏，将“自定义名称”改成 minimaxh3 后保存，列表里新增了 minimaxh3 · 自定义，原来的自定义模型仍然保留。也就是说，这次实测更接近“用新名称保存一套配置”；

在视频节点中选中刚刚保存的 minimaxh3，加入本次需要的图片、视频、音频或文字参考，再填写视频描述。画面示例选择了 自适应 · 768P · 5s，这只是一次具体设置展示，不是所有项目的固定参数。

MiniMax H3 当前官方接口支持 768P 或 2K、4—15 秒；可选比例和参考素材组合会随生成模式变化。实际提交时，以千鹿节点当前显示的可选项和项目素材为准。

点击生成后，不要因为短时间没有结果就反复提交。H3 是异步任务：接口先创建任务，再等待处理完成。结果节点出现后，打开视频预览，确认视频可以从头播放到结尾。

结果节点出现只能证明画布收到了视频结果，不能单独证明扣费金额、调用次数或后台任务状态。需要核对费用时，应回到 MiniMax 控制台查看同一时间段的真实用量或账单。

先检查 API Token 是否复制完整、是否多了空格，以及这条 Key 是否仍然有效。不要把 <token>、引号或整段 Bearer 示例一起粘贴进千鹿的 API Token 字段。若 Key 曾被公开，直接删除旧 Key 并重新创建。

不一定。H3 采用异步生成，排队和处理都需要时间。先等待当前任务返回，再检查 MiniMax 账户资源、接口地址、模型标识和千鹿任务状态。官方常见错误中，402 表示余额不足，429 表示请求过于频繁。

不需要。这只是本次节点中使用的示例。官方 H3 接口当前支持 768P/2K 和 4—15 秒，文生视频、首尾帧和多模态参考的比例规则也不同，应按素材与发布用途选择。