快速开始

本指南帮助你在几分钟内完成：注册 → 创建 Key → 充值 → 首次调用。

1. 注册与登录

1. 打开控制台：https://api.hoyoai.cn
2. 右上角注册 / 登录
3. 按提示完成账号激活（若启用邮箱验证）

2. 创建 API Key

1. 登录后进入 令牌 / API Keys
2. 创建令牌，填写名称与过期策略
3. 立即复制并妥善保存（部分环境下密钥只展示一次）

安全建议

• 不要把 Key 写进公开仓库或前端明文
• 按环境 / 应用拆分 Key；泄露后立即禁用并轮换
• 优先在服务端调用

3. 充值

1. 打开控制台 钱包 / 充值
2. 选择金额与支付方式（如支付宝）完成付款
3. 余额到账后即可调用（也可使用兑换码，若账号开通了兑换入口）

额度与账单以控制台展示为准。

4. Base URL

所有 OpenAI 兼容请求使用：

https://api.hoyoai.cn/v1

把官方 SDK / 客户端里的 https://api.openai.com/v1 换成上述地址，并填入你的 Key 即可。

5. 首次调用

模型名请到 模型广场 复制实际可用名称（下方示例用 claude-sonnet-4-6，若不可用请替换）。

curl

curl https://api.hoyoai.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "user", "content": "Hello, HOYOAI!"}
    ]
  }'

Python

import requests

url = "https://api.hoyoai.cn/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
}
data = {
    "model": "claude-sonnet-4-6",
    "messages": [
        {"role": "user", "content": "Hello, HOYOAI!"}
    ],
}
print(requests.post(url, headers=headers, json=data).json())

OpenAI 官方 Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.hoyoai.cn/v1",
)
resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello, HOYOAI!"}],
)
print(resp.choices[0].message.content)

6. 查看结果与用量

• 接口成功时返回 JSON（含 choices / usage 等）
• 控制台 用量 / 日志 可查看调用记录与扣费

名词速览

名词	含义
Tokens	模型计量文本的基本单位
输入 / 输出 Tokens	请求文本与模型回复分别计费
API Key	调用凭证，等同于 Bearer Token
模型	如 GPT、Claude、Gemini、图像模型等，以模型广场为准

下一步

• 鉴权 · 模型与定价 · API 概览 · 客户端集成