API 參考
Chat Completions
這個端點可用的模型(5)
POST
/v1/chat/completions主力端點:目錄裡所有對話模型的多輪對話、串流、工具呼叫、視覺與 JSON 模式都走這裡。
#請求參數
modelstring必填來自 /v1/models 的模型 ID。閘道據此解析上游廠商。
messagesarray必填對話輪次:{role: system|user|assistant|tool, content}。content 可以是字串,也可以是多模態分段陣列。
streamboolean選填為 true 時以串流回傳 SSE 增量,以 data: [DONE] 結尾。
temperaturenumber選填範圍 0 到 2,留空使用模型預設值。
max_tokensinteger選填生成 token 上限;同時限定預留額度的估算。
toolsarray選填模型可呼叫的函式宣告——見工具呼叫指南。
tool_choicestring | object選填"auto"、"none",或指定某個函式。
response_formatobject選填{"type":"json_object"} 或 json_schema 包裝,在支援的模型上啟用結構化輸出。
top_pnumber選填核取樣;temperature 和 top_p 二選一。
stopstring | array選填最多 4 個停止序列,命中即截斷生成。
#相關錯誤碼
- 400 invalid_request_error請求主體格式錯誤,或該模型不支援某個參數。
- 401Bearer 權杖無效或缺失。這條路徑不帶 error.code,請依狀態碼判斷。
- 402 insufficient_user_quota錢包餘額不足以覆蓋預扣估算。
- 429金鑰級限流。回應主體為空,按 Retry-After 等待。若 429 帶有 insufficient_user_quota,那是每日消費上限,不是限流。
- 503 model_not_found模型名稱不存在,或目前沒有健康的通道可以提供服務。
#請求範例
curl https://www.aisplice.store/v1/chat/completions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-luna",
"messages": [{"role": "user", "content": "Say hello."}]
}'#回應
response.json
{
"id": "chatcmpl-…",
"object": "chat.completion",
"model": "gpt-5.6-luna",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "Hello!"},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}還是沒解決?
把請求 ID 或錯誤訊息傳給我們,我們來查。