默认模型与账号设置
用途
个人设置不再提供供应商、API Key 或自定义模型配置。管理员在 管理后台 → 模型配置 中统一维护供应商连接、模型能力、启停状态和积分价格;普通用户只选择个人默认模型。
供应商类型
「管理后台 → 供应商 → 新建供应商」对话框的「类型」下拉支持以下 35 项预设(数据源:src/lib/model-catalog/provider-presets.ts 的 PROVIDER_CONNECTION_PRESETS):
| 类型 (type) | 显示名称 | 默认服务地址 | API Mode | Gateway Route |
|---|---|---|---|---|
ark | Volcengine Ark | https://ark.cn-beijing.volces.com/api/v3 | openai-official | official |
google | Google AI Studio | https://generativelanguage.googleapis.com/v1beta | gemini-sdk | official |
bailian | Alibaba Bailian | https://dashscope.aliyuncs.com/compatible-mode/v1 | openai-official | official |
openrouter | OpenRouter | https://openrouter.ai/api/v1 | openai-official | official |
minimax | MiniMax Hailuo | https://api.minimaxi.com/v1 | openai-official | official |
vidu | Vidu | https://api.vidu.cn/ent/v2 | openai-official | official |
fal | FAL | https://queue.fal.run | openai-official | official |
starrouter | StarRouter Cloud | https://starrouter.io/v1 | openai-official | official |
comfly | Comfly (vvicat 自研 API) | https://vvicat-comfly-prod.vvicat.dev(vvicat 自研 API 网关,非 ComfyUI 协议) | openai-official | official |
runninghub | RunningHub | https://www.runninghub.ai(独立云端工作流 API) | openai-official | official |
comfyui | ComfyUI (ComfyUI服务) | http://localhost:8188(本地自部署 ComfyUI 服务;ComfyUI 协议族的另一个子类型;可覆盖为任意 ComfyUI 兼容服务) | openai-official | official |
openai | OpenAI | https://api.openai.com/v1 | openai-official | official |
anthropic | Anthropic | https://api.anthropic.com | openai-compat | openai-compat |
gemini | Google Gemini | https://generativelanguage.googleapis.com/v1beta | gemini-sdk | official |
azure | Azure OpenAI | https://{resource}.openai.azure.com/openai(资源名替换 {resource}) | openai-compat | openai-compat |
deepseek | DeepSeek | https://api.deepseek.com/v1 | openai-official | official |
moonshot | Moonshot (Kimi) | https://api.moonshot.cn/v1 | openai-official | official |
qwen | Alibaba Qwen (DashScope) | https://dashscope.aliyuncs.com/compatible-mode/v1 | openai-official | official |
glm | Zhipu GLM | https://open.bigmodel.cn/api/paas/v4 | openai-compat | openai-compat |
kling | Kling (Kuaishou) | https://api.klingai.com | openai-compat | openai-compat |
seedance | Volcengine Seedance (Ark) | https://ark.cn-beijing.volces.com/api/v3 | openai-official | official |
xai | xAI (Grok) | https://api.x.ai/v1 | openai-official | official |
openai-compatible | 自定义 OpenAI 兼容服务 | 留空,由用户填写自建网关的服务地址 | openai-official | openai-compat |
minimax-cn | MiniMax CN | https://api.minimaxi.cn/v1(国内主站) | openai-official | official |
minimax-global | MiniMax Global | https://api.minimaxi.com/v1(国际站) | openai-official | official |
bigmodel | BigModel (Zhipu) | https://open.bigmodel.cn/api/paas/v4 | openai-compat | openai-compat |
xiaomi-mimo | Xiaomi MiMo | https://api.xiaomimimo.com/v1 | openai-official | official |
z-ai | Z.ai | https://api.z.ai/v1 | openai-compat | openai-compat |
kimi-cn | Kimi CN (Moonshot) | https://api.moonshot.cn/v1(国内站) | openai-official | official |
kimi-global | Kimi Global (Moonshot AI) | https://api.moonshot.ai/v1(国际站) | openai-official | official |
byteplus | BytePlus (Ark Global) | https://ark.ap-southeast.bytepluses.com/api/v3(火山国际站) | openai-official | official |
aws-bedrock | AWS Bedrock | https://bedrock-runtime.us-east-1.amazonaws.com | openai-compat | openai-compat |
tencent-cloud | 腾讯云 (混元) | https://hunyuan.tencent.com/v1 | openai-compat | openai-compat |
fulifangzhou | 福立方舟 | 留空,由管理员填写聚合网关的服务地址 | openai-compat | openai-compat |
ppio | PPIO 派欧云 | https://api.ppinfra.com/v3/openai | openai-official | official |
选择
openai-compatible后,「服务地址」输入框默认空白,必须由管理员填写自建 OpenAI 兼容网关的 URL 与 API Key;其他扩展字段(协议模式、Header、模型别名映射等)保持默认即可。选择
ComfyUI (ComfyUI服务)后,「服务地址」默认http://localhost:8188。本地 ComfyUI 实例默认指向私网,会被 SSRF 拦截拒绝保存。管理员需先把localhost:8188加入服务端.env的VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS白名单(逗号分隔,可同时支持多个 host / LAN 地址),然后再保存。RunningHub 与 Comfly 无此限制,可直接保存。
scripts/seed-provider-presets.ts 与 /api/admin/ai-providers/seed-from-preset 还会使用同一份预设(PROVIDER_PRESETS,厚字段)的协议模式 / Header / 模型别名映射等配置一键创建供应商记录。
使用前准备
管理员已启用所需供应商和模型,并发布能力与价格完整的模型修订。
配图占位
- 页面:个人设置的模型设置
- 状态:已加载可用的全局模型
- 重点区域:默认模型与能力选项
- 脱敏要求:隐藏邮箱、余额和任务内容
操作步骤
- 打开 个人设置 → 模型设置。
- 从管理员已启用并发布价格修订的全局模型中,为文本分析、角色图片、场景图片、分镜图片、图片编辑、视频、语音、音色设计和口型同步选择默认值。
- 按模型能力选择分辨率、质量、时长等默认参数;页面只显示该模型实际支持的选项。
- 保存后,新项目和未显式指定模型的节点会继承这些默认值。
版本升级或管理员调整模型目录后,如果已保存的默认模型不再可用,系统会自动改用同类型中最早启用的模型并保存为新的个人默认值。旧的能力选项失效或缺失时,也会改用新模型声明的第一个可用选项,避免任务被历史配置阻断。
手机端会将账号导航收拢为横向菜单,模型卡片、积分概览和订单记录改为单列或双列布局;画风编辑器使用全屏弹层,底部操作按钮始终可见。
配置优先级为 节点配置 → 项目配置 → 个人默认配置。管理员停用供应商或模型后,已有历史记录不变,但新任务必须重新选择可用模型。
Comfly 和 RunningHub 也遵循同一规则:用户只选择对应视频模型,不填写 Token、Base URL 或工作流 ID。服务端环境变量和管理后台目录必须同时就绪。
comfyui与runninghub使用相同的 workflow JSON 载荷格式,但分别维护专用模板、能力、提交错误和轮询路由。详见 ComfyUI MiniMax H3 视频。
结果与状态
保存成功后,新任务使用当前有效默认值;历史任务和素材不变。
CLI
ai-short-studio config get --json 用于读取全局可用模型和个人默认值。config set 只能更新 defaultModels、模型能力默认值和工作流并发;提交 providers 或 models 会被拒绝。
权限和限制
- 普通用户不能读取供应商密钥,也不能新增、编辑、启停或删除供应商及模型。
- 只有管理员已启用供应商和模型、且模型存在已发布完整价格修订时,模型才会进入默认模型列表。
- 默认模型变化不会重新生成历史素材,也不会改变已提交任务的价格快照。
- 个人艺术风格仍在个人设置中维护;系统艺术风格由管理员维护。
常见问题
为什么模型列表为空?
请联系管理员确认供应商、模型和价格修订均已启用并发布。
为什么某些默认模型下拉显示 “GPT” 而不是我自己设置的模型?
如果之前保存的默认模型对应的 provider 已被删除、停用或未配置 API Key,后端 GET /api/user/api-config 会把可用模型列表里的「同类型最早启用模型」(通常是 StarRouter GPT Image 2 等系统预设)作为兜底显示,前端会用琥珀色 banner 提醒你重新选择。如果不想被改写:
- 让管理员重新启用对应的 provider,或
- 在「全局图像模型配置」区域手动选择可用模型覆盖。
ComfyUI 与 RunningHub 模型均由管理员集中配置,用户不填写 API Key;两者按各自 Provider 的启用状态和已发布模型修订进入可用列表,不会互相回退或静默改写。
为什么保存后我的工作流模型没有被改成 GPT?
ComfyUI(type=comfyui)和 RunningHub(type=runninghub)都是管理员集中配置的工作流模型。后端分别按所属 Provider 的启用状态、凭据和已发布修订判断可用性;两者只共享 workflow JSON 的载荷结构,不共享模型模板、Provider 能力、提交接口或轮询逻辑。