接入文档

本页用于放置面向客户的静态接入说明，建议长期保持简洁、稳定、少变更。

接入说明

1. 在官网完成额度兑换后，进入控制台创建 API Key。

2. 将 Base URL 设置为你的接入地址，例如 https://api.apiops.cloud。

3. 在 Cline、Cursor、Codex 或其他兼容 OpenAI 协议的客户端中填入 API Key 与 Base URL。

4. 模型名称请以控制台展示为准，若调用失败，优先检查模型名是否与后台映射一致。

一键脚本

你可以在这里放置客户初始化脚本，例如 Windows PowerShell 一键配置或 macOS/Linux Shell 一键配置。

# Windows PowerShell 示例
# 请替换为你的真实脚本下载地址
irm https://docs.apiops.cloud/bootstrap.ps1 | iex

# macOS / Linux 示例
curl -fsSL https://docs.apiops.cloud/bootstrap.sh | bash

常见排障

1. 提示 401：检查 API Key 是否复制完整，是否误带空格，账户是否存在可用额度。

2. 提示 403：检查来源 IP、地区限制、风控规则或管理端白名单配置。

3. 提示 404：通常是 Base URL 或模型名称填写错误，请核对路径与模型映射。

4. 提示 429：说明当前请求频率过高或配额不足，请稍后重试或升级套餐。

5. 提示超时：优先排查上游模型延迟、Cloudflare 代理策略、服务器出口网络与并发设置。