Beforehand, we offered a transient introduction to Google Gemini APIs and demonstrated methods to construct a Q&A software utilizing SwiftUI. It is best to notice how simple it’s to combine Google Gemini and improve your apps with AI options. We’ve additionally developed a demo software to exhibit methods to assemble a chatbot app utilizing the AI APIs.

The gemini-pro mannequin mentioned within the earlier tutorial is proscribed to producing textual content from text-based enter. Nevertheless, Google Gemini additionally provides a multimodal mannequin known as gemini-pro-vision, which might generate textual content descriptions from photographs. In different phrases, this mannequin has the capability to detect and describe objects in a picture.

On this tutorial, we are going to exhibit methods to use Google Gemini APIs for picture recognition. This easy app permits customers to pick a picture from their photograph library and makes use of Gemini to explain the contents of the photograph.

Earlier than continuing with this tutorial, please go to Google AI Studio and create your individual API key for those who haven’t achieved so already.

Including Google Generative AI Package deal in Xcode Tasks

Assuming you’ve already created an app undertaking in Xcode, step one to utilizing Gemini APIs is importing the SDK. To perform this, right-click on the undertaking folder within the undertaking navigator and choose Add Package deal Dependencies. Within the dialog field, enter the next package deal URL:

https://github.com/google/generative-ai-swift

You possibly can then click on on the Add Package deal button to obtain and incorporate the GoogleGenerativeAI package deal into the undertaking.

Subsequent, to retailer the API key, create a property file named GeneratedAI-Data.plist. On this file, create a key named API_KEY and enter your API key as the worth.

To learn the API key from the property file, create one other Swift file named APIKey.swift. Add the next code to this file:

enum APIKey {
  // Fetch the API key from `GenerativeAI-Data.plist`
  static var `default`: String {

    guard let filePath = Bundle.major.path(forResource: "GenerativeAI-Data", ofType: "plist")
    else {
      fatalError("Could not discover file 'GenerativeAI-Data.plist'.")
    }

    let plist = NSDictionary(contentsOfFile: filePath)

    guard let worth = plist?.object(forKey: "API_KEY") as? String else {
      fatalError("Could not discover key 'API_KEY' in 'GenerativeAI-Data.plist'.")
    }

    if worth.begins(with: "_") {
      fatalError(
        "Observe the directions at https://ai.google.dev/tutorials/setup to get an API key."
      )
    }

    return worth
  }
}

Constructing the App UI

The person interface is easy. It contains a button on the backside of the display screen, permitting customers to entry the built-in Picture library. After a photograph is chosen, it seems within the picture view.

To carry up the built-in Photographs library, we use PhotosPicker, which is a local photograph picker view for managing photograph picks. When presenting the PhotosPicker view, it showcases the photograph album in a separate sheet, rendered atop your app’s interface.

First, that you must import the PhotosUI framework with a view to use the photograph picker view:

import PhotosUI

Subsequent, replace the ContentView struct like this to implement the person interface:

struct ContentView: View {

    @State non-public var selectedItem: PhotosPickerItem?
    @State non-public var selectedImage: Picture?

    var physique: some View {
        VStack {

            if let selectedImage {
                selectedImage
                    .resizable()
                    .scaledToFit()
                    .clipShape(RoundedRectangle(cornerRadius: 20.0))
            } else {

                Picture(systemName: "photograph")
                    .imageScale(.massive)
                    .foregroundStyle(.grey)
                    .body(maxWidth: .infinity, maxHeight: .infinity)
                    .background(Colour(.systemGray6))
                    .clipShape(RoundedRectangle(cornerRadius: 20.0))
            }

            Spacer()

            PhotosPicker(choice: $selectedItem, matching: .photographs) {
                Label("Choose Picture", systemImage: "photograph")
                    .body(maxWidth: .infinity)
                    .daring()
                    .padding()
                    .foregroundStyle(.white)
                    .background(.indigo)
                    .clipShape(RoundedRectangle(cornerRadius: 20.0))
            }
        }
        .padding(.horizontal)
        .onChange(of: selectedItem) { oldItem, newItem in
            Job {
                if let picture = strive? await newItem?.loadTransferable(kind: Picture.self) {
                    selectedImage = picture
                }
            }
        }
    }
}

To make use of the PhotosPicker view, we declare a state variable to retailer the photograph choice after which instantiate a PhotosPicker view by passing the binding to the state variable. The matching parameter lets you specify the asset kind to show.

