Blog Studio Go to console

FirebaseAI Framework Reference

FirebaseAI

@available(iOS 15.0, macOS 12.0, tvOS 15.0, watchOS 8.0, *)
public final class FirebaseAI : Sendable

The Firebase AI SDK provides access to Gemini models directly from your app.

Public APIs

  • Creates an instance of FirebaseAI.

    Declaration

    Swift

    public static func firebaseAI(app: FirebaseApp? = nil,
                              backend: Backend = .googleAI(),
                              useLimitedUseAppCheckTokens: Bool = false) -> FirebaseAI

    Parameters

    app

    A custom FirebaseApp used for initialization; if not specified, uses the default FirebaseApp.
    backend

    The backend API for the Firebase AI SDK; if not specified, uses the default googleAI() (Gemini Developer API).
    useLimitedUseAppCheckTokens

    When sending tokens to the backend, this option enables the usage of App Check’s limited-use tokens instead of the standard cached tokens. Learn more about limited-use tokens, including their nuances, when to use them, and best practices for integrating them into your app.

    Return Value

    A FirebaseAI instance, configured with the custom FirebaseApp.

  • Initializes a generative model with the given parameters.

    Note

    Refer to Gemini models for guidance on choosing an appropriate model for your use case.

    Declaration

    Swift

    public func generativeModel(modelName: String,
                            generationConfig: GenerationConfig? = nil,
                            safetySettings: [SafetySetting]? = nil,
                            tools: [Tool]? = nil,
                            toolConfig: ToolConfig? = nil,
                            systemInstruction: ModelContent? = nil,
                            requestOptions: RequestOptions = RequestOptions())
  -> GenerativeModel

    Parameters

    modelName

    The name of the model to use, for example "gemini-1.5-flash"; see available model names for a list of supported model names.
    generationConfig

    The content generation parameters your model should use.
    safetySettings

    A value describing what types of harmful content your model should allow.
    tools

    A list of Tool objects that the model may use to generate the next response.
    toolConfig

    Tool configuration for any Tool specified in the request.
    systemInstruction

    Instructions that direct the model to behave a certain way; currently only text content is supported.
    requestOptions

    Configuration parameters for sending requests to the backend.

  • Initializes an ImagenModel with the given parameters.

    Important

    Only Imagen 3 models (named imagen-3.0-*) are supported.

    Declaration

    Swift

    public func imagenModel(modelName: String, generationConfig: ImagenGenerationConfig? = nil,
                        safetySettings: ImagenSafetySettings? = nil,
                        requestOptions: RequestOptions = RequestOptions()) -> ImagenModel

    Parameters

    modelName

    The name of the Imagen 3 model to use, for example "imagen-3.0-generate-002"; see model versions for a list of supported Imagen 3 models.
    generationConfig

    Configuration options for generating images with Imagen.
    safetySettings

    Settings describing what types of potentially harmful content your model should allow.
    requestOptions

    Configuration parameters for sending requests to the backend.

  • [Public Preview] Initializes a LiveGenerativeModel with the given parameters.

    Warning

    Using the Firebase AI Logic SDKs with the Gemini Live API is in Public Preview, which means that the feature is not subject to any SLA or deprecation policy and could change in backwards-incompatible ways.

    Important: Only models that support the Gemini Live API (typically containing live-* in the name) are supported.

    Declaration

    Swift

    @available(iOS 15.0, macOS 12.0, tvOS 15.0, *)
@available(watchOS, unavailable)
public func liveModel(modelName: String,
                      generationConfig: LiveGenerationConfig? = nil,
                      tools: [Tool]? = nil,
                      toolConfig: ToolConfig? = nil,
                      systemInstruction: ModelContent? = nil,
                      requestOptions: RequestOptions = RequestOptions()) -> LiveGenerativeModel

    Parameters

    modelName

    The name of the model to use, for example "gemini-live-2.5-flash-preview"; see model versions for a list of supported models.
    generationConfig

    The content generation parameters your model should use.
    tools

    A list of Tool objects that the model may use to generate the next response.
    toolConfig

    Tool configuration for any Tool specified in the request.
    systemInstruction

    Instructions that direct the model to behave a certain way; currently only text content is supported.
    requestOptions

    Configuration parameters for sending requests to the backend.