anasfik/openai

解決的問題

為 Dart 與 Flutter 開發者提供一個全面且具類型安全的 SDK，無需撰寫原始 HTTP 請求，即可將 OpenAI API 及其他 OpenAI 相容服務（如 DeepSeek、Ollama 和 Groq）整合至應用程式中。

工作原理

此套件作為 OpenAI 網路格式的封裝，提供針對各種 API 表面（包括聊天補全、音訊、影像與微調）的類型安全客戶端。支援全域外觀（facade）以簡化設定，也支援獨立的 OpenAIClient 實例，以管理多個帳戶或服務提供者。內建 SSE 引擎以處理串流回應，並具備指數退避的自動重試機制，以應對暫時性失敗。

適用對象

在 Android、iOS、macOS、Linux、Windows、Web 及伺服器端 Dart 上開發 AI 驅動應用的 Dart 與 Flutter 開發者。

主要特色

• 廣泛的 API 覆蓋：支援幾乎所有主要的 OpenAI 功能，包括 Realtime、Vector Stores、Evals 與 Administration。
• 跨平台檔案處理：使用平台中立的檔案類型，確保在原生與 Web 平台上檔案上傳都能順暢運作。
• 服務提供者無關：相容任何實作 OpenAI API 格式的服務，包括 Azure OpenAI 與透過 LM Studio 或 Ollama 執行的本地 LLM。
• 穩健的網路連線：具備對暫時性錯誤的自動重試功能，以及用於防止串流連線掛起的閒置監控機制。
• 強型別支援：為所有請求與回應負載提供強型別的例外與模型。