API 參考

Chat Completions

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 或錯誤訊息傳給我們,我們來查。