用一套配置，完成第一次模型调用
这是一条面向实际控制台的最短路径：登录后准备模型配置，保存与配置关联的 Access Key，复制推理 Base URL 和下游模型 ID，再发出一个最小请求验证。
登录控制台
使用已有账号登录路墨（Lumoswitch）控制台。首次使用时，先完成账号验证；登录后再创建或维护你的模型与调用配置。
接入或选择候选模型
在控制台接入已有的上游模型凭据，或选择当前部署中已可用的模型资源。随后创建一个模型配置，选择候选模型和需要的调度方式，并定义客户端使用的下游模型 ID。
创建配置并保存 Access Key
提交模型配置后，控制台会生成与该配置关联的 Access Key。完整 Key 仅在创建时展示一次，请立即复制并保存在适合你团队的密钥管理位置。
复制 Base URL 与下游模型 ID
从配置或客户端接入页面复制 Lumoswitch 推理 Base URL，并使用该配置定义的下游模型 ID。不要把上游服务商的凭据直接放进客户端；客户端应使用这组配置关联的调用信息。
发送一个最小请求验证
先用最小请求验证鉴权、模型 ID 和返回格式，再接入正式应用。若调用失败，依次检查配置是否启用、模型是否可调用、Key 是否保存正确，以及账户和运行状态是否满足当前调用条件。
最小验证示例
先确认一条请求能够完整返回
下例假设控制台展示的 Base URL 已包含对应 API 版本路径。请替换环境变量，实际路径、接口能力和模型 ID 以当前控制台与文档为准。
curl "$LUMOSWITCH_BASE_URL/chat/completions" \
-H "Authorization: Bearer $LUMOSWITCH_ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_DOWNSTREAM_MODEL_ID",
"messages": [{ "role": "user", "content": "你好" }]
}'上线前检查
- 完整 Access Key 只在创建时展示一次；确认已保存且未写入前端代码或公开仓库。
- 客户端填写的是配置的下游模型 ID，不是任意上游模型名称。
- 先验证一个最小请求，再结合当前配置、模型状态与账务条件接入正式流量。