API 使用教程 - 无界API

一、快速开始

无界API提供统一的 AI 模型 API 接入方式。通过 API Key、 Base URL 和模型 ID，用户可以在支持兼容接口的开发工具和应用中调用模型服务。

1

注册账户

访问无界API官网

→

2

创建 Key

控制台创建令牌

→

3

选择模型

模型广场查询 ID

→

4

配置工具

填写接口参数

→

5

开始调用

测试并使用模型

官网地址

https://www.wjapi.cn/

控制台地址

https://www.wjapi.cn/dashboard/

模型广场

https://www.wjapi.cn/pricing

Base URL

https://www.wjapi.cn

⚠ API Key 等同于账户访问凭证。请勿将完整 Key 发布到公开代码仓库、前端页面、截图、聊天群或其他不受控环境。

二、接口信息

无界API的基础地址为 https://www.wjapi.cn，注意域名后不添加结尾斜杠。

官网地址	https://www.wjapi.cn/
控制台地址	https://www.wjapi.cn/dashboard/
模型广场	https://www.wjapi.cn/pricing
Base URL	`https://www.wjapi.cn`
Chat Completions 完整接口	`https://www.wjapi.cn/v1/chat/completions`
认证方式	`Authorization: Bearer 你的API Key`
模型 ID	从模型广场或控制台实时模型列表中复制。

URL

Base URL

用于告诉客户端请求发送到无界API： https://www.wjapi.cn

KEY

API Key

用于身份认证和额度计费，请从控制台创建并复制。

ID

模型 ID

决定实际调用哪个模型，必须使用当前账户组可用的真实模型 ID。

API

接口路径

OpenAI 兼容工具可能自动拼接 /v1/chat/completions。

三、模型与模型 ID

模型名称、模型 ID、上下文长度、视觉输入、工具调用和价格可能根据账户组、上游渠道及平台配置发生变化，因此本教程不固定写死模型清单。

当前可用模型请以模型广场和控制台实时列表为准。

打开模型广场

模型调用流程

A

输入请求

发送 API 请求

→

ID

模型 ID

指定目标模型

→

R

渠道路由

匹配可用渠道

→

AI

模型处理

生成响应结果

→

✓

返回结果

客户端显示

选择模型时需要确认

模型 ID 是否存在于当前模型广场。
当前 API Key 所属账户组是否有权限使用。
模型是否支持视觉输入、图片解析或音频输入。
模型是否支持函数调用或工具调用。
模型上下文窗口是否满足实际输入长度。
模型是否支持流式返回。

! 候选列表中存在某个模型名称，不等于当前账户组一定可以调用。如果出现模型不可用提示，请检查模型 ID、账户组和渠道权限。

四、API Key 管理

创建 API Key

访问 https://www.wjapi.cn/dashboard/ 并登录账户。
进入控制台中的令牌、密钥或 API Key 管理页面。
点击创建令牌密钥或新增 API Key。
根据页面提示设置名称、额度或有效期。
创建后复制完整 Key，并保存到安全位置。

! API Key 泄露后，其他人可能使用你的账户余额或调用额度。如怀疑泄露，请立即删除或禁用旧 Key，并重新创建新的 Key。

安全使用建议

1

环境变量

推荐将 API Key 放入服务器环境变量，不要直接写入代码。

2

独立密钥

不同项目使用不同 Key，便于统计和撤销。

3

定期轮换

定期更换长期使用的 Key，降低泄露风险。

4

及时禁用

发现异常调用时立即禁用旧 Key。

五、CC-Switch 配置

CC-Switch 是用于管理 Claude Code、Codex、Gemini CLI 等工具配置的第三方软件。具体界面和字段可能随软件版本变化，请以当前版本为准。

下载地址： https://github.com/farion1231/cc-switch/releases

通用配置流程

下载并安装与你的操作系统匹配的版本。
打开软件，在设置中启用需要集成的工具插件。
点击添加供应商或新建配置。
选择自定义配置或兼容接口配置。
填写供应商名称、API Key 和 Base URL。
从模型广场复制当前可用模型 ID。
保存配置并进行测试。
重新启动对应 CLI 工具或客户端。

