跳到內容
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 “下一步”