用 Python 标准库完成第一次 HiKaRi API 调用

归档13

接入教程4 模型与成本3 团队与研究2 工程实践2 问题排查2

582 字

3 分钟

用 Python 标准库完成第一次 HiKaRi API 调用

2026-10-25

下面用 Python 3 标准库验证 OpenAI 兼容的 Chat Completions 接口。你需要一个有可用资金、绑定了相应分组的 HiKaRi Key，以及该分组支持的精确模型 ID。仅支持其他协议的模型不能直接套用这段请求体。

先在本机设置环境变量#

Windows PowerShell：

1
$env:API_KEY = Read-Host '输入本站 API Key'
2
$env:MODEL_ID = Read-Host '输入模型广场中的精确模型 ID'
3
python first_call.py

macOS、Linux 或 Git Bash：

1
read -s -p 'API Key: ' API_KEY; echo
2
export API_KEY
3
read -p '精确模型 ID: ' MODEL_ID
4
export MODEL_ID
5
python3 first_call.py

示例中的交互输入用于本机验证。共享电脑或生产环境应使用自己的密钥管理方式；不要将 Key 写入 Git 仓库、前端代码或公开笔记。

保存为 first_call.py#

1
import json
2
import os
3
import urllib.error
4
import urllib.request
5

6
base = "https://hikariapi.xyz"
7
key = os.environ["API_KEY"].strip()
8
model = os.environ["MODEL_ID"].strip()
9

10
def request(path, payload=None):
11
    headers = {"Authorization": "Bearer " + key}
12
    data = None
13
    if payload is not None:
14
        headers["Content-Type"] = "application/json"
15
        data = json.dumps(payload).encode("utf-8")
16
    req = urllib.request.Request(base + path, data=data, headers=headers)
17
    with urllib.request.urlopen(req, timeout=120) as response:
18
        return json.load(response)
19

20
try:
21
    catalog = request("/v1/models")
22
    ids = [item["id"] for item in catalog["data"]]
23
    if model not in ids:
24
        raise SystemExit("模型不在此 Key 的目录中，请先核对分组与精确名称。")
25
    result = request("/v1/chat/completions", {
26
        "model": model,
27
        "messages": [{"role": "user", "content": "只回复 OK"}],
28
        "stream": False,
29
    })
30
    print(result["choices"][0]["message"]["content"])
31
    print("usage:", json.dumps(result.get("usage"), ensure_ascii=False))
32
except urllib.error.HTTPError as error:
33
    print("HTTP 状态：", error.code)
34
    print("响应内容请在本机查看，分享前移除凭据和私人数据：")
35
    print(error.read().decode("utf-8", errors="replace"))
36
    raise SystemExit(1)
37
except urllib.error.URLError as error:
38
    raise SystemExit("网络请求失败；检查本机 DNS、代理、网络，并核对用量后决定是否重发。") from error