FlexAPI Docs

主题

OpenCode 使用指南 ​

这份教程旨在让你在最短时间内完成 FlexAPI 与 OpenCode 的对接。

右侧为页面导航，可根据需要直接导航到指定位置

Step 1: 获取 API Key ​

1. 登录 FlexAPI 控制台 ​

前往 FlexAPI，登录并选择对应的分组，创建 FlexAPI API Key。

2. 充值额度或购买订阅 ​

按照使用模式，选择按时长订阅或充值额度按量付费。

3. 获取 API Key ​

在控制台创建或复制你的 FlexAPI API Key，后续配置 CLI 和客户端时都要用到。

参考：FlexAPI API获取教程

Step 2:安装 OpenCode ​

  • 参考 OpenCode 官方文档完成安装
  • 确保能正常打开配置目录
bash
# 方法一：官方安装脚本
curl -fsSL https://opencode.ai/install | bash

# 方法二：Homebrew
brew install anomalyco/tap/opencode

# 方法三：npm
npm install -g opencode-ai

# 方法四：Bun
bun add -g opencode-ai
powershell
# 方法一：Chocolatey
choco install opencode

# 方法二：Scoop
scoop bucket add extras
scoop install extras/opencode

# 方法三：npm
npm install -g opencode-ai

Step 3:配置 ​

配置文件位置 ​

默认配置文件路径：

text
~/.config/opencode/opencode.json

Windows 路径：

text
%USERPROFILE%\.config\opencode\opencode.json

更多配置说明可查看官方配置文档：https://opencode.ai/docs/config/

你也可以在项目根目录放置 opencode.json 作为项目级配置（优先级更高）。

准备 opencode.json ​

请务必把文件中的 apiKey 替换成你在 FlexAPI 申请的真实 key。

手动配置（推荐所有平台） ​

1.新建目录：%USERPROFILE%\.config\opencode（macOS / Linux 则是 ~/.config/opencode）

2.将 opencode.json 复制为 opencode.json 到上面目录

3.编辑文件，将 apiKey 改成你的真实 key

自动配置脚本 ​

Windows 脚本 ​

在 opencode-config 目录中运行：

bash
opencode-config.bat

Windows 脚本已内置 opencode.json，无需额外下载配置文件。

macOS / Linux 脚本 ​

在 opencode-config 目录中运行：

bash
sh opencode-config.sh

注：macOS / Linux 脚本需要同目录下的 opencode.json；该脚本未在 Windows 上测试，仅供 macOS / Linux 使用。

配置示例 ​

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "flexapi": {
      "npm": "@ai-sdk/openai",
      "name": "FlexAPI",
      "options": {
        "baseURL": "https://flexapi.me",
        "setCacheKey": true,
        "apiKey": "your-flexapi-api-key"
      },
      "models": {
        "gpt-5.2": {
          "name": "gpt-5.2"
        }
      }
    }
  }
}

常见问题 ​

Q: 启动后看不到 FlexAPI provider ​

先确认 opencode.json 放在正确目录，再检查 JSON 语法是否完整。

Q: 提示 apiKey 无效 ​

优先核对 Key 是否已经替换掉模板值，以及 Base URL 是否是你的正式网关地址。

Q: Base URL 应该填哪个 ​

本页默认使用 https://flexapi.me。

FlexAPI Docs

Copyright © 2026 FlexAPI