需用 UTF-8 编码 JSON 文件批量导入 OpenAI 兼容模型，根节点为数组，每项含 model_id、base_url、api_key、protocol 四字段；仅 status=online 的模型可导入，且 model_id 必须与 /v1/models 返回的 id 逐字符一致；导入后须点击模型卡片测试连接验证可用性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在 Synaplan 中一次性导入多个已配置好的 OpenAI 兼容接口模型，避免逐个手动添加导致配置错乱或遗漏关键参数。
确认兼容接口模型清单与可用性
先执行 GET /v1/models 请求，检查返回 JSON 中每个模型的 status 字段是否为 【online】；只有 status 为 online 的模型才允许批量导入，否则 Synaplan 会跳过该条目且不报错。
同步核对响应中 id 字段值与你在配置文件中写的模型名是否完全一致——大小写、连字符、版本后缀（如 -turbo、-plus）都必须逐字符匹配。
准备符合 Synaplan 格式的批量导入文件
新建一个 UTF-8 编码的 JSON 文件，命名为 models_batch.json。
文件根节点必须是数组，每个元素是一个对象，包含且仅包含以下 4 个字段：model_id（对应 /v1/models 返回的 id）、base_url（协议+域名+端口，不含路径）、api_key（明文字符串，不加密）、protocol（只能填 openai_chat、openai_responses 或 anthropic_messages 三者之一）。
示例片段：
[{"model_id":"qwen-plus","base_url":"https://dashscope.aliyuncs.com","api_key":"sk-xxx","protocol":"openai_chat"},{"model_id":"deepseek-chat","base_url":"https://api.deepseek.com","api_key":"sk-yyy","protocol":"openai_chat"}]
在 Synaplan 中执行批量导入
打开 Synaplan → 左侧导航栏点击「模型管理」→ 右上角点击「批量导入」按钮 → 选择刚保存的 models_batch.json 文件 → 点击「确认导入」。
导入过程无进度条，成功后页面自动刷新并显示新增模型卡片；若某条模型导入失败，Synaplan 不提示具体原因，只在控制台输出 Failed to import model: [model_id]，此时需检查该模型的 base_url 是否可被 Synaplan 主机网络直连、protocol 值是否拼写错误、api_key 是否含不可见空格。
导入完成后，立即点击任一新模型卡片进入详情页，验证「测试连接」按钮能否返回 HTTP 200 和非空 choices[0].message.content 字段——这一步不能跳过，因为 Synaplan 允许导入语法合法但实际不可用的模型配置。