供应商名称	无界API 或 WJAPI
API Key	控制台创建的实际 API Key
请求地址	`https://www.wjapi.cn`
模型名称	模型广场中实际可用的模型 ID

六、Claude Code 配置

打开 CC-Switch，选择添加 Claude 供应商。
选择自定义配置或兼容接口配置。
供应商名称填写“无界API”。
API Key 填写控制台创建的实际 Key。
请求地址填写 https://www.wjapi.cn。
模型字段填写模型广场中实际可用的模型 ID。
保存配置并测试。
完全退出并重新启动 Claude Code。

URL

请求地址

https://www.wjapi.cn

KEY

身份认证

填写控制台创建的 API Key。

ID

模型配置

填写模型广场中的实际模型 ID。

↻

重新启动

配置修改后重启客户端。

七、Codex 配置

打开 CC-Switch 或 Codex 的供应商配置页面。
选择自定义供应商或 OpenAI 兼容接口。
填写无界API API Key。
请求地址填写 https://www.wjapi.cn。
模型名称填写模型广场中实际可用的模型 ID。
保存并测试配置。
完全退出并重新启动 Codex CLI 或客户端。

i 如果 Codex 或 CC-Switch 会自动补充 /v1，不要在 Base URL 中重复填写版本路径。

八、Gemini CLI 配置

打开 CC-Switch，新增 Gemini 供应商。
选择自定义配置。
API Key 填写控制台创建的实际 Key。
请求地址填写 https://www.wjapi.cn。
模型名称从模型广场复制。
保存并测试配置。
完全退出并重新启动 Gemini CLI。

! 视觉、音频和工具调用并非所有模型或渠道都支持。如果调用失败，请检查模型能力、账户组权限和当前接口格式。

九、OpenAI 兼容工具配置

Chatbox、Cherry Studio、Continue、Cline、Kilo Code、Cursor、 Trea、WorkBuddy 等软件通常支持 OpenAI 兼容接口。

01

接口类型

选择 OpenAI Compatible。

02

Base URL

https://www.wjapi.cn

03

API Key

填写控制台中创建的实际 API Key。

04

模型 ID

从模型广场复制当前可用模型 ID。

Provider	OpenAI Compatible
API Key	无界API控制台创建的 API Key
Base URL	`https://www.wjapi.cn`
完整接口	`https://www.wjapi.cn/v1/chat/completions`
模型 ID	从模型广场复制当前账户实际可用模型 ID

十、Chatbox 配置

打开 Chatbox 设置页面。
进入模型提供方或供应商管理页面。
点击添加模型提供方。
API 模式选择 OpenAI API 兼容。
填写 API Key。
API 主机或 Base URL 填写 https://www.wjapi.cn。
添加模型广场中实际可用的模型 ID。
保存后新建对话，并选择刚刚添加的模型。

十一、Cherry Studio 配置

打开 Cherry Studio 设置。
进入模型服务商或模型平台管理页面。
点击添加自定义模型平台。
接口类型选择 OpenAI 兼容接口。
API 地址填写 https://www.wjapi.cn。
API Key 填写无界API控制台创建的 Key。
添加模型广场中实际可用的模型 ID。
保存后回到对话页面选择对应模型。

! 如果软件无法自动获取模型列表，可以手动添加模型 ID。手动添加前请确认该模型存在于模型广场，并且当前账户组有权限使用。

十二、VS Code、Cursor及其他IDE配置

VS Code、Cursor、Continue、Cline、Kilo Code、Trea、WorkBuddy等工具的配置界面和字段可能不同，但基本步骤如下。

安装对应的 AI 编程插件。
进入插件设置或模型设置。
供应商选择 OpenAI 或 OpenAI Compatible。
填写无界API API Key。
填写 Base URL：https://www.wjapi.cn。
添加模型广场中的实际模型 ID。
保存后在对话页面选择该模型。

Continue 配置示例

// 示例结构
{
  "model": "控制台中的实际模型ID",
  "provider": "openai",
  "apiKey": "你的API Key",
  "apiBase": "https://www.wjapi.cn/v1",
  "title": "无界API模型"
}

