系统设置配置指引
适用对象：独立部署 / 首次开通本系统的客户管理员。入口：管理后台 → 系统设置组（2026-10-28 起拆分为四个子页：基础设置 /admin/system、AI 服务 /admin/ai-service、模型接入 …
- 一、必配项总览
- 「二选一」关系速查
- 数字分身功能依赖速查（AI 内容 → 角色与配音）
- 二、AI 模型参数（模型接入 → AI模型来源）
- 平台默认大模型（必配）
- 阿里百炼 API Key（必配）
- 模型货架（一般无需改动）
- 三、第三方服务参数（模型接入 → AI模型来源）
- 火山引擎（必配：AK/SK；方舟 Key 二选一）
- Mineru API Key（必配）
- 闪剪 · 数字人视频剪辑（必配）
- 内容审核（百度，可选）
- 视频编辑服务（可选）
- 四、存储与基础设施
- 阿里云 OSS 四项（必配）
- 向量数据库地址（安装时配置）
- 五、短信配置（基础设置 → 通知；可选，不影响登录）
- 阿里云短信
- 六、定价读数与站点看板（总部）
- 当前供给状态条（AI 服务页 / 模型接入·总览页签）
- 定价读数与改价（总部）
- 各项能力看板（模型接入 → 总览页签）
- 七、常见问题
适用对象：独立部署 / 首次开通本系统的客户管理员。入口：管理后台 → 系统设置组（2026-10-28 起拆分为四个子页：基础设置 /admin/system、AI 服务 /admin/ai-service、模型接入 /admin/access、部署向导 /admin/deploy-wizard；2026-11-04 起「模型与定价」页退役——定价读数收进 AI 服务页「进货价总览」，任务计费项迁「模型接入 → 任务服务」页签）。
原则：系统里的功能就是要用的——下表「必配」项每一项都对应系统的具体功能，不配置则对应功能不可用（系统设置页面同样以红色标注）。每项去哪里注册申请见后续章节。
一、必配项总览
| 必配参数 | 所在页签 | 对应功能 | 不配置的影响 |
|---|---|---|---|
| 平台默认大模型（提供商 / 默认模型 / Base URL / API Key） | 模型接入 → AI模型来源（自建中转站卡） | 全平台对话、智能体、文案生成等所有文本 AI 功能的默认通道 | 所有对话类功能不可用 |
| 阿里百炼 API Key | 模型接入 → AI模型来源（阿里百炼卡） | 知识库向量化（Embedding）、重排、图片/视频打标、对标账号分析、语音合成（TTS） | 知识库/素材库检索、打标、语音合成不可用 |
| Mineru API Key | 模型接入 → AI模型来源（MinerU 卡） | 知识库文档解析（PDF/Office → 可检索文本） | 知识库无法导入文档 |
| 向量数据库地址（Milvus） | 安装时配置（部署助手） | 知识库/素材库向量存储与检索 | 知识库、素材库功能不可用（不在系统设置页面展示，异常时联系部署方核查） |
| 阿里云 OSS 四项 | 基础设置 → 存储 | 所有用户上传文件（图片/视频/素材）的存储 | 无法上传任何文件 |
| 闪剪 API Key + 授权文本 | 模型接入 → AI模型来源（闪剪卡）+ AI 服务（授权词卡） | 「角色与配音」（AI 内容）的数字分身整条功能线（口播形象克隆训练、数字人视频合成） | 数字分身整条功能线不可用 |
| 火山引擎 AK/SK | 模型接入 → AI模型来源（火山引擎卡） | 真人/虚拟人像资产管理（真人口播真人认证）、即梦（Jimeng）图片生成 | 真人认证与即梦生图报错 |
以下为可选项（按需填写，同样写清对应功能与影响）：
| 可选参数 | 所在页签 | 用于 | 不配置的影响 |
|---|---|---|---|
| 火山方舟 API Key | 模型接入 → AI模型来源（火山引擎卡） | 火山系（volcengine/… 前缀）生图/生视频鉴权 | volcengine 系生图生视频不可用（模型清单级单独 Key 已停用，方舟 Key 是唯一鉴权） |
| 百度审核 API Key / Secret Key、审核代理 | 模型接入 → AI模型来源（内容审核卡） | 内容编辑页「违禁词检测」按钮的第三方机器审核（百度 Key 走 normal 模式、审核代理走 strict 模式） | 不影响 AI 生成与发布主流程（内建企业违禁词库零依赖）；仅检测按钮的第三方机器审核报错 |
| 阿里云短信 | 基础设置 → 通知 | 验证码登录/注册/重置密码/换绑手机的验证码 | 不影响账号密码登录；仅验证码登录、注册、重置密码、换绑手机四类流程不可用 |
| 视频编辑服务 | 模型接入 → AI模型来源（视频编辑卡） | 营销视频合成后端（一般由部署方在服务器提供，留空走默认） | 仅私有部署编辑后端时需填 |
| 审核代理三项（URL/Origin/Referer） | 模型接入 → AI模型来源（内容审核卡） | 审核请求代理 | 一般留空 |
| 充值站地址 | 基础设置 → 品牌 | 「充值算力」按钮跳转地址（总部配置） | 服务商一般留空 |
成本读数说明：经营报表的成本 / 毛利来自平台月账真数（原「成本单价目录」页签已随 2026-10-08 系统设置重排下线，无需也不可再配）。定价读数与改价工具见下文「六、定价读数与站点看板」。
「二选一」关系速查
| 场景 | 二选一的双方 | 规则 |
|---|---|---|
| 平台默认大模型提供商 | 火狐（OFOX） vs 其他 OpenAI 协议供应商 | 选火狐则 Base URL 内置无需填写；选其他供应商必须填 API Base URL |
| 火山系生图/生视频鉴权 | 方舟 API Key（唯一鉴权面） | 模型清单级单独 Key 已停用，volcengine 系生图生视频统一走方舟 Key |
| 图片生成引擎 | 即梦（jimeng/… 前缀，走 AK/SK） vs volcengine（方舟 Key） | 由模型清单里模型 ID 的前缀决定走哪个引擎，与选用的模型对应 |
| 短信通道 | 阿里云短信（页面唯一通道） | 配置即生效；全空不影响账号密码登录 |
| 登录方式 | 账号密码登录 vs 验证码登录 | 密码登录不依赖任何短信配置；验证码登录需要短信通道 |
数字分身功能依赖速查（AI 内容 → 角色与配音）
| 子功能 | 用的服务 | 需配置 |
|---|---|---|
| 口播形象克隆（训练） | 闪剪 | 闪剪 API Key + 授权文本 |
| 生成数字人视频 | 闪剪 | 闪剪 API Key |
| 声音克隆（原声训练） | 阿里百炼（CosyVoice/qwen-tts） | 阿里百炼 API Key（必配项已覆盖） |
| 数字形象智能摘要 | 阿里百炼（qwen3-vl-flash） | 阿里百炼 API Key（同上） |
| 真人/虚拟人像资产管理 | 火山引擎 | 火山引擎 AccessKey ID/Secret |
二、AI 模型参数（模型接入 → AI模型来源）
平台默认大模型（必配）
配置位置：模型接入 → AI模型来源 → 自建中转站·平台默认大模型。填「提供商 + 默认模型 + API Base URL + API Key」。
功能：这是全平台所有文本类 AI 功能（智能体对话、方案/文案生成等）的默认调用通道。模型清单里的对话模型不再单独配地址/Key（已停用），统一走这里的平台默认；自配多站池在「接入配置 → AI模型来源」配站与模型。
二选一：提供商选「火狐（OFOX）」时 Base URL 已内置（https://api.ofox.io/v1），无需填写；选「其他供应商（支持 OpenAI 协议）」时必须填该服务商的 API Base URL。
去哪里注册申请：
- 选「火狐（OFOX）」：一个兼容 OpenAI 协议的 AI 服务商，开通请联系对接的商务/交付负责人获取 API Key。
- 选「其他供应商（支持 OpenAI 协议）」：任何兼容 OpenAI 接口的服务商均可，例如：
- DeepSeek 开放平台（platform.deepseek.com）：注册 → 充值 → API Keys → 创建；
- 阿里云百炼（bailian.aliyun.com）：注册 → 控制台 → API-KEY；
- 其他（OpenRouter、Kimi、硅基流动等）同理——在服务商控制台创建 API Key，并记下其 Base URL（一般形如
https://api.xxx.com/v1）。
- 选好后在「默认模型」下拉中选择要使用的模型（列表由服务端统一下发）。
注意：默认模型若不支持图片/视频输入，涉及图片、视频理解的功能将无法使用（页面会提示）。
阿里百炼 API Key（必配）
配置位置：模型接入 → AI模型来源 → 阿里百炼卡。
功能：阿里系 AI 功能的统一 Key——知识库/素材库向量化（Embedding）、检索重排、知识库图片/视频打标、对标账号分析、语音合成（TTS）。模型清单里未单独配置 Key 的阿里系模型都使用它。
去哪里注册申请：
- 打开阿里云百炼控制台：https://bailian.aliyun.com （用阿里云账号登录，需完成实名）；
- 左侧「API-KEY 管理」→「创建我的 API-KEY」，获得
sk-开头的密钥； - 粘贴到「模型接入 → AI模型来源」的阿里百炼卡保存。
注意：知识库 Embedding 必须使用百炼的 text-embedding-v3 / v4 系列（下拉向量模型时注意选择），无替代。
模型货架（一般无需改动）
平台模型货架由平台目录统一维护——对话 / 图片生成 / 视频生成三类模型随平台目录自动同步（含零售引导价），无需手工增删或改价：
- 单价用于算力额度计费（对话=分/千 token、图片=分/张、视频=分/秒）；零售价 = 进货价 × 加价比例，总部在「AI 服务」页调加价比例即可，各模型进货成本与现行售价的只读对照在「AI 服务 → 进货价总览」；
- 目录外的本地残留行（历史手工添加 / 已过期）可在「模型接入 → 模型目录」页签点「按平台目录重置货架」一键清理——重置不动零售价与任务计费；
- 向量 / 重排等基础模型在「模型接入 → AI模型来源」各钥匙卡内选择（如百炼卡内选向量模型）；
- ⚠️ 向量模型切换后，已有数据的向量维度若不一致需重新入库。
三、第三方服务参数（模型接入 → AI模型来源）
火山引擎（必配：AK/SK；方舟 Key 二选一）
配置位置：模型接入 → AI模型来源 → 火山引擎卡。
功能分工：
- AccessKey ID / Secret（AK/SK，必配）：真人/虚拟人像资产管理（数字资产素材组与真人认证，超级 IP 打造依赖）、即梦（Jimeng）图片生成签名。未配置时对应接口直接报错「未配置火山引擎 AccessKey」；
- 方舟 API Key（二选一）：火山引擎系（
volcengine/…前缀）图片/视频生成的鉴权——volcengine 系生图生视频统一走方舟 Key（模型清单级单独 Key 已停用）。即梦引擎走 AK/SK，不用方舟 Key。
去哪里注册申请：
- 打开火山引擎控制台：https://console.volcengine.com 注册并完成企业实名；
- 右上角账号头像 → 「API 访问密钥」→ 创建密钥，得到 AK/SK；
- 方舟 API Key：控制台进入「火山方舟」，开通需要的模型后，在「API Key 管理」创建
ark-开头的 Key。
Mineru API Key（必配）
配置位置：模型接入 → AI模型来源 → MinerU 卡。
功能：知识库文档解析（PDF/Word/PPT 等 → 可检索文本）。不配置则知识库无法导入文档。
去哪里注册申请：
- 打开 https://mineru.net 注册账号；
- 进入个人中心 / API 页面创建 API Token；
- 粘贴到「模型接入 → AI模型来源」的 MinerU 卡保存。
注意：免费版 Mineru 接口的 Key 有效期为 3 个月，到期需重新生成并回填，知识库才会恢复解析。
闪剪 · 数字人视频剪辑（必配）
配置位置：模型接入 → AI模型来源 → 闪剪卡（API Key）；AI 服务 → 闪剪授权词卡（授权文本）。
功能：「角色与配音」（AI 内容）数字分身功能线的核心服务——口播形象克隆训练、数字人视频合成（真人口播/虚拟人视频/视频混剪）。不配置则数字分身整条功能线不可用（克隆训练/数字人视频报错）。声音克隆与形象摘要走阿里百炼，不依赖闪剪。
- API Key（必配）：闪剪开放平台的调用凭证；
- 授权文本（必配）：数字人克隆/播报所需的品牌授权词（交付时确定的英文品牌词），需在闪剪侧预先绑定该词，两边必须一致，不一致克隆训练会被闪剪侧拒绝。
去哪里注册申请：闪剪智能开放平台 https://openapi.shanjian.tv 注册 → 创建应用获取 API Key；品牌授权词的绑定由对接的交付负责人与闪剪侧完成。
内容审核（百度，可选）
配置位置：模型接入 → AI模型来源 → 内容审核卡。
功能：内容编辑页「违禁词检测」按钮的第三方机器审核——百度 API Key/Secret Key 走 normal 模式、审核代理地址走 strict 模式。
不配置的影响：AI 内容生成、违禁词库、发布主流程均不受影响（它们使用系统内建的企业违禁词库，零外部依赖）；仅「违禁词检测」按钮的第三方机器审核会报错。若企业维护了自己的违禁词库，检测按钮仍可查出内建词命中。
去哪里注册申请：
- 打开百度智能云控制台：https://console.bce.baidu.com 注册；
- 进入「内容审核」产品 → 创建应用，获得 API Key / Secret Key；
- 审核代理地址三项（URL / Origin / Referer）一般留空，由部署方按需配置。
视频编辑服务（可选）
配置位置：模型接入 → AI模型来源 → 视频编辑卡。
功能：营销视频合成的编辑后端（服务端 compute 服务调用）。一般由部署方在服务器环境里提供，留空走服务器默认配置即可，仅在独立部署了私有视频编辑后端时才需要填写。
四、存储与基础设施
阿里云 OSS 四项（必配）
配置位置：基础设置 → 存储 → 阿里云 OSS 文件存储。
功能：图片/视频/素材等所有用户上传文件的存储。采用 PostObject 签名直传，服务端只下发 30 分钟有效的签名策略，主密钥不进浏览器，无需创建 RAM 角色。
四项参数对照（页面 4 个输入框分别从哪里拿值）：
| 页面字段 | 从哪里得到 |
|---|---|
| AccessKey ID | RAM 子账号的 AccessKey ID（LTAI 开头） |
| AccessKey Secret | 同一 RAM 子账号的 AccessKey Secret |
| Endpoint | Bucket 概览页「外网访问 → Endpoint」（如 oss-cn-shenzhen.aliyuncs.com） |
| Bucket | Bucket 名称 |
按下面 5 步操作即可完成，全程约 15 分钟。
第 1 步：注册阿里云账号并完成实名认证
- 打开 https://www.aliyun.com ，注册阿里云账号（可用手机号注册，或用支付宝/淘宝账号直接登录）；
- 完成实名认证（个人或企业均可）：控制台右上角头像 → 实名认证，按提示提交；
- OSS 为按量付费（按存储量 + 外网流出流量计费），无需预购套餐，正常业务量级费用很低。
第 2 步：创建 Bucket（得到 Bucket 名称 + Endpoint）
- 打开 OSS 控制台：https://oss.console.aliyun.com ，左侧「Bucket 列表」→「创建 Bucket」；
- 按下表填写（加粗项为关键）：
| 配置项 | 怎么填 | 说明 |
|---|---|---|
| Bucket 名称 | 如 xxx-files |
全局唯一，只能小写字母/数字/连字符；创建后不可改名 |
| 地域 | 与部署服务器同一地域（如服务器在深圳就选「华南1 深圳」） | 跨地域则上传下载都走公网，更慢 |
| 存储类型 | 标准存储 | |
| 读写权限 | 公共读 | 选「私有」会导致上传的图片/视频在系统里无法显示、无法播放 |
| 版本控制/加密/日志等 | 保持默认 |
- 创建完成后记录两样东西：Bucket 名称；再进入该 Bucket 的「概览」页，在「访问端口 → 外网访问」处记录 Endpoint（如
oss-cn-shenzhen.aliyuncs.com）。注意取外网 Endpoint，不要复制「内网 Endpoint」（-internal结尾的那个）。
第 3 步：创建 RAM 子账号并授权（得到 AccessKey ID + Secret）
- 打开 RAM 访问控制台：https://ram.console.aliyun.com/users →「创建用户」：登录名如
oss-uploader，勾选「OpenAPI 调用访问」即可（无需勾选控制台密码登录，也无需创建 RAM 角色）； - 创建成功页会立刻显示 AccessKey ID（
LTAI…开头）与 AccessKey Secret——Secret 只完整显示这一次，务必马上复制保存；关掉页面后无法再查，丢了只能重新创建； - 回到 RAM 控制台「权限管理 → 权限策略 → 创建权限策略」，切到「脚本编辑」页签，粘贴以下内容，并把其中
my-bucket两处替换成第 2 步的 Bucket 名称：
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": ["oss:PutObject", "oss:GetObject", "oss:DeleteObject"],
"Resource": ["acs:oss:*:*:my-bucket", "acs:oss:*:*:my-bucket/*"]
}
]
}
- 保存策略（可命名
oss-my-bucket-rw），然后回到该用户详情页 →「权限管理 → 新增授权」，把这条策略授予oss-uploader。
安全提醒：不要图省事用阿里云主账号的 AccessKey——主账号 AK 可操作账号内全部资源，泄露即全线失守；按上述方式建的专用子账号只动得了这一个 Bucket。
第 4 步：配置 Bucket 的 CORS 跨域规则（放行 POST）
- 回到 OSS 控制台 → 该 Bucket →「数据安全 → 跨域设置」→「创建规则」；
- 按下表填写：
| 配置项 | 怎么填 |
|---|---|
| 来源 Origin | 系统实际访问的所有域名，如 https://ai.example.com（带协议头，多个域名一行一个） |
| 允许 Methods | 勾选 POST |
| 允许 Headers | * |
| 隐藏 Headers | 不填 |
- 保存。排查问题时可暂时把来源填
*快速验证，跑通后务必改回具体域名。
第 5 步：回系统填写四项并验证
- 基础设置 → 存储 → 阿里云 OSS 文件存储，按开头「四项参数对照」把 4 个值填入对应输入框（Endpoint 带不带
https://均可，系统会自动归一化）； - 点「保存本页设置」，重新进入本页回读确认 4 项均已保存；
- 验证：到素材库（或任意带上传入口的页面）上传一张图片，能在页面里正常显示即配置成功。
上传报错对照表：
| 现象 | 原因 | 处理 |
|---|---|---|
| 上传报 403 AccessDenied | 子账号策略未挂上，或策略里 my-bucket 没替换成真实 Bucket 名 |
检查第 3 步第 4 点：Bucket 名必须完全一致 |
| 浏览器控制台报 CORS 错误 / 请求被跨域拦截 | CORS 规则未保存，或来源里不含当前访问域名 | 检查第 4 步：来源需含当前域名且带 https:// |
| 上传成功但图片不显示、视频不能播放 | Bucket 读写权限不是「公共读」 | Bucket「概览 → 读写权限」改为公共读 |
| 保存时提示 Endpoint 格式不正确 | 填了内网 Endpoint（-internal 结尾）或非官方端点 |
填外网 Endpoint，如 oss-cn-shenzhen.aliyuncs.com |
| 上传报 SignatureDoesNotMatch | AccessKey Secret 复制错了（混入空格/少字符） | 删除这对 AK 重新创建，重新复制填入 |
向量数据库地址（安装时配置）
配置位置：随安装部署由「部署助手」配置（10-08 起不再在系统设置页面展示）。
功能：知识库/素材库的向量存储与检索。不可用时知识库、素材库相关功能全部不可用。
填什么：独立部署标准方案中 Milvus 部署在服务器本机 Docker 内（阿里云无对等产品、不可用其他云产品替代），地址一般为 http://127.0.0.1:19530。如知识库/素材库不可用且体检该项报警，请联系部署方用部署助手核查修正。
五、短信配置（基础设置 → 通知；可选，不影响登录）
短信不是必配项：账号密码登录完全不走短信，短信缺失不影响客户登录使用系统。
不配置的影响仅限：验证码登录、注册、重置密码、换绑手机四类流程不可用。
若需开通：按下方「阿里云短信」步骤申请即可。
阿里云短信
配置位置：基础设置 → 通知 → 阿里云短信。
功能：验证码登录 / 注册 / 重置密码 / 换绑手机四类验证码短信的发送通道。
去哪里注册申请：
- 打开阿里云短信服务控制台：https://dysms.console.aliyun.com （与 OSS 同一个阿里云账号即可）；
- 报备短信签名（企业实名 + 相关资质，审核通过后得到签名名称）；
- 申请 4 个验证码模板：登录、注册、重置密码、换绑手机（各自得到一个模板 Code，与页面四个模板框一一对应，勿混填）；
- RAM 访问控制创建仅短信权限的子账号 AK/SK，填入页面前两框。
六、定价读数与站点看板（总部）
当前供给状态条（AI 服务页 / 模型接入·总览页签）
供给状态两条读数位：「AI 服务」页的供给读数行与「模型接入 → 总览」页签的供给横幅，如实显示本线 AI 能力的供给来源（平台托管 / 上级供给 / 自配），异常（资格关闭、无可用钥匙行）时变黄提示。「模型接入 → 总览」还有各项能力看板（站点 × 能力族健康矩阵），详见《接入配置指引》。
定价读数与改价（总部）
三处工具覆盖定价读数与调价，互不重叠：
- 进货价总览（AI 服务页「加价比例」卡 →「查看」）：各模型进货成本 × 现行售价 × 应然价（进货成本 × 加价倍率）只读对照，带毛利灯（现行毛利率 / 亏本卖提示）与最近改价留痕；批发价目未覆盖或尚未定价的模型诚实标「未定价」。支持按对话 / 图片 / 视频三族筛选，点「刷新」强刷（绕缓存）。
- 加价比例（AI 服务页加价卡）：全局加价在此调整，保存即对名下全部下级生效——下级售价 = 进货价 ×（1 + 加价比例）。
- 任务计费项（模型接入 → 任务服务页签）：闪剪按次计费任务（视频剪辑 / 声音克隆 / 数字人克隆 / 极速克隆 / 语音合成等）的逐项改价，保存即生效；批发价目可用时附「毛利灯」对照（收入 vs 批发成本，只提示不硬卡）。
各项能力看板（模型接入 → 总览页签）
供给站 × 能力族的健康矩阵：每个供给站（火山方舟 / 阿里百炼 / 自有中转 / 闪剪 / MinerU / 内容审核）在各能力族下有无可用钥匙、健康度如何一目了然；钥匙行可直接「测试」，测完自动刷新健康度；点「去配置」自动切到「AI模型来源」页签定位对应钥匙卡。快照读不到时显示灰态与重试，不阻塞页面。
七、常见问题
- 不配短信影响登录吗：不影响。账号密码登录不走短信；短信只影响验证码登录、注册、重置密码、换绑手机四类流程。
- Mineru Key 过期：免费 Key 有效期 3 个月，知识库解析报错时先到 mineru.net 重新生成 Key 回填。
- 换了大模型供应商：改「模型接入 → AI模型来源」自建中转站卡四项即可，其他配置不受影响。
- 向量模型换了/维度变了：已有知识库数据需删除重新入库（向量维度必须一致）。
- 保存后多久生效：系统配置即时生效；加价比例与任务计费项保存即生效（多进程最长约 1 分钟全网生效）。
- 共用部署与独立部署：共用平台部署（服务商模式）的客户一般无需配置基础设施（OSS/Milvus/短信走总部配置）；独立部署客户按本文档全部必配项配置。
- 在哪里看充值：充值站地址由总部统一配置，服务商仅在拥有独立充值站时才填。