When a photograph is chosen, the photograph picker mechanically closes, storing the chosen photograph within the selectedItem variable of kind PhotosPickerItem. The loadTransferable(kind:completionHandler:) technique can be utilized to load the picture. By attaching the onChange modifier, you’ll be able to monitor updates to the selectedItem variable. If there’s a change, we invoke the loadTransferable technique to load the asset knowledge and save the picture to the selectedImage variable.

As a result of selectedImage is a state variable, SwiftUI mechanically detects when its content material adjustments and shows the picture on the display screen.

Picture Evaluation and Object Recognition

Having chosen a picture, the following step is to make use of the Gemini APIs to carry out picture evaluation and generate a textual content description from the picture.

Earlier than utilizing the APIs, insert the next assertion on the very starting of ContentView.swift to import the framework:

import GoogleGenerativeAI

Subsequent, declare a mannequin property to carry the AI mannequin:

let mannequin = GenerativeModel(identify: "gemini-pro-vision", apiKey: APIKey.default)

For picture evaluation, we make the most of the gemini-pro-vision mannequin offered by Google Gemini. Then, we declare two state variables: one for storing the generated textual content and one other for monitoring the evaluation standing.

@State non-public var analyzedResult: String?
@State non-public var isAnalyzing: Bool = false

Subsequent, create a brand new operate named analyze() to carry out picture evaluation:

@MainActor func analyze() {

    self.analyzedResult = nil
    self.isAnalyzing.toggle()

    // Convert Picture to UIImage
    let imageRenderer = ImageRenderer(content material: selectedImage)
    imageRenderer.scale = 1.0

    guard let uiImage = imageRenderer.uiImage else {
        return
    }

    let immediate = "Describe the picture and clarify what the objects discovered within the picture"

    Job {
        do {
            let response = strive await mannequin.generateContent(immediate, uiImage)

            if let textual content = response.textual content {
                print("Response: (textual content)")
                self.analyzedResult = textual content
                self.isAnalyzing.toggle()
            }
        } catch {
            print(error.localizedDescription)
        }
    }
}

Earlier than utilizing the mannequin’s API, we have to convert the picture view into an UIImage. We then invoke the generateContent technique with the picture and a predefined immediate, asking Google Gemini to explain the picture and determine the objects inside it.

When the response arrives, we extract the textual content description and assign it to the analyzedResult variable.

Subsequent, insert the next code and place it above the Spacer() view:

ScrollView {
    Textual content(analyzedResult ?? (isAnalyzing ? "Analyzing..." : "Choose a photograph to get began"))
        .font(.system(.title2, design: .rounded))
}
.padding()
.body(maxWidth: .infinity, maxHeight: .infinity, alignment: .main)
.background(Colour(.systemGray6))
.clipShape(RoundedRectangle(cornerRadius: 20.0))

This scroll view shows the textual content generated by Gemini. Optionally, you’ll be able to add an overlay modifier to the selectedImage view. This can show a progress view whereas a picture evaluation is being carried out.

.overlay {

    if isAnalyzing {
        RoundedRectangle(cornerRadius: 20.0)
            .fill(.black)
            .opacity(0.5)

        ProgressView()
            .tint(.white)
    }
}

After implementing all of the adjustments, the preview pane ought to now be displaying a newly designed person interface. This interface contains of the chosen picture, the picture description space, and a button to pick images from the photograph library. That is what you need to see in your preview pane if all of the steps have been adopted and executed appropriately.

Lastly, insert a line of code within the onChange modifier to name the analyze() technique after the selectedImage. That’s all! Now you can take a look at the app within the preview pane. Click on on the Choose Picture button and select a photograph from the library. The app will then ship the chosen photograph to Google Gemini for evaluation and show the generated textual content within the scroll view.

Abstract

The tutorial demonstrates methods to construct an AI picture recognition app utilizing Google Gemini APIs and SwiftUI. The app permits customers to pick a picture from their photograph library and makes use of Gemini to explain the contents of the photograph.

From the code we have now simply labored on, you’ll be able to see that it solely requires a number of traces to immediate Google Gemini to generate textual content from a picture. Though this demo illustrates the method utilizing a single picture, the API truly helps a number of photographs. For additional particulars on the way it capabilities, please consult with the official documentation.