你將建置的內容
你將向 CometAPI 與 OpenAI 相容的POST /v1/chat/completions 路由傳送一個文字請求、輸出 assistant 訊息,並讓請求格式可直接用於已經使用 OpenAI SDK 的應用程式。
何時使用本頁
當你的專案符合以下任一情況時,請使用此快速入門:- 你已經在使用 OpenAI SDK 或聊天補全請求格式。
- 你想將 base URL 切換為 CometAPI。
- 你想透過與 OpenAI API 相容的路由呼叫 CometAPI model ID。
先決條件
- 儲存在
COMETAPI_KEY中的 CometAPI API 金鑰 - 來自模型頁面的文字 model ID
curl、Python 3.10+,或 Node.js 18+
API 金鑰、base URL、驗證
搭配與 OpenAI 相容的用戶端時,請使用 CometAPI 的 base URL:程式碼範例
使用下方的分頁,以 cURL、Python 和 Node.js 傳送相同的聊天補全請求。流程說明
與 OpenAI 相容代表你的應用程式保留聊天補全 endpoint、請求主體和 SDK 方法名稱,同時將 base URL 和 model ID 改為 CometAPI 的值。 此路由預設為同步。API 會在單一 HTTP 回應中傳回完成的回應物件,而你的應用程式會讀取choices[0].message.content。
若要取得增量輸出,請將 stream 設為 true。回應會變成 Server-Sent Events,並以 data: [DONE] 結束。聊天介面和長回應請使用串流(Streaming)。背景工作和簡單測試則保留同步形式。
常見參數
疑難排解與常見問題
這是 OpenAI API 嗎?
這是 OpenAI API 嗎?
不是。這是 CometAPI 相容於 OpenAI 的 API 路由。你會使用 CometAPI API key、CometAPI base URL,以及 CometAPI model ID。
請求回傳 401
請求回傳 401
請確認
COMETAPI_KEY 已設定在發送請求的同一個 shell 或執行環境中。不要將真實的 key 貼到原始碼檔案裡。找不到 model
找不到 model
請使用支援文字或聊天請求的 CometAPI model ID。重試前請先查看 Models 頁面。
SDK 仍然呼叫 OpenAI
SDK 仍然呼叫 OpenAI
請確認 client 在 Python 中將
base_url 設為 https://api.cometapi.com/v1,或在 Node.js 中將 baseURL 設為 https://api.cometapi.com/v1。後續步驟
- 閱讀聊天補全 API 參考文件。
- 在將 CometAPI 與 OpenAI SDK 搭配使用中設定 SDK client。
- 使用列出可用的 CometAPI 模型列出可用模型。
- 透過錯誤代碼與重試策略加入重試與速率限制處理。