微昕·砚文档

系统渠道

用途

配置上游模型供应商的连接信息、模型清单与售价，供创作台、画布与工作台调用。这是「能生成」的根基。

入口

管理后台 → 模型与资源 → 系统渠道（/admin/channels）

页面标题为「系统模型」：左侧渠道列表，右侧管理该渠道下的模型、协议与售价。

前置条件

  • 管理员账号。
  • 已准备好上游 API Key（或 AK/SK）；私网地址需符合部署侧 SSRF 放行策略。
  • 若使用一键目录接入，需目录可用（页面会显示「目录 / 离线目录 / 目录暂不可用」等状态）。

操作步骤

A. 用向导新增（推荐）

  1. 左侧点 新增渠道，打开「新增系统渠道」向导。
  2. 选择服务商：搜索服务商、模型或网址；可按标签筛选；也可走自定义渠道（打开手工表单）。
  3. 填写 Key：确认渠道名称、粘贴 API Key；可点验证连接。
    • 验证失败可「跳过验证」继续，但接入后渠道默认停用。
  4. 模型与定价：勾选要接入的模型；设置加价率（售价 = 成本 × (1 + 加价率)，页面注明 1 元 = 1 积分）；可为单模型覆盖加价率。
  5. 确认后接入。成功提示类似「已接入 xxx，N 个模型已上线」或「已创建（渠道默认停用）」。

B. 手工新增 / 编辑连接信息

  1. 向导中选自定义，或在已有渠道上点编辑（铅笔）。
  2. 填写并 保存：
字段含义
渠道名称后台识别名
Base URL上游 API 根地址
API Key / Access KeyOpenAI 兼容填 API Key；部分协议填 IAM Access Key
Secret Key仅 AK/SK 签名协议需要；其他留空
自定义 Headers额外请求头（勿把密钥塞进浏览器可泄露处）
使用全局并发 / 并发上限是否跟随系统策略，或单独限制
启用新建默认可启用；跳过验证的目录渠道会停用
代理 URL可选出站代理

编辑时 API Key 留空表示保留原凭证。

C. 管理渠道下的模型

  1. 左侧选中渠道。
  2. 右侧可 拉取模型 → 在「选择要导入的模型」中勾选 → 确认导入（新增模型仍需配置价格后启用）。
  3. 或 新增模型 / 自定义排序；行内支持编辑、复制、删除；多选可 统一调价 / 批量删除。
  4. 模型编辑器常见 Tab：基本信息、能力与参数、积分定价（协议未配时可能显示「待配置」）；基本信息中可为模型选择 模型 Logo（选择器按用途分类并提供搜索）。
  5. 保存后，启用中的渠道模型才会进入系统可用集合（若未开前台模型目录，用户直接看到这些模型）。

D. 启停、复制、排序、删除

渠道行操作：

操作说明
复制渠道复制一份配置便于改 Key 或分流
导出渠道（不含密钥）单渠道导出 JSON
停用 / 启用停用后新任务不用该渠道；历史保留
删除清除渠道与模型展示及 Key；账单与调用记录保留，页面不可恢复

侧栏底部可打开渠道排序对话框，调整展示顺序。

E. 导入 / 导出全部

  • 导出全部：不含 API Key 等密钥。
  • 导入：选择渠道导出 JSON；按渠道名称合并——同名保留现有密钥与启停，更新地址/并发/文件中的模型；新渠道创建为停用，需填 Key 后再启用。

结果如何验证

  1. 渠道列表显示「已启用」，凭证为「API Key 已配置」或「AK/SK 已配置」。
  2. 右侧模型数量 > 0，且售价档完整。
  3. 返回创作台，模型下拉能选到目标模型并试生成成功。
  4. 请求明细 中出现对应上游请求；失败时看状态码与错误信息。

常见失败

现象处理
用户端「模型服务拒绝了请求」核对 Key、Base URL、模型 ID；看请求明细；确认渠道未停用
跳过验证后用户仍不可用渠道默认停用 → 启用；并确认 Key 真能调通
导入后无法调用新渠道无密钥且停用 → 编辑填 Key 后启用
目录暂不可用刷新目录或改用手工渠道
私网 Base URL 被拒检查部署环境允许的私网上游主机列表

相关文档

系统性能

查看主机、数据库、Redis、画布 Agent 与运行时缓存

前台模型

配置前台展示名、供应线路、能力范围与用户价格

On this page

系统渠道用途入口前置条件操作步骤A. 用向导新增（推荐）B. 手工新增 / 编辑连接信息C. 管理渠道下的模型D. 启停、复制、排序、删除E. 导入 / 导出全部结果如何验证常见失败相关文档