# Black AI 使用教程 > 本文根据 Black AI 官方教程整理，适合用于给用户说明如何获取 Black AI API 密钥，并在常见 AI 客户端中配置使用。 ## 1. 教程目标通过本文，你可以完成以下操作： 1. 注册并登录 Black API 平台； 2. 创建 Black AI 的 API 令牌； 3. 复制 API 密钥； 4. 在支持自定义 API 的 AI 客户端中配置 Black AI； 5. 了解常见可用客户端及其支持平台。 --- ## 2. 获取 Black AI API 密钥 ### 2.1 访问 Black API 官网打开 Black API 官网： - 官网地址：进入网站后，点击右上角的 **“注册”**。 --- ### 2.2 使用 Black One-ID 注册 / 登录在注册页面中，选择 **“使用 Black One-ID 继续”**。随后可以选择合适的注册方式。官方示例中使用的是 **微信注册**，你也可以根据页面提供的方式选择其他注册方式。 --- ### 2.3 进入控制台登录成功后，按照以下路径进入令牌创建页面： ```text 左上角「控制台」 → 左侧菜单「令牌管理」 → 「添加令牌」 ``` --- ### 2.4 添加令牌在添加令牌页面中填写以下信息： | 配置项 | 填写说明 | |---|---| | 名称 | 可随意填写，建议填写便于识别的名称，例如 `Black AI`、`Chatbox`、`Cherry Studio` 等 | | 令牌分组 | 选择 `Black AI` | 填写完成后，点击提交。 --- ### 2.5 复制 API 密钥令牌创建完成后，点击页面中的复制按钮，复制生成的 API 密钥。 API 密钥通常以： ```text sk-xxxxxxxxxxxxxxxx ``` 开头。 > ⚠️ 注意：API 密钥非常重要，请勿随意泄露。如果发现密钥泄露，应立即删除对应令牌，并重新创建新的令牌。 --- ## 3. API 配置信息在支持自定义 API 的 AI 客户端中，可以使用以下配置： | 配置项 | 内容 | |---|---| | API 调用地址 / Base URL | `https://llmapi.black.ac.cn/v1` | | API Key / 密钥 | 填入刚刚复制的、以 `sk` 开头的密钥 | 常见填写方式如下： ```text Base URL: https://llmapi.black.ac.cn/v1 API Key: sk-xxxxxxxxxxxxxxxx ``` 部分客户端可能会将 `Base URL` 显示为： - API 地址 - API Endpoint - OpenAI API Base URL - 自定义接口地址 - Compatible API URL 这些通常都填写： ```text https://llmapi.black.ac.cn/v1 ``` --- ## 4. 常见支持平台以下是官方教程中列出的常见 AI 客户端平台。 | AI 平台 | 客户端支持 | 下载链接 | 使用教程 / 说明 | |---|---|---|---| | ChatBox AI | iOS / macOS / Windows / Android | | | | LobeHub | iOS / macOS / Windows / Android / Linux | | | | Cherry Studio | Windows / macOS / Linux | | | | Enchanted | iOS / macOS | | | | LibreChat | Docker | | | | AnythingLLM | Docker / macOS / Windows / Linux | | | --- ## 5. 客户端通用配置流程不同客户端界面略有差异，但通常都可以按照以下流程配置： 1. 打开 AI 客户端； 2. 进入 **设置**、**模型设置**、**API 设置** 或 **Provider 设置**； 3. 选择添加自定义模型服务，通常选择以下类型之一： - OpenAI - OpenAI Compatible - Custom API - 自定义模型供应商 4. 填写 API 地址： ```text https://llmapi.black.ac.cn/v1 ``` 5. 填写 API Key： ```text sk-xxxxxxxxxxxxxxxx ``` 6. 保存配置； 7. 选择可用模型； 8. 新建对话并测试是否可以正常回复。 --- ## 6. 安全建议为了避免 API 密钥泄露或被滥用，建议遵守以下规则： 1. 不要将 API Key 发送到微信群、QQ群、论坛、GitHub 公开仓库等公开环境； 2. 不要把密钥写死在前端代码中； 3. 不要截图公开展示完整 API Key； 4. 如果多人使用，建议为不同客户端或不同用户创建不同令牌； 5. 如果怀疑泄露，立即删除旧令牌并重新创建； 6. 定期检查令牌使用情况和额度消耗。 --- ## 7. 常见问题 ### Q1：API 地址应该填什么？填写： ```text https://llmapi.black.ac.cn/v1 ``` --- ### Q2：API Key 填什么？填写你在 Black API 控制台中创建并复制的密钥，通常以 `sk` 开头。 --- ### Q3：为什么客户端提示连接失败？可以检查以下内容： 1. API 地址是否填写正确； 2. API Key 是否复制完整； 3. 是否选择了 OpenAI Compatible 或自定义 API 模式； 4. 当前网络是否可以访问 `llmapi.black.ac.cn`； 5. 令牌是否被删除、禁用或额度不足。 --- ### Q4：密钥泄露了怎么办？立即进入 Black API 控制台，删除泄露的令牌，然后重新创建新的令牌。 --- ## 8. 快速配置模板你可以直接复制以下模板到支持自定义 API 的客户端中： ```text Provider Type: OpenAI Compatible Base URL: https://llmapi.black.ac.cn/v1 API Key: sk-xxxxxxxxxxxxxxxx ``` --- ## 9. 版本说明本文根据 Black AI 官方使用教程整理，原文地址：