HiAPI API key 无效排查

TL;DR

看到 “api keys data are invalid” 时，先确认这句话来自客户端还是 API 响应。HiAPI 的 401 表示密钥无效或缺失；核对实际进程读取的变量和 Authorization: Bearer 请求头。

运行 Python 示例前，在同一个 Python 环境执行 python -m pip install requests。

先看原始响应

HiAPI 的鉴权错误可以包含以下结构；message 还可能附带请求 ID。

{"error":{"code":"permission_denied","type":"hiapi_error","message":"This API key is invalid. Check that it is correct or use another API key and try again."}}

401 不等于余额不足，也不能只凭客户端弹窗判断 API 实际返回了什么。

按顺序检查这五项

运行进程拿到的值。 检查服务、容器或部署平台的 HIAPI_API_KEY；编辑本地 .env 不会自动更新已经运行的进程。
复制内容。 使用完整密钥，排除占位符、名称、截断值、首尾空白或多余引号。
请求头。 按 Authorization: Bearer YOUR_API_KEY 传递；不要把密钥放进网页地址或日志。
密钥状态。 在账号中核对密钥是否有效；如已轮换，同步更新真正运行的环境。
目的域名。 HiAPI 密钥用于 api.hiapi.ai；其他平台的密钥不能交叉使用。

检查环境变量，不打印密钥

在出现错误的同一个运行环境执行下面的检查。结果只显示是否存在、长度和空白等状态。

import os

name = "HIAPI_API_KEY"
key = os.environ.get(name, "")
print({
    "variable": name,
    "present": bool(key),
    "length": len(key),
    "has_whitespace": any(c.isspace() for c in key),
    "wrapped_in_quotes": len(key) >= 2 and key[0] == key[-1] and key[0] in (chr(34), chr(39)),
})

通过只读请求验证

以下请求只读取模型列表，不创建生成任务。成功读取后，仍需核对目标模型的访问权限和请求参数。

import os
import re
import requests

key = os.environ.get("HIAPI_API_KEY", "")
if not key or any(ord(c) < 33 or ord(c) > 126 for c in key) or any(c in key for c in (chr(34), chr(39))):
    raise SystemExit("Check the key environment variable: empty, whitespace, control characters, or quotes")
try:
    response = requests.get(
        "https://api.hiapi.ai/v1/models",
        headers={"Authorization": f"Bearer {key}"},
        timeout=30,
    )
except requests.RequestException as exc:
    raise SystemExit("Request failed: " + type(exc).__name__) from None
print("HTTP", response.status_code)
if response.ok:
    print("Model list received")
else:
    try:
        body = response.json()
        error = body.get("error", {})
        message = str(error.get("message") or body.get("message") or "")
        message = message.replace(key, "[REDACTED]")
        message = re.sub(r"sk-[A-Za-z0-9_*.-]+", "[REDACTED]", message)
        print("code:", error.get("code") or body.get("error_code"))
        print("type:", error.get("type"))
        print("message:", message)
        print("request_id:", error.get("request_id") or response.headers.get("x-request-id"))
    except ValueError:
        print("Non-JSON response; check the base URL and network path")

如果返回 401，继续检查凭证；403 检查访问限制；429 检查限流。出现非 JSON 响应时，检查域名、代理和网络返回内容。