TapCanvas 模型配置指南:如何快速接入鲁班 API 多模型网关与 AI 图像视频模型
发布时间:2026/10/31 1:58:36 锦皓数字建站

人工智能AI 应用大模型多模态媒体生成音视频AI AgentAI 技能【免费下载链接】TapCanvas独一无二的沉浸式画布完全开源项目地址https://gitcode.com/anymouschina/TapCanvas点击查看免费下载TapCanvas 是一款完全开源的 Agent 原生无限画布面向 AI 影视、漫剧与多模态内容生产。它把文本、图像、视频和音频模型统一交给内置的鲁班 API 多模型网关apps/new-api接入、计量与动态下发——前端不写死任何模型列表你在网关管理台配置好渠道与模型画布即可一键成片。本文带你从零完成 TapCanvas 模型配置启动部署、看懂网关架构、认识预置模型目录再到图像/视频模型的逐项配置与常见问题排查。一分钟理解TapCanvas 为什么用模型网关很多 AI 创作工具把模型列表硬编码在前端换一家供应商就要改代码。TapCanvas 采用了完全不同的思路统一目录所有可执行的文本、图像、视频模型都来自网关管理台的动态模型目录前端按需拉取统一计量按 token、按张、按秒计费价格快照来自网关实时接口显式失败模型未启用、渠道缺 Key、规格不支持时直接报错不做静默降级也不会自动换模型。这意味着配置模型这件事只发生在网关管理台一处画布、AI 对话小T和一键成片工作流全部自动生效。一键部署三步启动 TapCanvas 全栈只需 Docker、Docker Compose 和 OpenSSL不需要在宿主机安装 Node.js、pnpm 或 Go。git clone https://gitcode.com/anymouschina/TapCanvas cd TapCanvas ./scripts/dev.sh docker脚本会自动生成一套强随机本地密钥写入apps/hono-api/.env不打印、不提交 Git并逐个构建 Web、API、鲁班 API 网关、Agents Bridge 与后台 Workers。首次冷构建耗时较长属正常现象。启动完成后记下三个入口服务地址用途Web 画布http://localhost:5175创作与模型选择界面APIhttp://localhost:8788后端协议与任务鲁班 API 管理台http://localhost:4455模型渠道配置本文主角完整部署细节见 Docker 配置指南。 首次进入 Web 会弹出首次启动检查如果网关里没有已启用的模型和可用渠道会显示先配置一个可用模型渠道并提供跳转到网关配置页的按钮。看到它说明一切正常接下来就是配置模型。内置模型渠道开箱即用的 20 个预置模型全新部署的网关由数据补丁自动初始化无需手工粘贴 Key 即可体验详见 补丁说明供应商Lluban APIOpenAI 兼容中继渠道lluban-recommended共享渠道20 个可执行目录模型10 个图像、4 个视频、6 个文本/对话均带真实路由与定价图像模型目录示例模型特点gpt-image-2支持 1K/2K/4K 与质量档位适合精细控制doubao-seedream-5-0-pro-260628豆包 Seedream 5.0 Pro1K/2Kgemini-3-pro-image-previewGemini 3 Pro 图像支持参考图gemini-3.1-flash-image-preview快速出图512 到 4K 多档wan2.7-image-pro万相 2.7最多 9 张参考图视频模型目录模型特点minimax-h3文生视频 多模态参考最多 9 图/3 视频/3 音频seedance-2.5高上限参考素材最多 30 张参考图sd2/sd2-miniSeedance 2.0 系480P 到 4K / 720P 分辨率档文本模型包括deepseek-v4-flash1M 上下文、双模推理也承担 AI 对话与内容安全预检以及多个 GPT 系列。⚠️ 网关启动时会从渠道上游同步最新模型目录与定价见 patches README所以你在管理台看到的模型以实时目录为准新发现的模型必须先补齐元数据与价格才会进入可选项避免把未验证路由伪装成可用模型。进阶渠道HeyRoute 与 Factory/Droid 号池除了内置推荐渠道社区版还预置了两类进阶渠道默认停用、Key 为空需填自己的 Key 后启用HeyRoute7 个渠道、共 31 个模型——15 个对话Claude、GPT、Grok、Gemini、Kimi、5 个图像gpt-image-2、Flux、Grok Imagine 等、11 个视频Grok 系、MiniMax H3 多档、Seedance 系。在渠道列表点申请 API Key完成注册后填 Key 启用即可说明见 HeyRoute 接入文档Factory / Droid 号池支持批量追加 Key、账号启停与单号测试、Standard/Core 额度窗口、订阅展示以及额度不足时同池换号重试说明见 Droid 接入文档。预置渠道的初始 SQL 位于 004-expand-heyroute-channels.sql 与 005-bootstrap-droid-factory-channel.sql可重复执行不会覆盖你已填的 Key 与启停状态。核心操作在鲁班 API 管理台配置模型渠道打开http://localhost:4455进入鲁班 API 管理台模型配置遵循一条固定动线渠道Channel→ 模型Model→ 能力Ability→ 价格Pricing。第 1 步渠道配置进入渠道列表找到推荐渠道lluban-recommended或新建渠道填入模型供应商的API Key内置推荐渠道已带公开分发凭证可直接使用确认Base URL如https://tt-api.lluban.com与协议端点正确保存后启用渠道。渠道被禁用或 Key 被清空时前端会回到强制配置引导。第 2 步模型与能力在模型管理中确认目标模型的kindimage / video / text与协议端点如openai、openai-video、image-generation在default分组下启用对应ability——渠道启用 模型启用 ability 启用三者齐全模型才进入可执行目录检查params_def声明的规格宽高比、分辨率、时长、参考图上限等这些规格会原样投影到画布的下拉选项。第 3 步价格与计量文本按输入/输出/缓存 token 计价图像按张 规格计价视频按分辨率与实际提交秒数计价公开价格接口提供channel_text_prices、channel_image_prices、channel_video_prices三类渠道独立报价例如gpt-image-2使用image:{1k|2k|4k}:{low|medium|high}九档计费合同每张参考图另计。 定价原则与倍率机制详见 模型渠道计价原则。验证配置是否生效回到 Webhttp://localhost:5175点击首次启动检查里的重新检查。面板会显示三个数字启用模型模型目录中启用的数量可用渠道已配置有效 Key 的渠道数可执行模型真正形成渠道 × 模型 × ability完整路由的数量。三者均大于 0页面自动放行画布里的生图/生视频/对话模型下拉框就会填充动态目录。动态模型目录配置一次处处生效这是 TapCanvas 最值得理解的机制之一规则写在 agents-cli 架构文档 中所有前端/对话中的模型可选列表必须来自系统模型管理model catalog / vendor 配置的动态数据禁止写死模型枚举作为可选来源。具体到使用体验小T 对话发送前会等待真实目录加载按你保存的目录顺序选择文本模型目录为空或加载失败会显式阻止发送而不是悄悄用默认模型图像节点按所选模型目录提交的规格比例/尺寸/质量计算报价同一质量值同时进入预估、请求与结算一键成片从流水线选择章节后触发器按实时目录的durationOptions如 5/10/15 秒档位与分辨率/画幅选项冻结生成合同目录外规格会在付费提交前原地报错子代理继承主代理创建的子代理继承本轮实际生效的模型配置继承失败会显式报错不回落到默认模型。常见问题排查FAQQ1Web 一直提示先配置一个可用模型渠道依次核对渠道是否启用 → Key 是否有效 → 模型 ability 是否启用 → 网关能否连通上游。前端的就绪检查读取的就是这四类真实事实缺任何一项都不会放行实现见 NewApiSetupGate.tsx。Q2目录里明明有模型为什么不可选有名称不等于可执行。只有同时具备真实路由、完整元数据和正价格快照的模型才进入可执行目录仅有名称的未验证路由会被显式排除。Q3生成时提示模型不支持某个规格规格分辨率、画幅、时长以所选模型的实时params_def为准。网关不会自动改成另一个规格也不会静默降级——请从下拉选项中重选一个合法档位。Q4改了渠道 Key 或启停状态会随升级被覆盖吗不会。所有补丁重复执行时都保留管理员替换过的 Key 与渠道启停状态只维护结构性字段见 补丁失败策略。Q5多个渠道都能跑同一个模型怎么计费按实际路由命中的渠道结算文本走该渠道的输入/输出/缓存单价图像按渠道规格与实际张数视频按渠道分辨率与提交秒数。参考路径速查内容路径Docker 部署指南docs/docker.md鲁班 API 补丁与初始化说明apps/new-api/patches/README.md内置推荐渠道 20 模型快照apps/new-api/patches/2026-08-31/001-bootstrap-lluban-channel-and-models.sqlHeyRoute 渠道接入说明apps/new-api/docs/heyroute.mdDroid 号池接入说明apps/new-api/docs/channel/droid.md模型渠道计价原则apps/new-api/docs/model-channel-pricing-principles.md前端模型目录消费与就绪检查apps/web/src/runtime/NewApiSetupGate.tsx视频供应商目录样例docs/model-catalog/tapcanvas-video-vendors.sample.json配置完成后从章节或正文节点进入一键成片选择已启用的文本、图像与视频模型TapCanvas 的 Agents 就会沿着剧本 → 角色与场景 → 分镜 → 视频片段 → 最终成片的流水线把长篇小说变成可交付的成片。赞分享人工智能AI 应用大模型多模态媒体生成音视频AI AgentAI 技能【免费下载链接】TapCanvas独一无二的沉浸式画布完全开源项目地址https://gitcode.com/anymouschina/TapCanvas点击查看免费下载相关推荐终极指南用Gamdl突破Apple Music限制下载ALAC无损音乐终极指南用Gamdl突破Apple Music限制下载ALAC无损音乐 Gamdl是一款强大的命令行工具专为下载Apple Music歌曲、音乐视频和视频内CLI音视频网络TrollStore 安装教程iOS 免越狱永久安装任意 IPA常见操作一次说清TrollStore 安装教程iOS 免越狱永久安装任意 IPA常见操作一次说清 侧载 IPA 七天到期是装包人的常见痛点。TrollStore 利用 i移动开发FastClaw多模型接入指南OpenAI、Anthropic、Ollama与Per-Agent模型覆盖如何配置FastClaw多模型接入指南OpenAI、Anthropic、Ollama与Per Agent模型覆盖如何配置 FastClaw 是一款用 Go 编写的轻量上一篇downkyi 哔哩下载姬:B站视频下载工具从8K到永久关停的完整复盘下一篇React Native拖拽动画如何自定义react-native-reanimated-dnd的Worklet动画函数完全指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。