Appearance
BaseURL · ApiKey · 模型名 · 最小验证
通用接入
这一页只讲所有工具都通用的鬼魅云接入要点。无论你后面使用 Codex、OpenCode、Hermes 还是其他客户端，都应该先确认 BaseURL、ApiKey、模型名和最小请求可以跑通。
第一步：确认三项核心配置
大多数接入失败都可以归结为 Key、地址或模型名三者之一填写错误。开始配置工具前，先把这三项固定下来。
ApiKey
从后台 API 密钥 页面创建，并确认可用渠道、模型限制和余额开关。
BaseURL
OpenAI 兼容入口通常填写 https://gvmz.systems/v1。部分专用接口会在对应页面单独说明。
模型名
从模型列表复制实际模型名，不要手动猜测。模型名、渠道权限和 Key 权限需要同时匹配。
第二步：先用最小请求验证
在接入任何客户端之前，建议先用一个最小请求验证 Key、BaseURL 和模型是否可用。
bash
curl https://gvmz.systems/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的ApiKey" \
-d '{
"model": "gpt-5.5",
"messages": [
{ "role": "user", "content": "你好" }
],
"stream": false
}'先验证再接工具
如果最小请求都不通，先不要继续改客户端配置。优先回到 ApiKey、余额和模型列表页面检查权限与模型名。
第三步：按客户端填写配置
OpenAI 兼容客户端
通常只需要填写 BaseURL、ApiKey 和 model。
Codex / CLI 工具
继续查看后面的 Codex、Claude Code 或 CC-Switch 页面。CLI 工具可能还需要本地配置文件或环境变量。
专用接口
Claude、Gemini、绘图接口等可能使用不同路径或请求头，具体以对应页面示例为准。
常见检查项
- 请求头里是否正确填写 Authorization: Bearer sk-...。
- BaseURL 是否多写或少写了 /v1。
- 模型名是否来自当前模型列表，而不是旧文档或其他平台。
- ApiKey 是否开启了模型限制，且当前模型是否在允许范围内。
- 余额是否足够，套餐耗尽后是否允许继续使用余额。