聊天補全
根據一組訊息產生模型回應。
聊天補全介面根據一組有順序的訊息生成模型回應。本頁以非串流文字請求為例。
請求端點
POST https://api.vergora.ai/v1/chat/completions請求需要以下標頭:
Authorization: Bearer YOUR_VERGORA_API_KEY
Content-Type: application/json請求本文
{
"model": "gpt-5.6-sol",
"messages": [
{
"role": "user",
"content": "請簡潔解釋統一模型 API。"
}
],
"stream": false
}常用欄位
| 欄位 | 是否必填 | 說明 |
|---|---|---|
model | 是 | 從模型目錄複製的 Model ID |
messages | 是 | 依對話順序排列的訊息陣列 |
messages[].role | 是 | 訊息角色;可用角色以模型說明為準 |
messages[].content | 是 | 文字或模型支援的內容結構 |
temperature | 否 | 控制取樣;範圍和預設值以模型說明為準 |
max_tokens | 否 | 輸出上限;欄位支援情況以模型說明為準 |
stream | 否 | 是否使用串流輸出 |
不要向模型傳遞不受支援的選用參數。第一次驗證時,建議只使用必填欄位和 stream: false。
讀取回應
{
"id": "example-response-id",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "這是一個範例回覆。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 20,
"total_tokens": 50
}
}通常從 choices[0].message.content 讀取文字。檢查 finish_reason,並使用 usage 核對輸入和輸出用量。範例欄位用於說明相容結構,實際回應以介面回傳為準。
多輪對話
應用程式需要在後續請求中依序攜帶必要的歷史訊息。控制歷史長度,避免重複內容或超出模型的上下文限制。包含敏感資訊時,只傳送任務所需的最少內容。
需要持續接收內容時,請閱讀「串流輸出」。