配置 AI 供应商
StoryLoom 不自研模型，算力走你自己配置的服务商。所有 AI 请求都由 Rust 后端代理发出——前端不直连，API Key 在本机加密存储。
四类供应商
按用途分四类，写小说只需要「对话」，漫剧化、短视频才会用到后三类：
| 类型 | 用途 | 何时需要 |
|---|---|---|
| 对话（界面上叫「聊天供应商」） | 选题、大纲、续写 / 润色 / 扩写 / 卡文、整章生成、审校、一致性检查、AI 拆分镜等 | 用到 AI 写作就需要 |
| 生图 | 分镜出图、角色参考图、AI 生成作品封面 | 漫剧化 |
| 视频 | 分镜图生视频、首尾帧衔接 | 漫剧化 |
| 配音 | 分镜旁白 / 对白配音 | 漫剧化、短视频 |
不配任何供应商也能用写作、设定集、导入导出、带货的规则式功能，需要 AI 的按钮会禁用并提示。
添加供应商
- 进入 设置 → AI 供应商，在对应类型下点「添加聊天」「添加生图」「添加视频」或「添加配音」。
- 在「平台」里选一个服务商预置，地址和默认模型会自动填好；预置旁的「没有 Key？前往申请」会用系统浏览器打开该平台的 Key 申请页。
- 填入 API Key（少数专有协议平台还要补额外字段，见下文）。
- 可以点「获取」拉取该端点当前可用的模型清单（只做验证，不产生费用），再点「测试连接」确认能通。
- 保存。同一类型可以添加多个，写作面板里可以按场景切换使用哪个对话供应商。
设置 · AI 供应商：聊天 / 生图 / 视频 / 配音四类分开管理
对话供应商支持两种协议：OpenAI 兼容（绝大多数平台）和 Anthropic（Claude 官方或兼容 Anthropic 协议的中转），选预置时自动带上，也可以手动切换。
内置服务商预置
预置清单来自公共库，会随应用升级更新；没有列出的平台，用「其它 OpenAI 兼容（自定义接口地址）」或各类型的「自定义端点」填地址即可。
对话
| 分组 | 服务商 |
|---|---|
| Anthropic / 客户端 | Anthropic 官方、Claude Code 客户端（自定义接口地址）、Codex 客户端（自定义接口地址） |
| 国内 | DeepSeek、智谱 GLM、通义千问（阿里云百炼）、月之暗面 Kimi、硅基流动、火山方舟（豆包）、腾讯 TokenHub、MiniMax、百度千帆、阶跃星辰、百川智能、小米 MiMo |
| 国际 | OpenAI 官方、OpenRouter、Google Gemini（OpenAI 兼容层）、Groq、xAI Grok、Together AI |
| 本地 / 自建 | Ollama（本地）、LM Studio（本地）、vLLM / 自建推理服务、其它 OpenAI 兼容（自定义接口地址） |
选型建议：中文写作入门推荐 DeepSeek（预置默认模型
deepseek-flash，需要更强推理时可选deepseek-v4-pro），国内直连、不需要代理。预置的默认模型一律是「够用档」，更强的型号在模型下拉里可选；聚合平台在架模型变动快，建议点「获取」拉当天的真实清单。
生图
| 服务商 | 说明 |
|---|---|
| 即梦 Seedream（火山方舟） | 中文、封面、人像效果好 |
| 通义万相（阿里百炼） | 异步任务：提交 → 轮询 → 下载 |
| 硅基流动 生图 | Kolors 等模型 |
| OpenAI 生图 | gpt-image 系列 |
| 自定义生图端点 | 自填地址与模型 |
视频
| 服务商 | 说明 |
|---|---|
| 即梦 Seedance（火山方舟） | 文 / 图生视频 |
| 海螺 MiniMax 视频 | 图生视频 |
| Vidu 视频（阿里百炼） | 分镜图作首帧生成视频 |
| 硅基流动 视频 Wan | Wan 图生视频 |
| 智谱 CogVideoX | 提交 → 轮询 |
| 302.AI 视频·海螺 / 302.AI 视频·智谱 | 国内聚合，一个 Key 转发到海螺或智谱 |
| 自定义视频端点 | 自填地址与模型 |
配音
| 服务商 | 说明 |
|---|---|
| 字节豆包 配音（火山语音） | 中文音色库大。专有协议，除 Key 外还要填 App ID 与 Cluster |
| 硅基流动 配音 CosyVoice | 支持给角色设置「演绎风格」（如气声、播音腔） |
| OpenAI 配音 | /audio/speech 接口 |
| 自定义配音端点 | 自填地址与模型 |
专有协议的额外字段
大多数平台只需一个 API Key。字节豆包配音添加时会多出两个输入框：
| 平台 | 额外字段 |
|---|---|
| 字节豆包配音 | App ID（火山语音控制台的应用 appid）、Cluster（集群） |
这些字段随供应商配置一起保存在本机。
分享与导入供应商配置
调好的供应商可以生成一段分享串，在另一台电脑或给同伴粘贴导入。注意分享串会带上 API Key（如果这个供应商已经配了 Key），所以有两种封装：
| 方式 | 说明 |
|---|---|
| 设分享口令 | 用口令加密（AES-256-GCM），对方粘贴分享串并输入同一口令才能导入；截图、转发泄露也读不出 Key |
| 不设口令 | 分享串只做编码、不加密，任何拿到它的人都能读出 Key——只适合自己两台电脑之间私下迁移 |
还可以导出为 ai.profile 格式，粘贴到同一系列的其它软件里使用；这种格式不加密、直接含明文 Key，只在可信渠道传。
导入时在「导入供应商」里粘贴分享串，会先预览识别出的端点、模型和是否自带 Key，可以改字段、先测试再导入；多个配置打包的串会按原样整组导入。导入的 Key 用本机主密钥重新加密保存，界面不显示明文。
AI 用量
设置 → AI 用量汇总带货相关的几项 AI 调用（AI 提炼卖点、多候选整章、合规改写建议、事实核对 AI 复核）：按实际发出的请求逐条计数，token 数是按文字长度的估算；在对话供应商卡片上填了单价（元 / 千估算 token）后，还会给出估算费用。续写、整章、分镜等其它 AI 功能目前不计入这里，实际费用以各平台账单为准。
安全说明
- 所有 AI 请求由 Rust 后端代理，前端 WebView 不直连云 API。
- API Key 在本机加密存储，不写入对话记录、不以明文落盘；只有你主动生成分享串时才会随串带出（建议设口令）。
- 断网时写作与稿件管理仍可用，只有 AI 调用需要联网。