Skip to content

darya-varabei/OpenAIImageClient

Repository files navigation

Static Badge Static Badge Static Badge Static Badge

logo

OpenAIImageClient

A lightweight Swift package for interacting with OpenAI's gpt-image-1 model to generate or edit images using natural language prompts and image files.

✨ Features

  • Supports multiple input images (image[]) for editing
  • Uses multipart/form-data requests to match OpenAI API requirements
  • Returns generated image data in decoded PNG format
  • Compatible with SwiftUI and UIKit
  • Swift Concurrency (async/await) support

🛠 Requirements

  • iOS 15.0+ / macOS 12.0+
  • Swift 5.7+
  • Valid OpenAI API key with account verification
  • Network permission enabled

📦 Installation

Add to your project via Swift Package Manager:

.package(url: "https://github.com/darya-varabei/OpenAIImageClient.git", from: "1.0.0")

💡 Usage

For image generation (generate image from prompt):

    private let client = OpenAIImageClient(apiKey: "sk-***") // recommended to NOT store in code for production apps

    let prompt = "Generate an image of a spaceship"
    
    do {
        let results = try await client.generateImage(prompt: prompt, size: .x1536x1024)
        if let data = results.first?.data {
            image = UIImage(data: data)
        }
    } catch {
        self.error = error.localizedDescription
    }

For image edit (edit provided images according to provided prompt):

    private let client = OpenAIImageClient(apiKey: "sk-***") // recommended to NOT store in code for production apps
    
    let prompt = "Make the room look like a spaceship"
    
    let images = [UIImage(named: "result")!.pngData()!]
    
    do {
        let results = try await client.editImages(images: images, prompt: prompt)
        if let data = results.first {
            image = UIImage(data: data)
        }
    } catch {
        self.error = error.localizedDescription
    }

🔮 To be added

  • Test coverage
  • More OpenAI requst parameters
  • Anything else proposed by community :)

About

Generate and edit images using gpt-image-1 model

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages