开始前准备
- 已安装 OpenCode Desktop。
- 已登录 1A1API 控制台。
- 账号内有可用订阅、余额或额度。
- 准备复制一个
sk-开头的 API 密钥。
OpenCode 图文接入
OpenCode 图文接入
OpenCode 接入 1A1API
照着截图做：创建 API 密钥，添加自定义提供商，填接口根地址（Base URL）、API 密钥和模型 ID，最后发一句话测试。
截图版本：2026-07-12 的 OpenCode Desktop 界面；字段位置可能随版本变化 最后验证：2026-07-20
开始前
准备好提供商、地址、密钥和模型
已创建 1A1API 的 API 密钥，且账号有可用余额、订阅或额度时，按这页把模型接入 OpenCode Desktop。示例使用 gpt-5.6-sol，实际以当前 API 密钥可用模型列表为准。
安全提醒
API 密钥只粘贴到 OpenCode 的 API 密钥输入框，不要发到群里、聊天窗口、公开截图或公开仓库。下面截图中的密钥已做脱敏处理。
提供商 ID
1a1api显示名称
1A1API接口根地址（Base URL）推荐
https://1a1api.top/v1；备用 https://1a1api.com/v1 只在 .top 访问不稳定时尝试。API 密钥粘贴 1A1API 控制台复制的完整
sk-...。模型 ID从当前分组可用列表复制；
gpt-5.6-sol 仅作测试示例。测试语句
Reply with exactly: ok
模型 ID 以你的 1A1API 控制台、套餐说明或模型列表为准。显示名称只是给自己看的名字；如果提示模型不存在，优先检查当前分组是否开通该模型。
图 1
进入 API 密钥页面
登录控制台后，在左侧菜单点击“API 密钥”。
图 2
点击“+ 创建密钥”
在 API 密钥页面右上角创建新密钥。
图 3
复制 API 密钥
创建后请立即复制并安全保存。列表中如只显示脱敏片段，不要凭片段手动补全；无法确认完整值时，重新创建一个密钥。
图 4
打开 OpenCode 设置
在 OpenCode Desktop 左下角点击齿轮图标。
图 5
连接自定义提供商
进入“服务器 → 提供商”，找到自定义提供商并点击连接。
图 6
填写 1A1API 提供商配置
按上方表格填写 ID、名称、接口根地址（Base URL）、API 密钥和模型 ID。
图 7
回到主界面选择模型
点击输入框附近的模型选择器。
图 8
选择 1a1api 分组模型
截图为旧版界面示意；当前请选择刚添加的模型或分组内其他可用模型。
OpenCode 接入测试提示词
Reply with exactly: ok提示 API key 无效或 401 怎么办？
检查 API 密钥是否复制完整，是否粘贴到了“API 密钥”输入框，账号是否还有可用额度。
提示模型不存在或 404 怎么办？
大多数情况是模型 ID 不在当前分组里。请回到 1A1API 控制台或套餐说明复制当前可用模型；不要根据旧截图猜写。
提示额度不足、429 或 rate limit 怎么办？
说明当前密钥、账号、分组或订阅额度可能已经用完，或者短时间请求太多。可以先等待一会儿再试，或检查 1A1API 控制台额度。
OpenCode 里看不到刚添加的模型怎么办？
回到“设置 → 服务器 → 提供商”确认 1A1API 配置还在；如果仍然不显示，可以重启 OpenCode Desktop 后再打开模型选择器。
Base URL 应该填哪个？
本教程推荐 https://1a1api.top/v1。如果你的网络访问 .top 不稳定，可以尝试备用 https://1a1api.com/v1。如果控制台单独提供了其他 OpenAI 兼容地址，以控制台当前显示为准，但末尾通常需要带 /v1。