模型与 API 设置

模型、上游 API、提示词助手、存储和通知均由运营人员配置。用户只能调用被允许的模型和 预设，浏览器不会获取供应商密钥或上游路由细节。

管理预设

预设定义 API 路径、默认模型、响应格式和可见参数。修改前先确认：

• 上游地址在允许的主机范围内。
• 模型与路径兼容。
• 新预设已完成健康检查。
• 现有用户不会因删除或切换预设而失去正在使用的配置。

当前生产上游

JumpCLI 的默认生产上游使用 OpenAI 兼容的 Images API：

项目	已验证值
上游地址	https://www.xinyue.mom
API 路径	/v1/images/generations
默认模型	gpt-image-2
允许主机	www.xinyue.mom

gpt-image-2 已通过 JumpCLI 的完整预览生成、图片解码和校验路径，可作为默认模型。供应商 密钥只保留在服务器环境中，不能复制到预设名称、说明、工单或浏览器请求中。

同一上游还提供 grok-imagine-image、grok-imagine-image-2.0 和 grok-imagine-image-lite。Grok 图像模型必须使用 quality=low 或 quality=medium； quality=auto 会被上游以 400 拒绝。该上游在 response_format=url 时可能返回非 HTTPS 图片链接，JumpCLI 会按安全策略拒绝下载；生产 Grok 预设应使用 quality=low（或 medium）以及 response_format=b64_json。该组合已通过图片解码和 格式校验。对用户开放前，确认界面默认值或调用方请求始终使用这些兼容参数。

JumpCLI 当前只会激活一个预设，不负责在供应商之间做自动流量均衡。需要按成本、容量或 故障状态切换多个供应商时，应在 JumpCLI 前部署独立的 OpenAI 兼容模型网关，再将该网关 作为唯一上游地址配置。

健康检查

设置页可检查上游、对象存储、提示词优化器和 AI 助手等连接。健康检查成功只证明当前 配置可达；仍应使用测试账户提交一次最小生成请求验证完整流程。若请求返回 billing_not_ready，先完成 Meteroid 的计费投影与该组织的信用周期初始化；不要通过直接 修改租户数据库绕过计费门禁。

密钥处理

密钥在服务启动时通过秘密注册表或环境变量提供。界面只能选择已声明的密钥引用，原始值 不会回显。任何密钥轮换都应记录变更时间、影响范围和回滚方案。

部署相关变量见：环境变量。