自定义模型是千鹿 AI 画布提供的第三方 API 接入能力，您可以接入外部第三方模型服务，在画布节点中调用第三方模型生成图片、文本、视频内容。
一、前置须知：哪些节点支持自定义模型
只有下列节点支持添加、调用自定义模型，其余节点暂不支持：
1、图片生成节点
2、视频生成节点
3、文本生成节点
4、图片列表生成节点
5、文本列表生成节点
二、可接入的模型清单
温馨提示：清单为行业标准模型名称，部分第三方 API 平台存在自定义命名。接入时，请以您所用 API 平台内展示的模型标识为准填写。
图片模型：GPT Image 2.0、Nano Banana、Nano Banana 2、Nano Banana Pro、Seedream 5.0 Lite、Seedream 5.0 Pro
视频模型：Seedance 2.5、Seedance 2.0、Seedance 2.0 Mini、Seedance 2.0 Fast、Seedance 1.5 Pro、MiniMax H3、HappyHorse 1.1、Kling o3、Vidu Q3 Turbo
文本模型：Gimini 3.1 Pro、Gimini 3.1 Flash
三、接入自定义模型的操作步骤
1、画布内选中上面任意一个支持自定义模型的节点，打开节点操作面板；
2、在面板中打开模型列表下拉菜单；
3、点击【添加自定义模型】，弹出配置弹窗；
4、提前前往第三方 API 平台注册账号，准备好 3 项必填参数：API 地址、API Token、模型标识；
5、在弹窗表单依次填入获取到的 API 地址、API Token、模型标识，选择性填写自定义名称便于记忆；
6、勾选【已阅读并同意《自定义模型使用协议》】，点击保存，完成自定义模型添加。
安全提示：添加成功后，您的 API Token 将永久加密保存，保障密钥安全。
四：参数名词释义（填写遇到疑问时查阅）
1、API 地址：
第三方服务商提供的接口请求网址，千鹿画布通过该地址转发生成请求。
以 火山方舟 API 为例：
兼容 Anthropic 接口协议：API 地址为 https://ark.cn-beijing.volces.com/api/compatible
兼容 OpenAI 接口协议：API 地址为 https://ark.cn-beijing.volces.com/api/v3
（以上示例 API 地址为 2026 年 7月 29日 获取的火山方舟 API 地址，本文档更新可能存在延迟，如您接入的是火山方舟 API 平台请查看最新官方文档获取准确地址）
2、API Token：
您在第三方平台的身份调用密钥，等同于接口通行证，请妥善保管，不要对外泄露。
以 火山方舟 API 为例：登录火山方舟在控制台中可以找到您的 API Token。
3、模型标识：
服务商后台识别 AI 模型的专属 ID。
⚠️重点区分：模型标识 ≠ 对外宣传的模型名称，直接填写宣传名称大概率调用失败。
注意事项
1、高频错误：讲对外宣传的模型名称填入 “模型标识”，正确应该是复制第三方平台生成的专属模型部署 ID
2、复制参数时附带多余的空格、换行可能导致识别错误，粘贴前请清理无效字符
3、API Token 过期、第三方账号无调用权限、账号余额不足，请自行查看您的 API 账号
4、找不到自定义模型入口：可能是您未选择支持自定义模型的节点
