jamesrochabrun/SwiftOpenAI

解決的問題

SwiftOpenAI 為開發者提供一個簡潔、開源的 Swift 套件，可將 OpenAI 的公開 API 整合至應用程式中。它消除了為廣泛的 OpenAI 服務手動撰寫網路請求與資料解析的需要，支援 Apple 平台（iOS、macOS、watchOS）與 Linux。

工作原理

此套件作為 OpenAI API 端點的封裝。使用 OpenAIServiceFactory 透過 API 金鑰初始化服務，並為各種模態提供結構化參數與回應物件。它透過 URLSession（Linux 上使用 AsyncHTTPClient）支援標準 HTTP 請求，並透過 WebSocket 支援實時 API 的低延遲、雙向語音對話。

適用對象

希望使用類型安全、易於安裝的函式庫來存取 LLM、影像產生與音訊處理的 Swift 開發者，用於開發 Apple 裝置或 Linux 伺服器上的 AI 應用程式。

主要特色

• 全面的端點支援：涵蓋聊天（含視覺與結構化輸出）、音訊（轉錄、翻譯、語音）、嵌入、微調、批次、檔案、影像與審核。
• 廣泛的相容性：支援 OpenAI 及其他 OpenAI 相容提供者，如 Azure、Anthropic、Gemini、Ollama、Groq、xAI、OpenRouter 與 DeepSeek。
• 實時 API 整合：支援低延遲、雙向語音對話，具備音訊到音訊互動與語音活動偵測功能。
• 助理 Beta 支援：包含對助理、對話、訊息、執行與向量儲存的整合。
• 跨平台支援：相容 iOS 15+、macOS 13+、watchOS 9+ 與 Linux（支援 Vapor）。