AI Providers

An AI Provider is a service, such as OpenAI, that offers tools powered by artificial intelligence (AI) to help automate tasks. For example, Rock's Prayer Request system can tap into this power to fix grammar, suggest categories, and other things for prayer requests. Check out the Raising Up With Prayer guide for more information on configuring Prayer AI Automation.

Rock includes two AI providers: the official OpenAI provider and a generic OpenAI-compatible provider. Setup steps may vary depending on which provider you choose. Here, we'll focus on configuring the basic OpenAI provider.

Configuring OpenAI

Although we can't describe how all AI providers work, this is how you would get the required keys from OpenAI for use inside Rock.

Step 1: Sign-up

Visit OpenAI's Platform website. Log in using your credentials. If you don’t have an account, sign up for one.

Step 2: Copy your Organization ID

After logging in, navigate to the Organization > General page. Copy your Organization ID for use later in Rock.

Step 3: Access the API Keys Page

Next, navigate to the API keys page. Note this can be found under Organization or under Project.

Step 4: Create a New API Key

On the API Keys page, click the + Create new secret key. A popup will appear with your newly generated secret API key.

Note

This key will only be shown once. Be sure to copy and securely save it (e.g., in a password manager or a secure document).

Step 5: Use the API Key in Rock

Once you have your API key, navigate to Admin Tools > Settings > AI Providers.

Select the "Open AI" provider from the list.

Enter the API key Secret Key field and the Organization Id in the OpenAI Organization Id field.

Copy API Key into Rock

Select the Default Model you'd like to use. GPT-4o-Mini is the most affordable model; while GPT-4o is the most performant.

Note

Pricing and Other Info
OpenAI charges usage based on the volume of tokens (words) processed. Check their pricing page for details. Keep your API key private. Never expose it in public repositories or unsecured environments. For further details, consult the OpenAI API documentation.