
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-26 · 当前星标 ★ 2953
技术标签
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- macOS 上安装 Xcode,或具备可编译 Swift 的工具链
- 工程使用 Swift Package Manager 管理依赖
- 一个 OpenAI API Key(形如 sk-xxxxxxxx)
- 按需准备组织标识 organization 或自定义 baseURL
安装与启动步骤
-
1准备开发环境
安装 Xcode 并确认工程能正常编译,后续通过 Swift Package Manager 引入本包。
-
2添加包依赖
在 Xcode 的 Package Dependencies 中添加本仓库地址;README 安装章节未列出具体写法,以仓库实际发布信息为准。
-
3初始化客户端
参考 README 的 Initialization 章节创建客户端实例,填入 API Key;如需切换兼容端点,同时配置 baseURL。
-
4调用接口
按 README 的 Chat Completions、Responses、Images、Audio 等章节选择接口,代码中的响应结果需要处理。
-
5运行验证
在工程中编译并运行示例,能拿到接口返回数据说明集成成功。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
apiKey | 是 | 调用 OpenAI 接口所需的密钥 | sk-xxxxxxxx |
organization | 否 | 组织标识,属于组织的账号需要填写 | org-xxxxxxxx |
baseURL | 否 | 自定义接口地址,用于切换兼容端点 | https://api.openai.com/v1 |
如何确认成功
工程编译通过,且示例调用能返回正常的接口响应数据。
常见问题
Q:README 的 Installation 章节是空的怎么办?
A:安装方式以仓库实际发布内容为准;本包通过 Swift Package Manager 分发,可在 Xcode 里用 Package Dependencies 添加仓库地址。
Q:API Key 从哪里获取?
A:在 OpenAI 平台的 API Keys 页面创建,然后填入客户端初始化参数,不要硬编码进公开仓库。
Q:能用非 OpenAI 的兼容服务吗?
A:可以。README 有 Using the SDK for other providers 章节,通过自定义 baseURL 指向兼容端点即可。
Q:请求如何取消?
A:README 提供 Cancelling requests 章节,按其中说明对进行中的请求执行取消操作。
注意事项
- README 节选未给出具体安装命令与版本号,请以仓库当前文档为准。
- API Key 建议通过环境变量或本地配置文件注入,避免提交到代码仓库。
- README 中的示例代码为片段示意,复制后需补齐上下文与回调处理。
核心亮点
- 类型安全的请求与响应模型,编译期即可发现字段错误
- 原生支持 async/await 与流式返回,适合实现逐字输出交互
- 通过 SPM 分发,集成成本低,覆盖聊天、图像、嵌入、音频等常用端点
不足之处
- 仅支持 Swift 生态,非 Apple 平台项目无法使用
- OpenAI 新端点上线后需等待社区跟进,覆盖可能滞后
- 文档与示例相对精简,复杂场景需阅读源码
适用场景
- iOS/macOS 应用内集成 AI 对话或文本生成功能
- Swift 服务端项目调用嵌入接口做语义检索
- 在 Apple 平台快速搭建 AI 功能原型
替代项目
openai-python、openai-node、langchain
上一篇:sttp-ai
下一篇:openai-python
同类项目推荐
goal-flow
开源
用图编排智能体,一键迁移 Dify 工作流为代码
Graph-Orchestrated Agent Loop — a production-grade framework on LangGraph. Combine ···
flutter_edge_ai
开源
Flutter 应用一键接入本地大模型,离线也能对话、检索和语音交互
On-device AI for Flutter — Gemma and other LLMs, multimodal, function calling, embe···
codex-profiles
开源
一键切换 Codex/ChatGPT 多账号,独立状态不串号
Named CODEX_HOME profiles and ChatGPT Desktop windows with separate local state, wit···
ChatUI
开源
用 React 快速搭建专业聊天界面,省时又好看
The UI design language and React library for Conversational UI
openai
开源
Flutter 应用一行接入大模型,聊天语音微调全支持
The unofficial OpenAI SDK for Dart & Flutter. Full API coverage + OpenAI-compatible ···
FastQL
开源
一行 Python 代码,快速启动 Rust 驱动的 GraphQL API
Spin up a super fast Rust powered GraphQL API to prototype your ML model in one line···
TaskingAI
开源
一站式搭建 AI 原生应用,省去模型对接和编排烦恼
The open source platform for AI-native application development.
tardigrade
开源
事件日志驱动,Agent 状态可回放可恢复
The TypeScript framework for building composable actors around an immutable event lo···
best-llm-finder-pipeline
开源
三套流水线,自动帮你挑出最合适的LLM
Agentic RAG, Multi-Agent Systems, and Vision Reasoning are three pipelines to find t···