Using OpenAI with Hudini

Configure OpenAI to work with Hudini, Hudu's newest AI assistant. 

💡 Must be on version 2.36.0 or later to enable Hudini.

In order to configure OpenAI with Hudini, you will need:
  • Access to retrieve an OpenAI API token.
  • Developer Credits
  • Admin or super-admin user role within Hudu.

Integration Features

Hudini's integration with OpenAI's GPT-4 allows you to:
  • Generate AI responses from prompts anywhere in your Hudu environment. Prompt Hudini to provide a write up that you can copy directly into a KB article. 

hudini.png

 

What Hudu needs from OpenAI

  • API Token

Model Selection

Hudu by default will pre-select the latest version of ChatGPT for you to use unless otherwise specified.

Generation

Once Hudini is enabled in Hudu Admin:

  • Click on the Hudini Icon on the toolbar next to your profile. 
  • Ask Hudini a question. If you have preconfigured prompts, select the desired one before asking. 

hudini_prompt_rule.png

  • Insert your prompt of choice into the provided field and click the arrow icon to generate.
    • Depending on the prompt, this can take a few minutes to generate.
  • When you're happy with the response, you can click either copy icon (copy text or copy HTML) down at the bottom, and paste it into your desired location. 

Hudini_copy.png

What Hudu needs from Azure OpenAI:

  • Endpoint
  • API Key
  • Deployment name
  • API Version

Configuring Azure OpenAI

These steps use the New Foundry interface in Azure AI Foundry. If your portal shows a "New Foundry" toggle in the top right, leave it on to match the steps below.

What Hudu needs from Azure OpenAI

  • Endpoint
  • API Key
  • Deployment name
  • API Version

In Azure

Create the resource

  • In the Azure portal, create an Azure AI Foundry (Azure OpenAI) resource.
  • Choose your subscription, resource group, and region, then work through the network, tags, and review steps and select Create.
  • When it finishes, select Go to resource, then open the Azure AI Foundry portal.

Deploy a model

  • In the left panel, select Models.
  • Select Deploy model, then Deploy base model.
  • Choose a model (for example, gpt-5), then select Deploy.

Find your Endpoint, Key, and Deployment name

  • Select your deployment, then open the Details tab.
  • Your Key is shown at the top of this tab.
  • Your Deployment name is listed under Deployment info > Name.
    In New Foundry, the Endpoint shown on the Details tab ends in /openai/v1/responses. Hudini does not use that address. Do not paste it directly. Instead, build the endpoint from your resource name and deployment name as shown in the next section.

In Hudu

  • Navigate to Admin -> Hudini
  • Enable Hudini
  • Find and select Azure OpenAI from the list
  • Enter your API Key from the deployment Details tab
  • Enter your Endpoint, built in this format using your own resource name and deployment name:
    • https://your-resource-name.openai.azure.com/openai/deployments/your-deployment-name
  • Enter API Version:
    • Use 2025-04-01-preview. Current Azure models (the GPT-5 family) require this version or newer. Older versions such as 2023-05-15 will return a "resource not found" error.
    • This is the Azure API version, not the model version listed under Deployment info. The two are different, and entering the model version here will cause the same error.
  • Select Save

   API versions are updated over time. For the current list of supported versions, see Microsoft's Azure OpenAI API version lifecycle page.

In Hudu:

  • Navigate to Admin -> Hudini
  • Enable Hudini
  • Find and select Azure OpenAI from the list
  • Input your API Key and Endpoint from your deployment
    • The endpoint will need to be edited to look like the following, where the deployment name matches the name of your deployment:
      • https://example.openai.azure.com/openai/deployments/gpt-5
  • Enter API Version:
    • Use 2025-04-01-preview. Current Azure models (the GPT-5 family) require this version or newer. Older versions such as 2023-05-15 will return a "resource not found" error.
    • This is the Azure API version, not the model version listed under Deployment info. The two are different, and entering the model version here will cause the same error.

 

🔗 This integration is designed with safety and ethics in mind. Learn more in our Hudu AI Principles article.

FAQ

My OpenAI API key is not working?

Answer: If your API key is not being accepted, the most common solutions are:

  • Regenerate the API key in OpenAI and re-enter it into Hudu.

  • Ensure that you're using an OpenAI API key – this is different from a ChatGPT Plus subscription.

  • Confirm that you have enough OpenAI developer credits.

    • OpenAI's API is not a free feature; you must either be on their free trial with remaining credits or have a paid billing method set up.

Was this article helpful?
1 out of 2 found this helpful