SwiftOpenAI Response API实战：比Chat Completions更强大的新一代API

SwiftOpenAI Response API实战比Chat Completions更强大的新一代API【免费下载链接】SwiftOpenAIThe most complete open-source Swift package for interacting with OpenAIs public API.项目地址: https://gitcode.com/gh_mirrors/sw/SwiftOpenAISwiftOpenAI是目前最完整的开源 Swift 包覆盖 OpenAI 全部公共 API 端点。而 OpenAI 的Response API正是取代 Chat Completions 的新一代接口它会话有状态、内置工具开箱即用、流式事件更丰富。本文将带你用 SwiftOpenAI 快速上手 Response API三步完成第一次调用并掌握多轮对话与实时流式输出。为什么该从 Chat Completions 升级到 Response API很多开发者还在用 Chat Completions 手动维护对话历史、拼接收工具结果。Response API 从设计上解决了这些痛点对比维度Chat CompletionsResponse API会话状态无状态需自己携带全部历史消息传入previousResponseId即可续接对话内置工具仅支持自定义函数调用原生支持网络搜索、文件搜索、图像生成等流式事件文本增量为主40 种结构化事件推理摘要、工具调用、文本增量等模型支持GPT-4o 等原生支持 GPT-5 系列gpt-5 / gpt-5-mini / gpt-5-nano 简单说Response API 让你把管理对话的脏活累活交给 OpenAI 服务端代码量更少、上下文更省 token。安装 SwiftOpenAI 并初始化服务SwiftOpenAI 通过 Swift Package Manager 一键安装支持 iOS 15、macOS 13、watchOS 9 与 Linux在 Xcode 中打开File → Add Package Dependency输入仓库地址可从 gitcode 镜像克隆git clone https://gitcode.com/gh_mirrors/sw/SwiftOpenAI选择版本号点击Add Package初始化只需两行代码import SwiftOpenAI let service OpenAIServiceFactory.service(apiKey: your_api_key)服务工厂的便捷初始化方法定义在 OpenAIServiceFactory.swift它还内置了 Azure、本地模型Ollama 等 OpenAI 兼容服务的配置支持。第一步发送你的第一个 Response API 请求Response API 的请求参数由 ModelResponseParameter.swift 定义核心只有input和model两个必填项let parameters ModelResponseParameter( input: .string(What is the capital of France?), model: .gpt5 ) let response try await service.responseCreate(parameters) print(response.outputText ?? )返回的 ResponseModel 包含id后续多轮对话的关键、status、output等字段还贴心提供了outputText便捷属性——聚合所有文本输出无需手动遍历。服务层的四个核心方法都在 OpenAIService.swiftresponseCreate— 创建响应同步responseCreateStream— 创建流式响应responseModel(id:)— 按 ID 检索历史响应responseModelStream— 流式检索多轮对话秘诀用 previousResponseId 免维护历史传统做法是把整段对话历史塞进请求token 消耗巨大。Response API 只需记住上一次响应的 ID// 第一次对话 let first try await service.responseCreate(parameters) let previousID first.id // 第二轮自动携带上下文无需重传历史 let nextParams ModelResponseParameter( input: .string(What else is interesting about that country?), model: .gpt5, previousResponseId: previousID ) let second try await service.responseCreate(nextParams)这个字段在参数定义中的注释写得很直白ModelResponseParameter.swiftThe unique ID of the previous response to the model. Use this to create multi-turn conversations.⚠️ 小贴士配合instructions使用previousResponseId时上一轮的系统指令不会自动继承——这让你可以灵活地在对话中途切换人设。实时流式输出让文字像打字机一样涌现对聊天类应用流式体验是标配。SwiftOpenAI 的 ResponseStreamEvent.swift 把 SSE 事件全部类型化封装涵盖 40 多种事件let stream try await service.responseCreateStream(parameters) for try await event in stream { switch event { case .outputTextDelta(let delta): // 文本增量到达实时刷新 UI print(delta.delta, terminator: ) case .responseCompleted(let completed): print(\nResponse ID: \(completed.response.id)) case .error(let error): print(error.message) default: break } } 项目里就有一个完整的 SwiftUI 流式聊天示例 ResponseStreamProvider.swift它演示了真实产品级用法用previousResponseId自动续接多轮对话第 130 行开启图像生成工具tools: [.imageGeneration(.init())]第 131 行通过Task支持中途取消流stopStreamingUI 层代码见 ResponseStreamDemoView.swift可以直接运行体验效果。内置工具网络搜索与图像生成零配置Chat Completions 时代联网搜索要自己接第三方接口Response API 只需一行参数声明参考 README.md 的官方示例let parameters ModelResponseParameter( input: .string(What was a positive news story from today?), model: .gpt4o, tools: [.webSearchPreview] )图像生成同样开箱即用示例项目中的流式对话就启用了它。此外还支持自定义函数调用与 Chat Completions 相同的工具格式无缝迁移文件搜索对接向量存储让模型读懂你的文档库推理配置reasoning: Reasoning(effort: high)控制 o 系列推理力度项目文件地图Response API 相关代码导航模块文件位置请求参数定义ModelResponseParameter.swift输入类型文本/数组InputType.swift服务接口4 个核心方法OpenAIService.swift响应对象模型ResponseModel.swift流式事件40 种ResponseStreamEvent.swift完整流式聊天示例ResponseAPIDemo/单元测试ModelResponseParameterTests.swift官方文档的详细用法说明也收录在 README.md 的 Response 章节。小结Response API 是 OpenAI 面向 Agent 时代的战略接口而 SwiftOpenAI 已经把它的能力完整搬进了 Swift 世界。三句话总结今天的收获入门极简ModelResponseParameterresponseCreate两行代码发请求会话省事previousResponseId一个字段搞定多轮对话状态流式强大responseCreateStream 类型化事件聊天体验丝滑涌现如果你的项目还在 Chat Completions 上手动维护历史消息现在就是最好的迁移时机 【免费下载链接】SwiftOpenAIThe most complete open-source Swift package for interacting with OpenAIs public API.项目地址: https://gitcode.com/gh_mirrors/sw/SwiftOpenAI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考