用灵感矿做漫剧，接德普一芯出片

灵感矿是开源的 AI 短剧 / 漫剧创作平台（无限画布、AI Agent、可视化工作流，支持桌面端与 Docker 部署）。它允许接入第三方模型供应商——下面这个文件就是德普一芯的适配器，装好后就能用德普一芯的 Seedance 模型在灵感矿里出片。

这一页适合谁：愿意自己装工具、想做漫剧 / 短剧全流程的用户。如果你只想打开网页就出片，请直接用控制台 → 创作 · 视频生成，不需要装任何东西。

一键接上两套模型（重要）模型能力限制排错然后去哪排错

👉 第一次用？看这份完整教材： 《从零到一：用德普一芯在灵感矿里出第一支片子》 —— 从注册充值一路写到出片，含每一步的"怎么判断做对了"和排错速查表。

最快的方式：一键接上

已经装好灵感矿了？不用手动找文件 —— 点下面这个按钮，灵感矿会弹出来问你是否安装「ideamine.ts」，确认即可。装完在设置里填一次 API Key 就能用。

点不动 / 没反应？看手动步骤

从本页底部下载 ideamine.ts
打开灵感矿 → 设置 → 模型 → 媒体模型，点面板上的 「添加自定义供应商」
⚠️ 别点旁边的「添加供应商」—— 那个打开的是内置厂商列表，里面没有德普一芯。弹窗标题写「添加自定义媒体供应商」，但按钮上写的是「添加自定义供应商」，两者不一样，很容易找错。
⚠️ 认准弹窗里的「添加方式」这一项 ——
⑥ 「添加自定义供应商」表单 —— 字段依次是 Provider ID / 显示名称 / API 地址 / API 协议 / API 密钥 / 模型列表
它会给你两个选择：文件导入 / 粘贴代码 （默认就是「文件导入」）。
如果你看到的弹窗是「Provider ID / API 地址 / API 协议 / API 密钥」这种表单，说明你进的是「文本模型」面板下面的供应商，不是「媒体模型」 —— 退出去，在设置里换到「媒体模型」再点一次。两边按钮同名，但打开的是完全不同的东西。
（顺带说：那个表单是给文本模型用的 —— 填 https://depuyixin.com/v1 + 你的 Key，点「获取模型列表」也能拉出我们的文本模型。要出视频才必须走「媒体模型」。）
「添加方式」选文件导入（选择刚下载的文件），或选粘贴代码（用浏览器打开该文件、全选复制粘贴）
填 API Key → 确定

⚠️ provider 类型不覆盖同名项：如果你之前装过，要先在灵感矿里把旧的删掉，再点一键安装。

按钮靠灵感矿的桌面协议唤起，只在装了桌面版、且把 App 放进 /Applications（macOS）之后才有效；没反应就往下看手动步骤。

⚠️ 装之前先对一下「芯片 + 系统版本」（两个包要求不一样，我们实测过）

你的 Mac	该下哪个包	最低系统要求
Apple 芯片（M 系列）	`macos-arm64-ideamine.dmg`	macOS 14.0
Intel 芯片	`stable-macos-x64-ideamine.dmg`	macOS 15.7.5 ⚠️ 高得多

先跑这两条命令看自己是什么机器：
uname -m（arm64=Apple 芯片， x86_64=Intel）· sw_vers -productVersion（系统版本）
系统版本不够时，App 图标会显示一个禁止符号（🚫），双击也打不开 —— 这不是包坏了，是系统太旧。
另外这两个包都没有做代码签名，首次打开要右键 →「打开」，或去「系统设置 → 隐私与安全性」点「仍要打开」。
Intel + macOS 15 以下的机器，桌面版两个包都装不了，请直接用下面的 Docker 方式。

⚠️ macOS 首次打开被拦住了？（每个 Mac 用户都会遇到）

灵感矿的 macOS 包没有做代码签名，所以第一次打开会弹：

「Apple 无法验证"ideamine"是否包含可能危害 Mac 安全或泄漏隐私的恶意软件。」

这不是病毒警告，只是"这个 App 没买苹果的开发者签名"。（我们实测过官方包的签名状态就是 code object is not signed at all。）放行方式二选一：

图形界面（推荐）：

先双击一次 App，弹出上面那个框 → 点「完成」（或「取消」）
打开 系统设置 → 隐私与安全性，往下滚到「安全性」一节
会看到「已阻止使用"ideamine"，因为来自身份不明的开发者」→ 点 「仍要打开」
输入开机密码 / Touch ID 确认 → 再点一次「打开」

⚠️ macOS 15（Sequoia）起，苹果取消了「右键 → 打开」那个老快捷方式 —— 如果右键打开没反应，就走上面这条路。

终端一条命令（去掉"下载隔离"标记）：

sudo xattr -dr com.apple.quarantine /Applications/ideamine.app

会要求输入开机密码。macOS 14+ 可能还会弹一个「终端想要管理 App」的授权，允许即可（不然会因为 Operation not permitted 失败）。跑完再双击 App 就能开。

⚠️ 前置条件：App 必须放在 /Applications 里。 从 DMG 里直接打开、或放在下载文件夹里，协议不会注册，本页的一键安装按钮就点不动。请先把 ideamine.app 拖进「应用程序」文件夹。

还没装灵感矿？先去官方 Releases 下载：macOS 选 macos-arm64-ideamine.dmg（M 系列芯片）或 stable-macos-x64-ideamine.dmg（Intel），Windows 选 ideamine-*-Setup.exe。 macOS 装完记得把 App 拖进 /Applications，否则一键按钮不起作用。

