如何配好 Toonflow 模型供应商：文本、图像、视频模型接入完整指南
【免费下载链接】Toonflow-appToonflow 是一款 AI 短剧漫剧工具，能够利用 AI 技术将小说自动转化为剧本，并结合 AI 生成的图片和视频，实现高效的短剧创作。借助 Toonflow，可以轻松完成从文字到影像的全流程，让短剧制作变得更加智能与便捷。项目地址: https://gitcode.com/HBAI-Ltd/Toonflow-app
Toonflow 是一款把小说自动改编成短剧、漫剧的 AI 工具：导入文本后由 AI 产出剧本与分镜，再生成角色图、场景图，最终合成视频。整条链路能否顺畅，关键在模型配置是否到位——即把文本、图像、视频三类模型正确接入并验证通过。本文以一次真实配置过程为主线，说明供应商怎么接、字段怎么填、测试怎么跑，以及哪里最容易卡住。
配置不通，通常会卡在哪几个点
第一次配置时，新手卡住的地方往往不在模型本身，而在链路的某一环：供应商加了但开关没打开；模型虽然在模板里，却没手动添加；密钥复制时带了多余前缀导致鉴权失败；供应商脚本少了某个导出项，保存时直接报错。把这几类断点先想清楚，后续操作就是一条直线，不必反复回头排查。
供应商模板怎么选：三条能力线各由谁供能
Toonflow 的模型接入以**供应商（Vendor）**为单位：一个供应商对应一个模型平台，它下面挂若干具体模型。系统内置了一批现成模板，覆盖 Toonflow 中转平台、火山引擎(豆包)、DeepSeek、MiniMax、可灵、Vidu、OpenAI 标准接口等，文本、图像、视频三类能力都能找到对应入口。选择时按平台能力对齐：如果一个平台同时提供文本、图像、视频（例如中转平台或豆包），只添加一个供应商，三条能力线就都有来源；如果三类能力分散在不同平台，则分别添加。
内置模板清单的导出位置见 packages/providers/index.ts，官方中转平台模板的字段定义可参考 packages/providers/src/media/tfRouter.ts，其中已写明请求地址与 API 密钥两个字段。
字段怎么填：文本、图像、视频模型的差异
供应商只是承载单元，真正被调用的是其下的模型。进入设置中心 → 模型服务添加供应商时，默认账号为admin/ 密码admin123；先打开供应商的调用开关，再手动添加模型（模板一般预置常用模型，平台上新模型需完整复制名称填入）。不同类别的模型要填的字段并不相同：
| 配置环节 | 界面里要填 / 核对的内容 |
|---|---|
| 添加供应商 | 选择内置模板；API 密钥（password 类型）；请求地址（url 类型，部分已预填并锁定） |
| 启用并添加模型 | 打开供应商开关；文本模型填名称与think（是否支持思考）；图像模型声明text/singleImage/multiReference；视频模型声明mode（text、singleImage、startEndRequired首尾帧等）、是否生成音频、各时长对应分辨率 |
| 跑模型测试 | 文本、图像、视频三项分别验证，见下一节 |
| Agent 指定 | 确认各 Agent 调用的模型与所配一致，不一致时点选择改正 |
值得一提的是，这套供应商系统是可编程的：在设置中心里可以直接编辑供应商的 TypeScript 逻辑并即时生效，无需改动源码或重启应用，脚本的编译与校验逻辑位于 apps/server/src/utils/media/provider.ts。
模型测试如何跑通：三类模型各自怎么验证
字段填完不要急着进项目，先用模型测试把链路验通。三类模型的验证方式各不相同：文本测试会让模型调用工具回答一个天气问题，确认对话链路畅通；图像测试会自动下发一张 16:9 四宫格（猫、狗、牛、马）的提示词，能出图即通过；视频测试则自动生成一段 5 秒的测试视频。三项都通过后，才算真正接通。调试接口实现见 apps/server/src/routes/providers/debug/run.ts。
从导入小说到成片：Agent 模型指定与生产链路
模型配齐后，还要给每个处理环节指派对应的模型，类似给岗位发工牌。打开 Agent 配置，确认 ScriptAgent、ProductionAgent 调用的文本模型与你所配的一致，不一致时点击选择改正即可。之后在新项目里选定画风（例如内置的古风写实画风），剧本 Agent 生成结构化剧本与分镜表后进入资产图环节——在左侧下拉框选择已配置的图像模型，批量生成角色与场景图；分镜图回流到工作台后，选择视频模型逐条或批量生成视频，最后拼接导出成片。
官方 Demo 的模型组合可作参考：语言模型 Claude Opus、图像模型 GPT Image 2、视频模型 Seedance 2.0，约 2 小时产出 2 分钟成片，成本约 ¥130。合理搭配不同档位的模型，最终花费差异明显。
配置卡住的常见排查点与成本参考
遇到异常时按以下线索定位，基本能覆盖绝大多数情况：
- 模型下拉列表为空：多为供应商开关未打开，或模型尚未手动添加，先补这两步。
- 提示缺少 API Key：密钥未填，或粘贴时带了
Bearer前缀，重新粘贴并去掉前缀。 - 请求地址报错：文本类地址一般以
/v1结尾；视频类要区分接口版本，例如豆包以/v3结尾。 - 供应商脚本保存报错：脚本必须导出
vendor、textRequest、imageRequest、videoRequest四个对象，缺任意一项都会被拦截并提示原因，对照空模板补齐即可。
成本方面，图像与视频按调用计费，建议先用测试功能确认链路再批量生成，能避免无效消耗。配置完成后即可导入小说，让 Toonflow 把故事一路生成到成片。
【免费下载链接】Toonflow-appToonflow 是一款 AI 短剧漫剧工具，能够利用 AI 技术将小说自动转化为剧本，并结合 AI 生成的图片和视频，实现高效的短剧创作。借助 Toonflow，可以轻松完成从文字到影像的全流程，让短剧制作变得更加智能与便捷。项目地址: https://gitcode.com/HBAI-Ltd/Toonflow-app
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
