登录 注册

API 开发文档

HoyooAPI 完全兼容 OpenAI Chat Completions 协议,几乎无需改动现有代码即可接入。

1. 获取 API Key

登录后在 控制台 → API 密钥 创建密钥。调用时通过 HTTP 头鉴权:

Authorization: Bearer sk-hy-xxxxxxxxxxxx

2. cURL 调用示例

curl https://api.tzsinen.cn/api/v1/chat/completions \
  -H "Authorization: Bearer $HY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "你是一个乐于助人的助手。" },
      { "role": "user", "content": "用一句话介绍 HoyooAPI。" }
    ],
    "stream": false
  }'

3. JavaScript (fetch) 示例

const res = await fetch("https://api.tzsinen.cn/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + HY_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好" }],
    stream: false
  })
});
const data = await res.json();
console.log(data.choices[0].message.content);

4. Python 示例

import requests

r = requests.post(
    "https://api.tzsinen.cn/api/v1/chat/completions",
    headers={"Authorization": "Bearer " + HY_API_KEY},
    json={
        "model": "gpt-4o-mini",
        "messages": [{"role": "user", "content": "你好"}],
        "stream": False,
    },
)
print(r.json()["choices"][0]["message"]["content"])

接口说明

请求地址POST /api/v1/chat/completions
鉴权方式Bearer Token(API Key)
model模型标识,见 模型市场
messages对话消息数组(role/content)
stream是否流式返回(默认 false)
temperature采样温度 0–2

计费与配额

  • 按输入 / 输出 token 分别计费,单价因模型而异。
  • 订阅套餐可获额度赠送与更低单价(见 订阅套餐)。
  • 余额不足将返回 40201,请及时 充值

常见错误码

40101未登录 / 鉴权失效
40201余额不足
40901API Key 数量已达上限
40400接口或模型不存在
50201上游模型调用失败