十三、接口调用示例

13.1 cURL 调用

curl https://www.wjapi.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "控制台中的实际模型ID",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下自己。"
      }
    ]
  }'

13.2 Python 调用

安装 OpenAI Python SDK：

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("WJAPI_API_KEY"),
    base_url="https://www.wjapi.cn"
)

response = client.chat.completions.create(
    model="控制台中的实际模型ID",
    messages=[
        {
            "role": "user",
            "content": "你好，请介绍一下自己。"
        }
    ]
)

print(
    response.choices[0].message.content
)

13.3 JavaScript 调用

const response = await fetch(
  "https://www.wjapi.cn/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer sk-your-api-key"
    },
    body: JSON.stringify({
      model: "控制台中的实际模型ID",
      messages: [
        {
          role: "user",
          content: "你好，请介绍一下自己。"
        }
      ]
    })
  }
);

const data = await response.json();
console.log(data);

13.4 使用环境变量保存 API Key

# macOS / Linux
export WJAPI_API_KEY="sk-your-api-key"

# Windows PowerShell
$env:WJAPI_API_KEY = "sk-your-api-key"

! 示例中的 API Key 和模型 ID 均为占位符，使用时必须替换为自己的实际值。

十四、常用 CLI 工具安装

检查 Node.js

node -v
npm -v

如果终端显示版本号，说明 Node.js 已安装。如果提示找不到命令，请先安装 Node.js LTS版本。

安装 Claude Code

npm install -g @anthropic-ai/claude-code
claude --version

安装 Codex

npm install -g codex
codex --version

安装 Gemini CLI

npm install -g @google/gemini-cli
gemini --version

十五、常见问题

为什么提示模型不存在或不可用？＋

可能原因包括：模型 ID填写错误、模型已调整、当前账户组没有权限、上游渠道未配置，或当前渠道不支持该模型。请从模型广场复制实际模型 ID，并确认当前账户组是否可用。

Base URL应该填写什么？＋

基础地址为 https://www.wjapi.cn，域名后不添加结尾斜杠。若软件要求完整对话接口，则填写 https://www.wjapi.cn/v1/chat/completions。

为什么修改配置后没有生效？＋

修改配置后通常需要完全退出并重新启动对应工具、终端、IDE或CLI程序。如果仍未生效，请检查是否存在多个配置文件或环境变量覆盖。

为什么出现 Invalid JSON response？＋

常见原因是 Base URL填写错误，软件请求到了网页首页、登录页或错误页；也可能是接口路径重复或遗漏。请根据软件要求区分填写基础地址和完整接口地址。

API Key泄露后怎么办？＋

立即进入控制台禁用或删除泄露的Key，重新创建新的API Key，同时检查近期调用记录和余额变化。不要继续使用已经公开的旧Key。

使用提示

本教程用于介绍常见配置思路。由于第三方软件、模型渠道和账户组配置可能持续变化，具体界面、可用模型、参数限制和接口能力请以无界API当前控制台、模型广场和开发文档为准。

进入控制台查看当前模型

使用统一 API Key 接入多家 AI 模型服务

一、快速开始

二、接口信息

Base URL

API Key

模型 ID

接口路径

三、模型与模型 ID

模型调用流程

选择模型时需要确认

四、API Key 管理

创建 API Key

安全使用建议

环境变量

独立密钥

定期轮换

及时禁用

五、CC-Switch 配置

通用配置流程

六、Claude Code 配置

请求地址

身份认证

模型配置

重新启动

七、Codex 配置

八、Gemini CLI 配置

九、OpenAI 兼容工具配置

接口类型

Base URL

API Key

模型 ID

十、Chatbox 配置

十一、Cherry Studio 配置

十二、VS Code、Cursor及其他IDE配置

Continue 配置示例

十三、接口调用示例

13.1 cURL 调用

13.2 Python 调用

13.3 JavaScript 调用

13.4 使用环境变量保存 API Key

十四、常用 CLI 工具安装

检查 Node.js

安装 Claude Code

安装 Codex

安装 Gemini CLI

十五、常见问题

使用提示

使用统一 API Key
接入多家 AI 模型服务