Connect OpenAI, Anthropic Claude, Google Gemini and other AI APIs to your iOS or macOS app with Swift concurrency, typed requests and streaming responses. Use the HyperProxy AI gateway to keep provider API keys out of your app, or choose explicit direct-provider transport in a trusted environment.
Website · Documentation · Usage guide · SwiftUI Playground · Issues
Current release: 0.5.0. The examples below use that version's shorter request names, message factories and catalog-bound services. Release changes are listed in the changelog. Source decisions and app privacy requirements are recorded in release checks.
- AI chat and assistants: provider-native requests with
async/awaitand server-sent events. - Image, speech and multimodal features: JSON, multipart uploads, binary responses and WebSocket transport, with optional realtime audio capture and playback.
- Gateway-backed Apple apps: split-key credentials, DeviceCheck and App Attest integration.
- Multi-provider apps: separate Swift modules without forcing every provider into one schema.
Typed bindings cover the checked-in provider schemas. For new fields and endpoints, use your
own Codable types or raw JSON and HTTP calls without waiting for an SDK release.
- Swift 6.2 or later.
- iOS 15+, macOS 13+, visionOS 1+ or watchOS 9+.
- A configured HyperProxy service and your own provider account for gateway mode.
Platform support does not mean every optional Apple security or audio API is available on every device. Test the features you use on your target hardware.
In Xcode, choose File → Add Package Dependencies and enter:
https://github.com/Tsvihun/HyperProxySwift.git
In a Package.swift manifest, select the 0.5.x release line:
.package(
url: "https://github.com/Tsvihun/HyperProxySwift.git",
.upToNextMinor(from: "0.5.0")
)For development against future changes, select main instead of a version tag:
.package(
url: "https://github.com/Tsvihun/HyperProxySwift.git",
branch: "main"
)Add the product your target needs:
.product(name: "HyperProxyOpenAI", package: "HyperProxySwift")Choose a provider product for a focused dependency, HyperProxyCore for raw transport,
or HyperProxy to import all providers. The 0.5.0 release is available through Swift
Package Manager and CocoaPods. See the CocoaPods instructions.
- Configure an OpenAI service in your HyperProxy dashboard with your provider key.
- Copy the service's gateway URL and app key. Do not substitute the provider API key.
- Call the provider from an asynchronous context in your app:
import Foundation
import HyperProxyOpenAI
let openAI = HyperProxy.openAI(
gatewayURL: URL(string: "https://api.hyperproxyai.com/<project>/<service>")!,
appKey: "<app-key>"
)Run this inside an async throws function, or a Task that handles thrown errors:
let response: OpenAIResponse = try await openAI.responsesCreate(
OpenAIResponseRequest(input: "Say hello in one sentence.", model: .gpt5)
)For extracting response text, see Responses output.
Use the exact URL supplied by your dashboard and a model available to your provider account. The placeholders above are not working credentials. Provider usage is billed by the provider; a HyperProxy plan does not include OpenAI or other provider credits.
for try await chunk in try openAI.chatCompletionsCreateStream(
OpenAIChatRequest(
messages: [.user("Write one sentence about Swift.")],
model: .gpt5,
streamOptions: .init(includeUsage: true)
)
) {
print(chunk.choices.first?.delta.content ?? "", terminator: "")
}The typed streaming method enables streaming in the request. See the usage guide for raw events, uploads, WebSockets, errors and response metadata.
| Provider | SwiftPM product / import |
|---|---|
| OpenAI | HyperProxyOpenAI |
| Anthropic Claude | HyperProxyAnthropic |
| Google Gemini | HyperProxyGemini |
| DeepSeek, Mistral | HyperProxyDeepSeek, HyperProxyMistral |
| OpenRouter, Perplexity, Groq | HyperProxyOpenRouter, HyperProxyPerplexity, HyperProxyGroq |
| Together AI, Fireworks AI | HyperProxyTogether, HyperProxyFireworks |
| Stability AI, Replicate, fal, Black Forest Labs | HyperProxyStability, HyperProxyReplicate, HyperProxyFal, HyperProxyBFL |
| ElevenLabs, EachAI | HyperProxyElevenLabs, HyperProxyEachAI |
| Brave Search, DeepL | HyperProxyBrave, HyperProxyDeepL |
See provider recipes and the
coverage contract for endpoint-level details. Provider availability,
permissions and pricing depend on your provider account; a module is not a promise that every
provider endpoint has been exercised live. Unlisted APIs can use HyperProxy.generic(...).
When HyperProxy itself refuses a request — the monthly plan allowance is used up, a spend
budget is reached, an app key was retired — the thrown HyperProxyError.httpStatus carries a
decoded gatewayRejection. Provider errors passed through the gateway leave it nil, so the
two never blur together:
do {
_ = try await openAI.chatCompletionsCreate(
OpenAIChatRequest(messages: [.user("Hello")], model: .gpt5)
)
} catch let error as HyperProxyError {
switch error.gatewayRejection?.reason {
case .planQuotaExceeded, .budgetExceeded:
print("Allowance reached. Resets:", error.gatewayRejection?.periodResetsAt as Any)
case .rateLimited:
print("Rate limited. Retry after:", error.retryAfter as Any)
case .expiredKey, .unknownOrRevokedKey, .invalidAppKey:
print("Replace the app key with its current value from the dashboard.")
default:
throw error
}
}WebSocket sessions surface the same vocabulary as HyperProxyWebSocketError.gatewayRejected
(close codes 4029 for quota and budget, 4429 for rate limits, 4001/4003/4004 for key and
service problems). HyperProxyRetryPolicy consults the same decoder and never retries a
refusal that cannot clear on its own, even when the status is otherwise retryable.
Paid accounts can disable Usage-based billing in Account to stop new requests at their included allowance. It is enabled by default; Free always stops at its allowance. See quota guidance.
- Keep long-lived provider secrets out of mobile apps. Gateway mode sends an app key rather than the provider key; configure attestation, endpoint restrictions and quotas on the gateway.
- An app key is not an authorization boundary by itself. Follow the DeviceCheck and App Attest guide and test on hardware.
- This branch rejects HTTP redirects for credential-bearing transport. Configure the final URL.
- Direct-provider mode is explicit and does not protect a provider key embedded in your app.
- Diagnostics and stable identity are opt-in. Do not log prompts, credentials or personal data unnecessarily; review your app's combined privacy manifest before shipping.
For security reports, email contact@hyperproxyai.com. Do not post keys, customer data or exploitable details in a public issue.
- Detailed usage guide: transport, streaming, media and security.
- SwiftUI Playground: an MVVM iOS app for typed calls, JSON, SSE,
uploads, WebSockets, and response diagnostics using your own gateway configuration.
Its optional
HyperProxyPlaygroundproduct exposes the same screen for other test apps. - Runnable quick start: a small executable example.
- Device security probe: physical-device verification.
- Observability: sessions, prompts and external telemetry.
- Migrating from a compatible legacy gateway: keep the old wire contract during rollout.
- Architecture and testing.
For bugs, open an issue with your SDK revision, platform and a minimal example with secrets removed. For account or billing questions, contact HyperProxy support.
The SDK's license is MIT. It does not grant rights to provider services, third-party content or trademarks. The generated interfaces have an outstanding source-rights review before the next release.
Provider names identify compatible services. HyperProxySwift is an independent SDK, not an official SDK of OpenAI, Anthropic, Google or the other listed providers; no affiliation or endorsement is implied.