AIProxySwift 仓库中文介绍文档

AIProxySwift 是一款 Swift 客户端库，用于集成 AI 提供商的 API，支持通过代理后端保护 API 密钥并管理请求安全，由 lzell 维护，汇聚 OpenAI、Gemini、Anthropic 等多个 AI 提供商的接口。

要点：

• 这是一个 Swift 客户端库，用于与多种 AI 提供商进行交互，并提供代理后端以增强安全性
• 由 lzell 维护，支持多个主流 AI 平台
• 包含丰富的功能模块和安全机制

示例： AIProxySwift 是一个 Swift 客户端库，用于集成 AI 提供商的 API，支持通过代理后端保护 API 密钥并管理请求安全，由 lzell 维护，汇聚 OpenAI、Gemini、Anthropic 等多个 AI 提供商的接口。

一、核心信息速览

二、核心功能

三、快速上手

1. 环境准备

• Xcode 14 或更高版本
• Swift 5.0 或更高版本

2. 安装方式

使用 Xcode 添加依赖

1. 打开 Xcode 项目，选择 File > Add Package Dependencies
2. 输入 https://github.com/lzell/AIProxySwift，选择 main 分支或特定版本

使用 CocoaPods 安装

pod "AIProxy"
pod install

3. 基础配置

在应用启动时调用 AIProxy.configure 方法进行初始化：

import AIProxy

@main
struct MyApp: App {
    init() {
        AIProxy.configure(
            logLevel: .debug,
            printRequestBodies: false,
            printResponseBodies: false,
            resolveDNSOverTLS: true,
            useStableID: true
        )
    }
    // ...
}

4. 核心示例

以下是一个简单的示例，展示如何调用 OpenAI 的 API：

import AIProxy

let openAI = OpenAI(apiKey: "your-api-key")
let response = await openAI.completion(prompt: "Hello, world!")
print(response.choices[0].text)

四、核心亮点

1. 多平台支持：支持 OpenAI、Gemini、Anthropic 等多个 AI 提供商的 API，方便集成。
2. 安全机制：提供五级安全机制，包括证书绑定、设备验证、密钥加密等，确保 API 密钥安全。
3. 代理后端：可通过 AIProxy 后端保护 API 密钥，防止直接暴露在客户端。
4. iCloud 支持：支持使用 iCloud Key-Value 存储进行用户标识管理，实现多设备下的用户级速率限制。

五、适用场景

1. AI 应用开发：适用于需要集成多个 AI 服务的 iOS 或 macOS 应用。
2. API 安全管理：适用于需要保护 API 密钥的项目，避免直接暴露在客户端。
3. 多设备支持：适用于需要在多个设备上管理用户身份的应用，如跨设备同步功能。

六、优缺点

优势

• 支持多个 AI 提供商，方便集成
• 提供五级安全机制，保障 API 请求的安全性
• 支持 iCloud Key-Value 存储，便于多设备管理

不足

• 文档可能不够详细，对新手有一定学习成本
• 依赖于第三方服务（如 AIProxy），需注意其可用性

七、与同类工具对比（可选）

八、总结

AIProxySwift 是一个适合 iOS/macOS 开发者的 Swift 客户端库，能够帮助开发者快速集成多个 AI 提供商的 API，并通过代理后端保护 API 密钥。它适用于需要安全管理和多平台支持的 AI 应用开发，但对新手来说可能需要一定时间适应。