客户端
入门 · 约 6 分钟
配置通用 OpenAI 兼容客户端
很多桌面客户端和开发工具允许填写自定义 OpenAI 兼容接口。不同软件的字段名称略有差异，但核心配置相同。
开始前准备
- 客户端明确支持自定义 OpenAI 兼容地址
- 已创建 AINN API Key
- 已确认需要使用的模型名称
1
步骤 1
找到自定义服务配置
在客户端的模型服务、提供商或 API 设置中，选择 OpenAI Compatible、自定义 OpenAI 或类似选项。
- API Key：填写控制台创建的密钥
- Base URL：通常填写 https://api.ainn.cc/v1
- Model：填写模型广场显示的模型标识
部分客户端会自动在地址后追加 /v1。如果软件明确要求填写 Host 而不是 Base URL，可尝试填写 https://api.ainn.cc，并以该客户端的说明为准。
2
步骤 2
保存并发送最小测试消息
先发送一句简短消息，避免在配置错误时产生不必要的 Token 消耗。
- 确认选择的是刚刚配置的模型
- 测试消息尽量简短，例如“回复 OK”
- 收到回复后到控制台核对调用记录和消耗
3
步骤 3
处理地址与模型错误
客户端报错时，优先检查字段是否被自动拼接，以及模型名称是否来自当前模型广场。
- 地址出现 /v1/v1：删除手动填写地址末尾的 /v1
- 404 或接口不存在：确认软件使用的是 OpenAI Chat Completions 兼容接口
- 模型不可用：重新复制模型标识并确认当前供应状态
- 401：重新创建或完整复制 API Key
4
步骤 4
保护密钥与控制成本
只在可信客户端中保存 API Key。共享电脑、公共设备或来源不明的软件不适合配置真实密钥。
- 为不同设备或用途创建不同密钥，便于停用和排查
- 定期检查调用日志和余额变化
- 先申请体验额度或使用低成本模型完成连接测试
- 不再使用某个客户端时及时删除对应密钥
完成检查
- 客户端测试消息能够正常返回
- 控制台中能识别对应调用
- 已了解该客户端是否自动追加 /v1
继续完成项目接入
选择合适模型并估算实际成本
教程中的模型名只是占位符。请根据业务场景选择当前可用模型，再用真实 Token 用量估算预算。