跳转到内容
Glacier AI Logo Glacier AI Logo Glacier AI 文档

快速开始

本页用最短路径跑通一次模型调用。完成后再按需阅读用户指南中的各个功能页面。

前置条件

Section titled “前置条件”
  • 一个 Glacier AI 账号，注册时可能需要验证邮箱。
  • 账户中有可用额度。新账号如果余额为 0，可以先在钱包充值或使用兑换码。

本页示例中的站点地址统一写作 https://api.example.com，请替换成你实际访问的地址。

第一步：注册并登录

Section titled “第一步：注册并登录”
  1. 打开站点首页，点击右上角「登录」，或直接访问 /sign-in。
  2. 没有账号时点击「注册」，或直接访问 /sign-up，按提示填写用户名、密码，必要时完成邮箱验证和人机验证。
  3. 登录成功后进入控制台，左侧导航栏显示当前账号可用的功能模块。

详细说明见注册与登录。

第二步：创建 API 密钥

Section titled “第二步：创建 API 密钥”
  1. 点击左侧导航「API 密钥」，或直接访问 /keys。
  2. 点击「创建 API 密钥」，填写名称（建议按用途命名，如「生产环境」「测试用」）。
  3. 按需设置额度、过期时间、模型限制、分组和 IP 白名单；不确定时全部留空表示不限制。
  4. 保存后在列表中查看并复制完整密钥，形如 sk-xxxxxxxx。

详细说明见 API 密钥。

第三步：发送第一个请求

Section titled “第三步：发送第一个请求”

平台提供 OpenAI 兼容接口，把官方 SDK 的 Base URL 换成你的站点地址加 /v1 即可。

curl
curl https://api.example.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好"}]
  }'
Python（OpenAI SDK）
from openai import OpenAI


client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://api.example.com/v1",
)


response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

不想写代码时，也可以点击左侧导航「游乐场」（/playground），在网页上直接选择模型并发送对话。

第四步：确认用量与计费

Section titled “第四步：确认用量与计费”
  1. 点击左侧导航「使用日志」，或访问 /usage-logs/common。
  2. 找到刚才的请求记录，确认模型、Token 数、耗时和扣费额度。
  3. 点击记录可展开详情，查看请求 ID、模型映射、计费明细等信息。

详细说明见日志与异步任务。

常见问题

Section titled “常见问题”
现象 排查方向
返回 401 未授权 检查 Authorization: Bearer <密钥> 格式、密钥是否已启用、是否过期。
返回 403 禁止访问 检查密钥的模型限制、分组权限和 IP 白名单。
提示额度不足 在钱包中确认余额或订阅额度，以及密钥本身设置的额度上限。
提示模型不存在 在模型广场中确认该模型已启用，且当前分组可用。
日志里看不到记录 日志写入有短暂延迟，稍等片刻刷新；并非每个失败响应都会生成错误记录。

下一步

Section titled “下一步”