> For the complete documentation index, see [llms.txt](https://scx.gitbook.io/sc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scx.gitbook.io/sc/scp-docs/speedcentre+-copilot-shi-yong.md).

# SpeedCentre+ Copilot - 使用

## 生成 API 密钥

前往 设置 页面，打开 API 访问并生成一个 API 密钥。出于安全考虑，API密钥只在生成时显示一次，请妥善保管。

<figure><img src="https://3663504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLAVSWReLAyQHcKIkTIuu%2Fuploads%2FRjJ6cLab1DqgcMDcuaw6%2F%E6%88%AA%E5%B1%8F2026-08-04%20%E6%99%9A%E4%B8%8A10.43.10.png?alt=media&amp;token=c7883808-afc6-4953-b4f7-f66c40c4e83e" alt="" width="563"><figcaption></figcaption></figure>

### 调用 API

您可以使用 API 方式调用 SpeedCentre+ 测试服务，通过 SpeedCentre+ API，您可以发起/管理任务，管理订阅，发起分享等，也可以通过 Miaospeed 兼容 API 将您的测速机器人对接进 SpeedCentre+ 服务。

目前通过 API 发起的测试仅支持部分后端，您可以在 Web 平台后端页面查看支持 Copilot 调用的后端，或者通过 API 读取受支持的后端。

在使用 API 前，我们推荐您查看 [相关概念](/sc/scp-docs/speedcentre+-copilot-gai-nian.md) 和 [定价](/sc/scp-docs/ding-jia-he-xian-zhi.md#speedcentre-copilot-ji-fen-xiao-hao) 以详细了解 SpeedCentre+ Copilot 的运行机制和积分消耗。

您可以通过两种方式调用 SpeedCentre+ Copilot API:

* HTTP API
* Miaospeed 兼容 API

Copilot 还有反劫持测速，TG测速等特色功能，我们亦编写了一套脚本编写指南指导您快速上手测试脚本，敬请查看[了解更多](/sc/scp-docs/liao-jie-geng-duo.md)。

#### 通过 HTTP API 发起调用

SpeedCentre+ Copilot 的 API Endpoint 为 `https://api.speedcentre.plus/api/v1` ，您可以编写自动化工具调用该 API 实现更复杂的测试。

更多信息请查看 [API 文档](/sc/scp-docs/api-wen-dang.md)，您可以获取详细的 API 定义，在 API Playground 中测试，并下载我们的 OpenAPI 文档以于您的应用快速集成。

#### 通过 Miaospeed 兼容 API 发起调用

SpeedCentre+ Copilot 具有兼容 [原版 Miaospeed](https://github.com/miaokobot/miaospeed) 的 Websocket API，端点为 `wss://api.speedcentre.plus/miaospeed` 。您需要在测速设施中传入 `endpoint + "/{apiKey}/{slaveID}"` 进行测试。

{% hint style="info" %}
当您在使用的某些测速机器人（如 Miaoko）不支持某些新矩阵，您可以使用兼容性方式调用并显示结果。详细内容请查看[文档](/sc/scp-docs/liao-jie-geng-duo.md#yi-jian-rong-xing-fang-shi-diao-yong-mou-xie-ju-zhen-matrix)。
{% endhint %}

**在测速机器人中对接 SpeedCentre+ 后端**

您可以在各类测速机器人中对接 SpeedCentre+ Copilot 后端。这里以 Koipy 为例展示对接流程：

1. 根据 [Koipy 文档](https://koipy.gitbook.io/koipy/kuai-su-kai-shi) 安装，配置并激活 Koipy。
2. 获取 Copilot API Token。
3. 在配置中添加 SpeedCentre+ Copilot 后端，以下是配置示例，更多有关配置信息，敬请查看 Koipy 文档：<br>

   ```yaml
   slaveConfig: 
     slaves: 
       - type: miaospeed 
         id: "BJCM" # 后端id
         token: "sk-a1b2c3d4e5f6a1b2c3d4e5f6" # API 密钥
         address: "api.speedcentre.plus"
         path: "/miaospeed/sk-a1b2c3d4e5f6a1b2c3d4e5f6/BJCM"
         tls: true 
         comment: "北京移动@1Gbps" 
         hidden: false
         option:
           downloadDuration: 8 
           downloadThreading: 4 
           downloadURL: https://dl.google.com/dl/android/studio/install/3.4.1.0/android-studio-ide-183.5522156-windows.exe
           pingAddress: https://cp.cloudflare.com/generate_204 
           pingAverageOver: 3 
           stunURL: udp://stunserver2025.stunprotocol.org:3478
           taskRetry: 3
           taskTimeout: 2500
           dnsServer: []
           apiVersion: 1 # SC Coiplot Miaospeed API 只兼容通用格式，请保留 1
           # uploadURL: https://speed.cloudflare.com/__up 不支持上传测试，该字段无效
           # uploadDuration: 8 不支持上传测试
           # uploadThreading: 4 不支持上传测试
   ```