系统版本不够？（macOS 15 以下 / Linux / 服务器）用 Docker

桌面版有系统版本门槛，Docker 版没有 —— 而且它同样支持「添加自定义媒体供应商」，我们那个适配文件照样能用。

git clone https://github.com/HBAI-Ltd/灵感矿-app.git
cd 灵感矿-app
docker compose up -d

跑起来后按页面提示打开它的 Web 界面，再走上面「手动三步装好」的第 3 步即可。 Docker 版的灵感矿不能用本页的一键安装按钮（那个协议只有桌面版有）—— 请用手动方式装适配文件。

方式二：粘贴代码 —— 如果你更想用「粘贴代码」，请用下面的按钮直接复制， 不要手动框选（手动复制容易把引号 / 反引号弄成全角，一弄就报语法错）。

手动复制时最容易出的问题

引号被换成中文引号（" → "）→ 报 Unexpected token
反引号被换成单引号（` → '）→ 报 Unterminated 之类
中间漏行（比如末尾的 } satisfies …; 没复制上）→ 报 Unexpected end of input

遇到这类错，先别改代码 —— 用上面的按钮复制，或改用「文件导入」方式 （下载文件再选文件，完全不经过剪贴板）。

⚠️ 先分清：灵感矿里有两套模型，互不相通

这是最容易绕晕的地方 —— 同一个界面里有两个都叫「模型」的下拉，但它们不是一回事。

你在哪看到它	它是哪套	干嘛用的	怎么装
首页「灵感创作模式」的模型下拉画布里「新对话」的模型下拉	文本模型特征是它下面有「推理等级（默认/低/中/高）」	Agent 对话、写剧本、「搭建创作画布」	文本模型面板 → 添加自定义供应商 API 地址填 `https://depuyixin.com/v1`
画布上「视频生成」节点里的模型下拉	媒体模型	出视频	媒体模型面板 → 装 `ideamine.ts`

关键结论：装好媒体模型不会让首页那个下拉出现东西；反之也一样。想两边都能用，就得装两次（两个面板各一次）。

⚠️ 而且 Agent 也依赖文本模型 —— 文本模型没配好时，「新对话」里连「搭建创作画布」都点不动。所以建议两个都装。

装文本模型（让 Agent 和首页下拉能用）

设置 → 模型 → 文本模型 → 添加自定义供应商 （⚠️ 不是「媒体模型」，两个面板按钮同名）
填：
· Provider ID：ideamine
· 显示名称：德普一芯
· API 地址：https://depuyixin.com/v1
· API 协议：openai-completions（默认）
· API 密钥：你的 sk-…
点 「获取模型列表」 —— 能拉出模型就说明配置正确
保存

模型能力（都是实测过的）

模型	上游型号	时长	分辨率	参考图（图生视频）	状态
德普一芯 · 快速版	Seedance 2.0-fast	4–12 秒	720P	✅ 支持	稳定
德普一芯 · 画质版	Seedance 2.0	4–12 秒	720P	✅ 支持	稳定
德普一芯 · 专业版	Seedance 2.5	2–30 秒	720P / 1080P	❌ 不支持	测试中

⚠️ 一个违反直觉的地方：「专业版」反而没有参考图能力。
Seedance 2.5 不支持参考图，上游会直接报 field input_reference is not supported for model SD-2.5。
所以要图生视频请用快速版或画质版；要长镜头 / 1080P 请用专业版（纯文本）。适配文件里已经按这个事实声明能力 —— 选了专业版，灵感矿界面上不会出现参考图入口。

以上数据来自公开接口 /v1/capabilities，并且每个模型的参考图能力都真实提交验证过（快速版 / 画质版真出片，专业版被上游明确拒绝）。

限制（如实说明）

支持

文生视频（三个模型都支持）
图生视频 / 参考生成（快速版、画质版）
时长与分辨率按上表自动约束，滑块范围随模型变化
成片直接回流到灵感矿画布

不支持（适配文件里没有声明，界面上也不会出现）

❌ 首尾帧 —— 上游没有这个能力
❌ 视频编辑 / 视频延长
❌ 视频参考、音频参考
❌ 480P —— 只有 720P / 1080P

⚠️ 参考图必须是公网链接。 灵感矿允许你拖本地图片当参考，但德普一芯的接口只接受公网 URL。如果拖的是本地文件，会看到这句提示： 「参考图必须是公网可访问的图片链接……」
解决办法：把图片传到德普一芯控制台的「资源库 → 资产库」，那里会给你一个公网地址，再用那个地址即可。

排错（最常见的 3 个）

这三条覆盖 90% 的情况。完整排错表（含报错原文对照）在教材第 ⑧ 节。

现象	原因	怎么办
媒体模型那行显示「0 个模型」	适配文件没被解析（多半是文件名被改过）	从下载页重新下（文件名会被钉成正确的），再导入一次
媒体模型正常，但 Agent 不能用	只配了媒体模型，没配文本模型	按教材 ③ 再配一次文本模型 —— 两处都要配
报 401 / 没有可用渠道	Key 没填或填错；或那个模型当前没渠道	在对应面板点「编辑」重填；模型换一个（文本模型清单里 34 个都实测可用）

然后去哪

你现在想做的事	去这个页面
一步步照做装起来（含 9 张界面截图）	从零到一 →
下载适配文件（在灵感矿里叫「文件导入」）	下载适配文件 →
能在灵感矿里用哪些模型	模型清单 → · 文本模型清单 →
转给同事 / 客户（速查）	一页纸 →

用 灵感矿 做漫剧，接德普一芯出片