Appearance
OpenAI 兼容工具
OpenAI 兼容工具不是一个需要下载的客户端，而是一套通用字段映射规则。凡是目标工具支持自定义 OpenAI Base URL、API Key 或 OpenAI Compatible Provider，通常都可以把它的字段映射到 AIDMX。
适用场景
- 文档中没有列出你正在使用的工具。
- 工具界面写着 OpenAI Compatible、Custom OpenAI、API Host 或 Base URL。
- 需要排查不同客户端之间的配置差异。
下载和官方入口
本页没有独立安装包，也没有所谓“OpenAI 兼容工具客户端下载”。
请先从目标工具自己的 HTTPS 官网、官方文档、官方应用商店或官方 GitHub 仓库安装，不要把非官方镜像当作主要下载来源。
如果目标工具已经在本栏目中有单独页面，优先阅读对应页面；如果没有，再按本页字段规则手动配置。
平台支持
平台支持取决于目标工具本身。只要它在 Windows、macOS、Linux、浏览器、IDE、服务器或移动端提供以下能力，就可以尝试接入 AIDMX：
- 支持自定义 OpenAI Base URL、API Host、Endpoint 或 NewAPI 接口。
- 支持填写 API Key、Token、Access Token 或 Bearer Token。
- 支持选择或手动输入模型名称。
- 支持 OpenAI Compatible、Custom OpenAI、NewAPI 或含义相同的 Provider 类型。
安装后检查
安装目标工具后，先不要急着填 Token，按下面顺序确认：
- 确认应用来自官方入口，且能正常打开设置页。
- 找到模型、Provider、API Key、Base URL 或 Endpoint 设置。
- 确认工具允许使用自定义服务地址，而不是只能使用官方 OpenAI。
- 如果工具能自动拉取模型列表，确认它也允许手动填写模型名称。
- 准备好 AIDMX API Token 和控制台可用模型名称。
配置 AIDMX
| 字段类型 | 常见名称 | AIDMX 填写值 |
|---|---|---|
| 服务类型 | Provider / API Type | OpenAI Compatible / Custom OpenAI / NewAPI |
| 接口地址 | Base URL / API Host / Endpoint | https://ai.aidmx.xyz/v1 |
| 密钥 | API Key / Token / Access Token | AIDMX API Token |
| 模型 | Model / Model Name / Deployment | AIDMX 控制台可用模型名称 |
配置顺序建议如下：
- 新增一个 Provider，名称填
AIDMX。 - Provider 类型选择 OpenAI Compatible、Custom OpenAI 或 NewAPI。
- Base URL 填写
https://ai.aidmx.xyz/v1。 - API Key 字段填写 AIDMX API Token。
- 模型名称填写控制台可用模型名称。
- 保存后先关闭复杂功能，只发送一条普通聊天请求。
- 基础请求成功后，再开启流式输出、工具调用、多模态或长上下文等能力。
大多数 OpenAI Compatible 工具都会出现类似的三个输入区：API Key、API 请求地址和模型名称。把 API 请求地址设置为 https://ai.aidmx.xyz/v1，再选择或手动填写 AIDMX 控制台可用模型名称。
如果目标工具会自动拼接 /v1，最终请求不应变成 /v1/v1/chat/completions。遇到重复路径时，再把工具里的地址改为 https://ai.aidmx.xyz 复测；公开推荐的 AIDMX Base URL 仍然是 https://ai.aidmx.xyz/v1。
成功验证
- 工具能返回模型回复。
- AIDMX 使用日志 中出现请求。
- 使用日志里的请求时间、模型名称、状态和消耗与工具中的操作一致。
- 更换或关闭 Token 后，工具认证状态能随之变化。
常见失败
- Base URL 重复：最终请求不应变成
/v1/v1/chat/completions。 - 工具只支持官方 OpenAI：无法接入自定义网关，需要更换工具或插件。
- 模型列表接口不兼容：手动填写 AIDMX 控制台可用模型名称，或在工具中关闭自动拉取。
- Token 填写方式错误：API Key 字段通常只填 AIDMX API Token 本身，不要额外加
Bearer，除非工具明确要求。 - 流式输出失败：关闭 stream 后先验证普通聊天请求。
- 工具调用失败：确认当前模型和网关是否支持 tool calling。
- 使用日志没有记录：请求没有到达 AIDMX，优先检查 Base URL、当前 Provider 和代理设置。
下一步
- 用 Postman 或 Apifox 验证同一请求。
- 回到 Playground 调整模型参数。
- 在 使用日志 中定位认证、模型和额度问题。