基础 API

SDK 接入

通过现有 SDK 设置实际服务地址，并保留异常处理。

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

安装与客户端选择

原站以 Python 和 Node.js 的 openai 包演示兼容接入。可分别使用 pip install openai 或 npm install openai。其他语言库的维护者、版本和第三方属性需单独确认，不把所有同名 SDK 都视为官方库。

Python 基础示例

先在服务端设置 QH_API_KEY、QH_API_BASE_URL、QH_MODEL。下面为独立编写的兼容调用示例，未连接实际服务测试。

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["QH_API_KEY"],
    base_url=os.environ["QH_API_BASE_URL"],
    timeout=60.0,
    max_retries=2,
)
result = client.chat.completions.create(
    model=os.environ["QH_MODEL"],
    messages=[{"role": "user", "content": "列出本次任务的验收步骤。"}],
)
print(result.choices[0].message.content)

Node.js 基础示例

在 Node.js 服务端使用，不将密钥暴露到网页脚本。

javascript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.QH_API_KEY,
  baseURL: process.env.QH_API_BASE_URL,
  timeout: 60_000,
  maxRetries: 2,
});
const result = await client.chat.completions.create({
  model: process.env.QH_MODEL,
  messages: [{ role: "user", content: "列出本次任务的验收步骤。" }],
});
console.log(result.choices[0]?.message?.content);

异步、流式与异常

并发请求应限制数量。处理 stream 时检查空 choices 和空 delta。区分认证错误、参数错误、限流和服务端故障；不要对所有错误无限重试，尤其是可能产生费用的媒体任务。

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