黔惠科技文档中心
文档导航
产品基础

快速开始

用一次最小请求确认认证、路径和模型是否匹配。

初始内容依据参考站公开技术信息整理,非黔惠科技接口上线承诺。实际 API 地址、模型、费用与权限请在接入前确认。

1. 准备接入信息

向实际服务提供方获取 API Key、带版本的 Base URL 和可用模型名称。参考站文档使用 api.yisu-api.com,SDK 示例的 Base URL 带 /v1;该域名是第三方服务,不是黔惠科技接口。本站示例从环境变量读取实际地址。

2. 保护密钥

在服务端进程中配置 QH_API_KEY、QH_API_BASE_URL(实际供应商给出的 HTTPS 地址加 /v1)与 QH_MODEL。不要将真实密钥提交到代码仓库或写入网页。只向已确认的服务地址发送密钥。

3. 验证对话请求

以下为 Bash / cURL 请求结构。替换模型并确认环境变量后再执行;本网站不会执行这些示例。

bash
curl "$QH_API_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $QH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"请给出三个验收步骤。"}]}'

4. 检查响应

成功后检查 HTTP 状态和 choices 中的文本。401 先核对密钥,404 核对模型与路径,限流或暂时性故障再采用有限重试。保存请求 ID 和时间,不记录认证头。

内容整理:2026-10-20参考来源 ↗