快速开始

本指南带你完成一次对话请求。你需要一个 Hyper API 账号、可用的 API 令牌，以及该令牌有权限访问的对话模型。

1. 登录并创建令牌

1. 打开 Hyper API，注册或登录账号。
2. 在控制台的 令牌管理 中创建令牌。
3. 根据用途设置令牌分组、额度、有效期和模型限制（以控制台实际提供的选项为准）。
4. 复制生成的完整令牌，并妥善保存。

保管好令牌

令牌相当于 API 的访问凭证。不要放进网页前端、公开仓库、截图或分享链接。若泄露，请立即在控制台删除或禁用并重新创建。

2. 设置环境变量

以下命令适用于 Bash。交互式输入可以避免令牌被直接记录在命令历史中。

read -r -s -p '请输入 Hyper API 令牌：' HYPERAPI_API_KEY
printf '\n'
export HYPERAPI_API_KEY
export HYPERAPI_BASE_URL='https://hyperapi.cc/v1'

3. 确认可用模型

curl --fail-with-body "$HYPERAPI_BASE_URL/models" \
  -H "Authorization: Bearer $HYPERAPI_API_KEY"

返回结果中的 data[].id 是模型标识。结合 模型与价格 页面，选择支持对话接口的模型，将完整名称填入变量：

export HYPERAPI_MODEL='替换为你有权限使用的对话模型 ID'

模型列表不保证所有模型都支持对话接口；实际可用性还取决于令牌分组、余额、模型权限和渠道状态。

4. 发送对话请求

以下示例需要本机有 python3，用来安全生成 JSON 请求体。

python3 -c 'import json, os; print(json.dumps({
    "model": os.environ["HYPERAPI_MODEL"],
    "messages": [{"role": "user", "content": "你好，请简单介绍一下你自己。"}]
}))' | curl --fail-with-body "$HYPERAPI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $HYPERAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @-

成功时，可以在 JSON 响应的 choices[0].message.content 中找到常见文本回复；不同模型可能附带额外字段。你也可以到 使用日志 查看请求记录与费用。

地址怎么填

客户端要求 Base URL 时通常填写 https://hyperapi.cc/v1；如果它会自动添加 /v1，请填写 https://hyperapi.cc。完整对话请求地址为 https://hyperapi.cc/v1/chat/completions。

接下来

• 令牌与鉴权：了解令牌权限和安全使用方式。
• 对话接口：查看请求参数、响应与流式输出。
• 客户端配置：把令牌接入你常用的应用。
• 常见问题：请求失败时逐项排查。