快速開始
用幾分鐘建立 Key,並傳送第一次聊天請求。
依照本頁步驟建立 API Key,並使用
gpt-5.6-sol傳送第一次聊天請求。開始前,請確認你的帳號可以進入 Vergora 主控台,且目前餘額足以完成測試請求。
開始前準備
| 項目 | 本次使用的設定 | 注意事項 |
|---|---|---|
| API Origin | https://api.vergora.ai | Vergora API 的正式存取網域 |
| 請求端點 | POST /v1/chat/completions | 完整請求位址由 API Origin 和端點組成 |
| Model ID | gpt-5.6-sol | 請準確複製,不要使用顯示名稱代替 |
| API Key | 在主控台的 API Keys 頁面建立 | 不要使用模型廠商的 Key 代替 Vergora API Key |
你還需要一個可以執行 cURL 的終端機。以下指令適用於 macOS、Linux,以及支援 Bash 或 Zsh 的環境。
1. 登入並進入主控台
- 點選網站頂端的「登入」。
- 依頁面提示完成帳號驗證。
- 登入後進入主控台,確認目前帳號和工作區正確。
- 檢查可用餘額以及現有 API Key 的狀態。
如果驗證碼錯誤或長時間未收到,請先檢查電子郵件地址、垃圾郵件和頁面提示,不要連續反覆請求驗證碼。
2. 建立 API Key
- 在主控台中開啟 API Keys。
- 建立一個新的 API Key。
- 使用能夠區分應用程式和環境的名稱,例如
demo-development。 - 依頁面提示複製並妥善保存完整 API Key。
API Key 是私密憑證。不要把它寫入瀏覽器程式碼、公開儲存庫、聊天訊息、日誌或截圖。
3. 在終端機中儲存 API Key
使用下面的指令輸入 API Key。輸入過程中,終端機不會顯示 Key 內容。
printf "Vergora API Key: "
read -r -s VERGORA_API_KEY
printf "\n"
export VERGORA_API_KEY該環境變數只在目前的終端機工作階段中有效。關閉終端機後,需要重新設定。正式應用程式應透過伺服器端環境變數或金鑰管理工具保存憑證。
4. 傳送第一次請求
在同一個終端機中執行:
curl --silent --show-error --include \
"https://api.vergora.ai/v1/chat/completions" \
-H "Authorization: Bearer ${VERGORA_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [
{
"role": "user",
"content": "你好,請用一句話介紹你自己。"
}
],
"stream": false
}'本範例使用聊天補全介面。切換模型前,請確認目標模型支援相同的端點、訊息結構和參數。
5. 讀取回應
相容 Chat Completions 的非串流回應通常包含訊息內容和用量資訊。下面的欄位和值僅用於說明讀取位置:
{
"id": "example-response-id",
"choices": [
{
"message": {
"role": "assistant",
"content": "你好!我是一個 AI 助理。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 8,
"total_tokens": 20
}
}檢查以下內容:
- HTTP 請求是否成功完成。
- 回應本文中是否包含模型回傳的內容。
choices[0].message.content是否能夠正常讀取。- 是否回傳用量資訊或可用於定位請求的識別碼。
不要只根據終端機沒有出現錯誤就判斷呼叫成功。
6. 核對請求紀錄
開啟主控台中的 Requests,根據呼叫時間和模型尋找剛才的請求,然後核對:
| 核對項目 | 需要確認的內容 |
|---|---|
| Model ID | 是否為 gpt-5.6-sol |
| 狀態 | 請求是否已經完成或失敗 |
| 用量 | 是否記錄輸入和輸出 Token |
| 延遲 | 是否顯示本次請求的處理時間 |
| 費用 | 是否顯示本次請求對應的費用 |
如果紀錄尚未出現,請先重新整理頁面並檢查篩選條件,不要為了產生紀錄而立即重複傳送相同請求。
常見問題
| 問題 | 建議處理方式 |
|---|---|
| 驗證失敗 | 確認環境變數不為空、API Key 完整,並檢查 Bearer 與 Key 之間是否有一個空格 |
| 模型無法使用 | 確認 Model ID 為 gpt-5.6-sol,並檢查目前帳號和 API Key 是否可以存取該模型 |
| 請求格式錯誤 | 檢查 JSON、請求端點和 Content-Type 請求標頭 |
| 餘額或預算不足 | 檢查可用餘額以及 API Key 的預算限制 |
| 請求長時間沒有結果 | 保存呼叫時間和可用的請求識別碼,再到 Requests 中檢查狀態 |
完成第一次請求後,可以繼續閱讀「身分驗證」,了解 API Key 的使用和保護方式。