模型與參數
列出模型並瞭解常用的 Chat Completions 欄位
GET /v1/models 列出目前金鑰可呼叫的所有模型。
請求中的 model 必須使用回傳的 id 欄位，這是 API 唯一接受的模型識別碼。
curl https://api.orientx.ai/v1/models \
-H "Authorization: Bearer $ORIENTX_API_KEY"{
"object": "list",
"data": [
{ "id": "<MODEL_ID>", "object": "model", "owned_by": "orientx" }
]
}可用模型取決於你的帳戶，因此應查詢此端點，而不是寫死清單。
模型下線後，請求會回傳 404，錯誤碼為 model_not_found。
快速入門提供了同一請求的 Python 和 TypeScript 範例。
如需查看各模型的 ID 和可直接複製的 API 範例，請開啟模型價格頁面。
請求參數
Chat Completions 端點接受標準 OpenAI 欄位。以下是最常用的參數：
| 參數 | 型別 | 說明 |
|---|---|---|
model | string | 必填。使用 GET /v1/models 回傳的 id。 |
messages | array | 必填。按順序排列的對話輪次，包含 role 和 content。 |
stream | boolean | 回傳伺服器傳送事件，而不是一次性回傳完整回應。 |
temperature | number | 值越高，輸出越多樣。預設值為 1。 |
top_p | number | 核心取樣。調整此參數或 temperature，不要同時調整兩者。 |
max_tokens | integer | 限制生成內容的長度，不包含提示詞。 |
stop | string 或 array | 最多 4 個用於結束生成的序列。 |
tools、response_format 和視覺輸入等可選欄位的支援情況因模型而異。
模型不支援某個參數時，API 會回傳 400 並指出對應欄位，而不會靜默忽略。