APIOps | 接入文档

快速开始

确认本机已安装 Node.js。
登录平台。
如果收到的是兑换码，请先完成额度到账。
进入 API Key 页面，创建自己的个人 Key；除非客服明确要求，否则保持系统默认设置，不要自行选择其他分组。
复制并保存 Key，再运行对应脚本。
客户端统一使用 https://api.apiops.cloud/v1 作为 Base URL。

首次使用建议先完整走一遍本文档，再开始正式调用。

Node.js 环境安装教程

如果你使用的是 Codex CLI 或依赖本地 Node.js 运行环境的接入方式，请先确认本机已经安装 Node.js。已安装的用户可以直接跳过本节。

打开 PowerShell 或终端，执行 node -v。
再执行 npm -v。
如果两条命令都能正常返回版本号，说明环境已经可用。
如果提示命令不存在，请安装 Node.js LTS 版本后再继续接入。

Windows 检查命令

node -v
npm -v

安装完成后建议

安装 Node.js 后，重新打开 PowerShell 再执行上面的版本检查命令，确认环境已生效。

如果你是通过脚本一键接入，脚本会优先使用现有环境；环境缺失时，建议先完成 Node.js 安装再继续。

账号与额度

平台账号用于登录、查看额度、创建 API Key 和日常使用。兑换码仅用于账户额度，不构成模型升级承诺。

收到兑换码

登录平台后，先在余额或钱包区域完成额度到账，再继续后续接入动作。

收到已到账账号

可以直接跳过兑换动作，进入 API Key 页面创建自己的 Key。

API Key 创建

打开平台中的 API Key 页面。
创建一个新的个人 Key；除非客服明确要求，否则保持系统默认设置，不要自行选择其他分组。
创建完成后复制保存，不要随意分享给他人。
同一账号可在自己的常用设备上继续使用这个 Key。

建议每位用户使用自己的个人 Key，不要共享给他人或自行修改分组。兑换码仅用于账户额度；可调用模型以平台当前为该账号展示且实际可用的范围为准。

脚本接入

当前公开提供两套脚本。脚本写入的是接入地址和预设模型，不代表只能使用某一个模型系列。

Windows PowerShell

irm https://api.apiops.cloud/install/codex-trial.ps1 | iex

irm https://api.apiops.cloud/install/codex-retail.ps1 | iex

脚本预设模型

体验脚本预设：gpt-5.4-mini
正式脚本预设：gpt-5.6-terra
正式脚本附加高质量文本模型：gpt-5.5

脚本会提示输入你的 API Key，并把接入配置写入本地客户端目录。配置完成后，重启客户端即可生效。

该命令会下载并执行 APIOps 官方配置脚本。仅从 api.apiops.cloud/install/ 获取脚本；设备受限时请使用手动配置，不建议关闭系统安全策略或从第三方链接下载脚本。

Codex 手动配置

如果一键脚本不可用，或你希望手动检查配置内容，可以直接按下面方式创建 Codex 配置文件。

安装 Codex CLI

npm install -g @openai/codex@latest
codex --version

适用说明

此方式适合希望手动查看配置文件、自己调整预设模型，或一键脚本受限时使用。

model_provider = "codex"
model = "gpt-5.6-terra"
review_model = "gpt-5.5"
model_reasoning_effort = "medium"

[model_providers.codex]
name = "codex"
base_url = "https://api.apiops.cloud/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }

把上面的内容写入 ~/.codex/config.toml。配置完成后，重启 Codex CLI 或 Codex App 即可。

API 手动接入

如果你使用的是第三方客户端、自建脚本或开发项目，可以直接按接口类型手动填写地址与模型。

OpenAI / Codex 路线

Base URL：https://api.apiops.cloud/v1
常见接口：/chat/completions
已验证模型：gpt-5.4-mini、gpt-5.5、gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol

curl https://api.apiops.cloud/v1/chat/completions ^
  -H "Authorization: Bearer YOUR_API_KEY" ^
  -H "Content-Type: application/json" ^
  -d "{\"model\":\"gpt-5.6-terra\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

如果你的客户端要求填写“OpenAI 兼容接口”，请使用带 /v1 的地址。本文档只覆盖当前已验证的 OpenAI / Codex 接入方式。

模型切换说明

完成脚本接入后，你仍然可以在客户端内切换其他已开放模型。只要你的账号有权限，并且模型在页面或客户端中可见，就可以正常调用。

当前已验证模型

gpt-5.4-mini
gpt-5.5
gpt-5.6-luna
gpt-5.6-terra
gpt-5.6-sol

如果你在客户端里看不到某个模型，通常表示该模型当前未对你的账号开放。此时以页面显示和账号实际可见范围为准。

版本说明

体验版

适合先验证连通性、客户端配置和基础调用流程。

标准版

适合大多数日常文本场景，是当前最均衡、也最容易上手的主力版本。

进阶版

适合需要更多额度或订单约定服务的用户；不构成额外模型权限承诺。

公开目录参考

当前公开文档仅列出已验证的 GPT 模型；其他模型以平台后续实际开放和公告为准。

常见问题

脚本是不是只能用预设模型？ 不是。脚本只负责写入预设模型和接入地址；你只能选择平台当前为该账号展示且实际可用的模型。
看不到某个模型怎么办？ 请以平台模型列表和账号实际可见范围为准；商品页面未明确列出的模型不构成默认交付承诺。
为什么没有公开 TRAE、Hermes、OpenClaw 教程？ 当前公开文档优先覆盖主力接入方式，减少误操作；其他高级客户端会在逐项实测完成后再开放。
连不上怎么办？ 先检查 Base URL 是否为 https://api.apiops.cloud/v1，再确认 API Key 是否复制完整。
脚本运行后没有反应怎么办？ 重新打开 PowerShell，再复制完整命令执行一次。
额度为什么没有到账？ 如果收到的是兑换码，请先完成额度到账；如果仍未到账，再按订单信息核对。

接入说明