GMI Cloud Inference Engine是全球 AI 模型统一接入与在线使用的“高性能推理引擎平台”底层搭载 H100/H200 芯片集成全球近百个最前沿的大语言模型和视频生成模型如 Minimax、DeepSeek、GPT OSS、Qwen、Kling 等为 AI 开发者与企业提供速度更快、质量更高的模型服务。欢迎来到OpenCode 接入 GMI Cloud Inference Engine 实操教程【AI coding加速篇】本期任务目标在 OpenCode 中无缝接入 GMI Cloud Inference Engine解锁众多模型的终端交互式使用体验借助 OpenCode 便捷的命令行能力打造高效的本地 AI 开发辅助工具OpenCode 是一款轻量强大的终端 AI 工具可直接在终端启动交互式界面灵活配置多模型让开发者无需切换平台快速调用大模型能力。话不多说全系统通用步骤专属操作跟着做轻松完成对接即刻开启终端 AI 新体验01准备工作环境与密钥就绪get ready工欲善其事必先利其器先完成基础准备让后续配置零阻碍 系统与环境要求支持MacOS、Windows 原生环境无需额外配置复杂依赖终端/PowerShell 可正常执行命令即可。 获取 GMI Cloud API KeyAPI Key 是对接的核心凭证务必妥善保管切勿公开分享登录 GMI Cloud Inference Engine 官方地址点击页面右上角个人头像选择【API Keys】点击【Create API Key】生成后立即复制密钥仅创建时可见刷新后无法查看 安装 OpenCode全系统均支持官方标准安装方式根据自己的设备系统选择对应方案一键完成安装Mac 端需打开终端直接运行以下命令curl -fsSL https://opencode.ai/install | bashWindows 端建议使用npm install -g opencode-ai或直接安装 OpenCode 桌面版。该命令将自动完成以下操作✅ 在用户环境中安装 OpenCode 核心程序✅ 配置 opencode 命令行工具支持终端直接调用✅ 完成基础环境适配可直接启动 OpenCode 界面02核心配置全系统分步操作Core configuration配置后可直接在 OpenCode 中调用 GPT 5.1、GPT 5.4 模型每一步都清晰易懂跟着操作即可统一步骤创建配置目录全系统通用如目录不存在请先创建配置目录确保后续配置文件可正常读写。Mac 端终端执行mkdir -p ~/.config/opencodemkdir -p ~/.local/share/opencodeWindows 端 PowerShell 执行New-Item -ItemType Directory -Force $env:USERPROFILE\.config\opencode | Out-NullNew-Item -ItemType Directory -Force $env:USERPROFILE\.local\share\opencode | Out-Null步骤1写入统一提供商配置文件全平台provider ID 统一为 gmi配置内容完全一致建议使用 VS Code / Notepad 编辑文件避免格式报错✅ Mac 端操作终端中创建并编辑配置文件vi ~/.config/opencode/opencode.jsonc粘贴以下统一配置内容按 esc:wq 保存退出{$schema: https://opencode.ai/config.json,provider: {gmi: {npm: ai-sdk/openai-compatible,name: GMI Cloud,options: {baseURL: https://api.gmi-serving.com/v1,apiKey: {env:GMI_API_KEY}},models: {openai/gpt-5.4: {name: GPT 5.4},openai/gpt-5.1: {name: GPT 5.1}}}}}✅ Windows 端操作PowerShell 直接创建并编辑文件无需手动找目录notepad $env:USERPROFILE\.config\opencode\opencode.jsonc粘贴上方完全相同的统一配置内容建议使用 VS Code 或 Notepad 保存避免 BOM 导致 OpenCode 解析失败。 关键提醒配置文件中必须使用英文双引号不可用中文引号否则会导致配置失效步骤2写入统一认证配置文件auth.json 与 provider ID 严格保持一致全平台配置内容相同✅ Mac 端操作终端执行vi ~/.local/share/opencode/auth.json粘贴以下内容后保存退出{ gmi: { type: api, key: {env:GMI_API_KEY} }}✅ Windows 端操作PowerShell 执行notepad $env:USERPROFILE\.local\share\opencode/auth.json粘贴上方完全相同的统一认证内容使用 VS Code / Notepad 保存即可。步骤3配置 GMI_API_KEY 环境变量将已复制的 GMI Cloud API Key 配置为系统环境变量让 OpenCode 可正常读取✅ Mac 端操作终端中直接运行以下命令将 YOUR_GMI_API_KEY 替换为实际复制的 API Keyexport GMI_API_KEYYOUR_GMI_API_KEY 提醒该命令仅对当前终端窗口有效关闭终端后需重新执行。✅ Windows 端操作PowerShell 中运行以下命令替换密钥后执行[Environment]::SetEnvironmentVariable(GMI_API_KEY, YOUR_GMI_API_KEY, User)验证配置[Environment]::GetEnvironmentVariable(GMI_API_KEY, User)返回密钥即为配置成功。步骤4重启并验证 OpenCode启动/重启 OpenCodeMac 端直接在终端运行命令 opencodeWindows 端如果安装的是 CLI运行 opencode如果安装的是桌面版重启 OpenCode 应用即可验证配置有效性在 OpenCode 界面中运行命令 /models若能看到 GMI Cloud、GPT 5.1、GPT 5.4即为配置成功。03进阶玩法界面快捷配置Advanced Operations步骤5界面快速配置/修改提供商无需手动编辑文件OpenCode 支持界面内可视化配置操作更便捷✅ 全平台通用操作启动 OpenCode 后在界面中直接运行命令/connect2. 在弹出的提供商列表中可完成两种操作- 直接选择【GMI Cloud】快速建立连接- 找到已配置的【GMI Cloud】修改 API Key 等参数3. 配置完成后GMI Cloud 将显示在提供商列表中直接选中即可使用。步骤6扩展添加更多模型按需添加 GMI Cloud 支持的其他模型丰富使用场景✅ 全平台通用操作打开步骤1中的 opencode.jsonc 配置文件在 models 字段下按以下格式添加新模型{$schema: https://opencode.ai/config.json,provider: {GMI Cloud: {npm: ai-sdk/openai-compatible,name: GMI Cloud,options: {baseURL: https://api.gmi-serving.com/v1,apiKey: {env:GMI_API_KEY},headers: {Authorization: Bearer {env:GMI_API_KEY}}},models: {openai/gpt-5.4: {name: GPT 5.4},openai/gpt-5.1: {name: gpt 5.1}}}}}3. 保存文件后重启 OpenCode 使配置生效- Mac 端关闭终端重新打开运行 opencode- Windows 端关闭 OpenCode 应用重新启动CLI 模式需重新运行 opencode4. 验证新模型在 OpenCode 界面运行命令 /models即可在 GMI Cloud 提供商下看到新增模型选中即可使用。 关键提醒新增模型的 ID 需与 GMI Cloud 平台支持的模型 ID 完全一致否则无法正常调用04常见坑避坑指南Guide to Avoiding Errors❌ 配置文件用了中文引号全部替换为英文双引号❌ Windows 文件格式报错使用 VS Code / Notepad 保存❌ 无法连接检查 API Key 是否正确配置、网络是否通畅❌ Mac 终端关闭后失效重新执行export命令即可教程完毕 现在你可以在 OpenCode 中自由调用 GMI Cloud Inference Engine 平台中的海量模型在终端中高效完成AI辅助开发、内容生成等操作
