使用 curl 直接测试，排除插件配置问题

curl -s https://apihub.agnes-ai.cn/v1/models
-H "Authorization: Bearer YOUR_KEY_HERE" | head -c 500

如果返回模型数据，说明 Key 在该节点有效；如果返回 `{"error":{"message":"无效的令牌"...}}`，
**先换一个端点重试**（见下文实测表格——Key 与节点有代际绑定），换节点仍 401 再重新生成 Key。

---

## ⚠️ API Key 与端点选择

### 获取你的 API Key

1. 在 **[Agnes AI 平台](https://platform.agnes-ai.cn)**（国内节点）或 **[国际节点](https://platform.agnes-ai.com)** 注册
   - **中国大陆用户**：使用 `.cn` 平台 — 速度更快，无需代理
   - **海外用户**：使用 `.com` 平台
2. 在控制台设置 → API 密钥中创建 API Key
3. 创建 API Key（Key 与签发它的节点存在代际绑定，见下方实测表格）

### 选择合适的端点

**端点现状（2026-09-02 实测，中国大陆网络，`platform.agnes-ai.cn` 签发的 key）**：
节点与 key 存在代际绑定，同一把 key 并非在所有节点都有效：

| 端点 | 实测结果 |
|------|---------|
| `api.agnes-ai.cn` | ✅ 200（旧平台体系 key 的正确节点） |
| `apihub.agnes-ai.cn` — **本插件默认** | ❌ 401 无效的令牌（对上述 key） |
| `apihub.agnes-ai.com` | ✅ 200 |
| `api.agnes-ai.com` | ❌ 404 |

本插件默认指向 `apihub.agnes-ai.cn`（对 dsh 生态新签发的 key 有效）。
**遇到 `401 无效的令牌` 时先换端点、再换 key**：设置
`AGNES_MEDIA_BASE_URL=https://api.agnes-ai.cn` 通常即可恢复。
`AGNES_MEDIA_DOMAIN` 保留仅为向后兼容，不再影响端点选择。

| 如果你… | 这样做 |
|---------|--------|
| 在中国大陆 | 无需任何配置，默认即 `apihub.agnes-ai.cn` |
| 在海外 / 需要自定义端点 | 设置 `AGNES_MEDIA_BASE_URL=https://apihub.agnes-ai.com`（插件会自动追加 `/v1`） |
| 使用 DSH credentials | 在 DSH 凭证管理中添加 `AGNES_MEDIA_API_KEY` |

#### Windows PowerShell
```powershell
$env:AGNES_API_KEY = "sk-xxxxxxxx..."

# 国内无需额外配置；海外用户取消下一行注释

# 国内无需额外配置；海外用户取消下一行注释
agnes-media

安裝

說明文件

使用 curl 直接测试，排除插件配置问题
