客户端配置

支持自定义兼容接口地址的客户端，通常需要填写服务地址、API Key 和模型名称。具体菜单和字段名称可能随客户端版本变化。

通用配置

字段	填写内容
服务商类型	选择支持自定义 Base URL 的兼容服务商
显示名称	Hyper API，也可以自定义
Base URL / API 地址	通常为 https://hyperapi.cc/v1
API Key	在 Hyper API 控制台创建的完整令牌
模型	当前令牌有权限使用的完整模型 ID

避免重复路径

有的客户端会自动补 /v1，此时只填 https://hyperapi.cc。配置后检查最终请求路径是否为 /v1/chat/completions，避免出现 /v1/v1/chat/completions。

配置步骤

1. 在客户端设置中新增服务商，选择兼容接口并允许自定义地址的类型。
2. 填写上表中的地址和令牌。
3. 如果客户端支持获取模型列表，尝试拉取；否则手动填写模型 ID。
4. 选择支持对话接口的模型，发送一条简短消息进行测试。
5. 在 使用日志 检查请求是否到达主站。

如果客户端使用其他接口（例如单独的消息接口或响应接口），需要同时确认模型和渠道支持对应协议，不能只修改 URL 路径。

配置失败时

• 找不到模型：确认使用的是模型 ID，令牌的分组和模型权限匹配。
• 验证令牌失败：先用 快速开始 中的 cURL 验证；客户端自带测试可能使用你无权限访问的默认模型。
• 返回 HTML 或 404：检查是否误填文档域名、遗漏 /v1，或重复拼接路径。
• 有回复但无法流式显示：检查客户端是否启用流式模式，以及本地代理是否缓冲响应。
• 网页端配置无法连接：打开开发者工具检查请求错误；自建网页应用建议由后端管理令牌并调用 API。

更多状态码排查见 常见问题。