如何在 Nomi 中接入第一个模型:APIMart、中转站与自定义 API 快速上手
如何在 Nomi 中接入第一个模型:APIMart、中转站与自定义 API 快速上手
Nomi 是一个开源、本地优先的 AI 视频创作工作台,接入自己的模型(Nomi 模型接入)就能让它替你完成分镜、关键帧、视频生成与 MP4 导出。本文带你用最简单的方式完成第一次模型接入:无论是 APIMart 这种「一个 Key 全通」的模型中转站,还是任何 OpenAI 兼容的自定义 API,只要准备好 API Key,几分钟就能在画布上跑起第一个生成任务。你的 Key 只保存在本地,绝不上传任何服务器。
为什么接入模型是 Nomi 的第一步?
Nomi 本身不内置任何付费模型——它像一个「模型调度器」,把文本、图片、视频、音频任务路由到你自己配置的供应商上。所以启动后第一件事,就是给它配上模型。
三种接入方式,难度从低到高:
| 方式 | 适合人群 | 你手里需要什么 |
|---|---|---|
| 🏆 策展预设(APIMart 等) | 想最快上手的人 | 一个 API Key |
| 🔀 中转站 / OpenAI 兼容接口 | 有中转站账号的人 | Base URL + API Key |
| 🛠 自定义 API / Agent 辅助 | 手里只有文档或 curl 样例 | 供应商文档、请求样例 |
详细官方文档见 provider-integration.md,安装与启动步骤见 quickstart.md。
第一步:打开「模型」设置面板
启动 Nomi 后,点击顶部工具栏右上角的 ⚙ 设置图标,在左侧列表中选择 「模型」。这就是模型接入面板的首页,所有连接都在这里管理:
这个面板有 3 个关键区域,对应三种接入方式:
- 「让 AI 帮你接入」——顶部卡片,适合把 API 文档丢给 Agent 自动配置;
- 「已接入」连接列表——显示每个供应商的地址、密钥与模型状态(「N 个待设置」还是「N 个可使用」);
- 「添加模型服务」——底部入口,手动填写供应商名称、API Base URL 和 API Key,开始接入你的第一个模型。
接入向导的核心逻辑实现见 OnboardingWizard.tsx。
方式一:APIMart 策展预设——一个 Key 全通(最快配置方法)
APIMart 是 Nomi 内置支持的模型中转站。选它的好处是不用逐个模型读文档:填入一个 APIMart Key,Nomi 预置的全部高频图片/视频模型会自动出现在生成选项里,包括 Sora 2、Veo、Kling、Seedance、Seedream 等。
操作步骤:
- 在模型面板点击「添加模型服务」,选择 APIMart 预设;
- Base URL 默认
https://api.apimart.ai,把你在 APIMart 控制台申请的 Key 粘贴进 API Key 框; - 点击保存,Nomi 会自动拉取该家预置模型列表;
- 在画布节点里直接选用模型即可生成。
几个实用细节:
- 🌐 国内地址可改:如果默认主域在你的网络下连不上,可以在连接设置里把地址改成 APIMart 的国内线路(0.22.5 起地址栏对完全开放给用户编辑,改完已保存的 Key 绑定会自动跟随);
- 📦 图片与视频任务在 APIMart 上都是异步任务:提交后拿
task_id,轮询任务状态直到完成——这些 Nomi 在传输层(electron/ai/requestPipeline.ts)已自动处理,你无需关心; - 🧾 内置供应商的注册与选路表在 electron/catalog/seedBuiltins.ts,预置模型以档案形式逐家维护,新增模型会持续加入。
各家端点、字段名、结果路径的完整对账记录,可查 provider-api-docs.md。
连接成功后,打开任意模型卡片会看到「验证」状态页。全部模型通过真实调用测试后,会显示绿色的 「全部验证完成 · 全部通过真实测试,可以在画布中使用」:
方式二:接入中转站与 OpenAI 兼容接口
如果你有其它中转站,或者只有 OpenAI 兼容的文本/图片接口(DeepSeek、通义千问、Ollama 本地模型等),走「添加模型服务」的手填流程:
- 供应商名称:起个好认的名字,如「我的中转站」;
- API Base URL:填供应商给出的接口地址(OpenAI 兼容接口填对应兼容地址即可);
- API Key:粘贴你的密钥;
- 模型类型:文本 / 图片 / 视频;
- 点击「测试」验证连接,保存后模型即可在画布节点中选用。
文本模型推荐起步选择:
| 供应商 | 推荐模型 | 用途 |
|---|---|---|
| DeepSeek | deepseek-chat | 写脚本、拆镜头 |
| 通义千问 | qwen-turbo | 文本生成 |
| Ollama | 任意本地模型 | 本地免费运行 |
💡 中转站的模型列表如果和文档不一致,Nomi 的旅途测试体系(model-access 旅途矩阵)正是为这类场景设计的:「保存、连通、模式验证、生产启用」是四个独立状态,Nomi 不会把「保存成功」谎报成「能用了」。
方式三:自定义 API——把文档丢给 AI 帮你配
供应商文档复杂、字段对不上?不用自己逐个抄参数。Nomi 支持 Agent 辅助接入:
-
在模型面板顶部的「让 AI 帮你接入」卡片选择你的 AI 助手(WorkBuddy / Codex / Claude Code 等),复制指引后把供应商的 API 文档 URL 发给它:
帮我接入 xxx 供应商,API 文档在 https://docs.xxx.com/api
Agent 会读取文档、逐项核对端点与参数、生成配置草稿,你在模型面板里确认后保存即可。完整的三方 Agent 接入契约见 nomi-add-model/SKILL.md。
-
如果你的供应商接口非常特殊(签名鉴权、非标准状态机),Nomi 还会给出「自定义调用脚本」的出口:手写一段调用脚本挂到该模型上,跑通后同样能在画布使用。
接入后:在画布里用第一个模型生成
模型就绪后,回到创作区。在画布的每个生成节点底部,都可以切换「生成方式(文生图 / 改图)+ 模型 + 分辨率 + 张数」。下面是接入模型后,一个文生图节点正在生成动画分镜的真实界面:
右侧的 AI 助手面板则负责文本环节——写脚本、拆镜头、改提示词。你在对话里给一条指令,它就会调用已接入的文本模型改写文档:
常见问题与注意事项
🔐 我的 API Key 安全吗?
安全。Key 只保存在本地用户配置目录(userData/catalog.json),不出现在任何上传请求里;Nomi 也不提供读取已存 Key 的接口,只告诉你「有 / 没有」。不要把整个用户配置目录提交到 Git。
⚠️ 「连接已保存」等于「能用了」吗? 不等于。Nomi 区分「连接已保存 → 连通 → 真实生成验证」三个层次,只有跑出真实产物才算接好。建议保存后点一次验证。
🌐 连不上 APIMart 主域怎么办? 把连接地址改为 APIMart 国内线路后保存,画布生成会直接走国内线路。
🧩 支持本地 ComfyUI 吗? 支持。Nomi 同样内置了本地 ComfyUI 工作流入口,接上本机 ComfyUI 实例即可用本地模型出图出视频,与上面的云端接入方式互不冲突。
到这里,你的第一个模型已经接入完毕。下一步可以按 provider-integration.md 补上图片与视频模型,让 Nomi 跑通从脚本到 MP4 导出的完整创作链路。



