Quick Start

This guide walks you through the absolute minimum setup required to get a response from an AI model in your Unreal Engine project. In about five minutes, you’ll have a working example that confirms your installation is successful and demonstrates the plugin’s core functionality.

Step 1: Install the Plugin

First, ensure you have installed GenAI for Unreal from the Unreal Engine Marketplace (or Fab.com). Once installed, open your project, enable the plugin from the Edit > Plugins menu, and restart the editor if prompted.

Plugin Installation — Find the GenAI plugin in the Epic Games Launcher or Fab.com.

Step 2: Add Your API Key

The plugin needs an API key to communicate with AI services. For this quick start, we’ll use OpenAI.

Navigate to Project Settings > Plugins > GenAI and paste your OpenAI API key into the designated field. While this is the fastest way to get started, we strongly recommend exploring our Authentication & Security guide for best practices in production environments.

API Key Setup — Enter your OpenAI API key in the Project Settings.

Step 3: Set Up the Blueprint

Now, let’s create a simple Actor to send our first request.

Create a new Actor Blueprint in your Content Drawer.
Open the Blueprint and navigate to the Event Graph.

We will use the Event BeginPlay node to trigger our AI request as soon as the game starts. The core of this logic is the Request OpenAI Chat Completion node, which handles the entire web request asynchronously.

Replicate the Blueprint graph shown in the image below. (You can click the image to view it in full size.)

Quick Start Blueprint Example — A simple setup for testing chat completion.

Step 4: Breaking Down the Nodes

Here is a step-by-step breakdown of the node connections:

Trigger: Connect the Event BeginPlay execution pin to the Request OpenAI Chat Completion node.
Settings: The Settings pin configures the request. For now, leave this with its default values by adding a Make Gen AI Chat Settings node.
Message: The Messages pin contains the actual prompt.
Add a Make Gen Chat Message node.
Set the Role to user.
Set the Content to "Tell me a joke."
Response: The OnComplete event fires when the AI responds.
Drag off the OnComplete execution pin and add a Print String node.
Connect the Response > Content output from the completion node to the In String input of the Print String node.

Step 5: Press Play!

That’s it! Drag your new Blueprint Actor into the level, save everything, and press Play in the editor. You should see a fresh, AI-generated joke printed in the top-left corner of your viewport.

Congratulations on sending your first request!