1 of 1

Stability AI

The Stability AI AddOn is only available for Superpowers and Enterprise plans.

AI Stable Diffusion XL AddOn Text-to-Image

The Stability AI AddOn converts text to images. This feature allows your end users to submit descriptions of what they would like to see in their AI-generated images, and to also submit negative prompts of what they do not want to see in their image. Once they submit the prompt and negative prompt, they'll receive an AI-generated image that they can use directly within their designs. Visit the AI-generated white label end user guide to learn more about how this feature works for your application's end users.

How to activate

This section discusses the prerequisites and steps you need to take to get started with this feature.

Prerequisites

Stability AI API key
Stability AI addOn installed in the Beefree SDK Developer Console

Take the following steps to activate this feature:

Log in to the Beefree SDK Developer Console.
Navigate to the application you'd like install the addOn in.
Install the Stability AI addOn.
Provide the requested details.
Save your changes.

The addOn is now activated.

Configuration settings

The Stability AI text-to-image AddOn uses a new handle.

This handle is ai-image-generation.

Consider the following settings when configuring this feature in your code:

Sample code

This section includes sample code you can use to configure this AddOn.

onInfo example

Use the following code sample to configure this feature for your application.

onInfo: function (infoMessage) {
  if (infoMessage.code === 1000) {
    var handle = infoMessage.detail.handle

    if (handle === 'ai-image-generation') {
      imagesCounter += infoMessage.detail.consumedImages
        const refreshedUsageSettings = {
          addOns: [
            {
              id: "ai-image-generation",
              settings: {
                imagesAvailable: imagesAvailable,
                imagesUsed: imagesCounter,
                isGenerationDisabled: (imagesCounter >= imagesAvailable) ? true : false,
                upsellTrigger: 3,
                isUpsellEnabled: isUpsellEnabled,
              }
            },
          ],
        }
        // Reload Config
        bee.loadConfig(refreshedUsageSettings)
      }
  }
},

Upsell example

Use the following code to communicate to your end users when they have used all of their available image generations for this feature and need to purchase more.

upsell: {
  label: 'upsell',
  handler:(resolve, reject, args)=>{
    if(args.handle === 'ai-image-generation'){
      imagesAvailable+=5
      resolve({
        addOns:[{
          id: "ai-image-generation",
          settings: {
            imagesAvailable: imagesAvailable,
            imagesUsed: imagesCounter,
            isGenerationDisabled: (imagesCounter >= imagesAvailable) ? true : false,
            upsellTrigger: 3,
            isUpsellEnabled: isUpsellEnabled,
          }}]
        })
    }
  }
},

Disable generation per user example

Use the following code to disable this text-to-image generation for a user of your application. This feature will still be visible within the builder, but they will not be able to use this. A potential use case for this is if you'd like to motivate an end user to upgrade for access to this feature.

addOns: [
  {
    id: "ai-image-generation",
    settings:{
      isGenerationDisabled: true,
    }
  },
],

Disable AddOn per user

Use the following code to disable this feature for a user of your application.

addOns: [
  {
    id: "ai-image-generation",
    enabled: false,
  },
],