> For the complete documentation index, see [llms.txt](https://phplime-envato.gitbook.io/qrexorder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://phplime-envato.gitbook.io/qrexorder/ai-configuration.md).

# Ai configuration

## AI Configuration Guide

This document provides instructions for configuring the AI settings in the **QRexOrder** system. These settings empower features like the **Instant AI Menu Creator** and automated content generation.

***

### 🛠️ Accessing AI Settings

1. Log in to the **Admin Dashboard**.
2. Navigate to **Settings** > **AI Configuration** via the left sidebar.
3. Here you can select your preferred AI provider and manage API keys.

***

### 🔌 Supported AI Providers

{% tabs %}
{% tab title="Google Gemini" %}
**Recommended for speed and cost.**

* **API Key**: Obtain from [Google AI Studio](https://aistudio.google.com/).
* **Default Model**: `gemini-1.5-flash`
* **Pros**: High speed, massive context window, and a generous free tier.
  {% endtab %}

{% tab title="OpenAI" %}
**Industry standard for reliability.**

* **API Key**: Obtain from [OpenAI Platform](https://platform.openai.com/api-keys).
* **Default Model**: `gpt-4o-mini` or `gpt-3.5-turbo`
* **Pros**: Highly reliable and consistent formatting.
  {% endtab %}

{% tab title="Anthropic" %}
**Superior reasoning and natural language.**

* **API Key**: Obtain from [Anthropic Console](https://console.anthropic.com/).
* **Default Model**: `claude-3-5-sonnet-20240620`
* **Pros**: Excellent for creative descriptions and complex menu logic.
  {% endtab %}

{% tab title="Zhipu AI" %}
**Optimized for regional performance.**

* **API Key**: Obtain from [Zhipu AI Open Platform](https://open.bigmodel.cn/).
* **Default Model**: `glm-4`
* **Pros**: Strong multilingual support and regional availability.
  {% endtab %}
  {% endtabs %}

#### 🌐 Custom AI (OpenAI Compatible)

For providers like **Groq**, **Together AI**, or **OpenRouter**:

* **Endpoint URL**: The base URL (e.g., `https://api.groq.com/openai/v1`).
* **Extra Headers**: Optional JSON object for specific headers (e.g., `{"HTTP-Referer": "https://qrexorder.com"}`).

***

### 🖼️ Image Fallback (Unsplash)

The system uses **Unsplash** to find high-quality, relevant images for menu items if AI image generation is disabled or fails.

* **Access Key**: Obtain a developer key from the [Unsplash Developer Portal](https://unsplash.com/developers).
* **How it works**: The system searches Unsplash using keywords from the item name/description.
* **Orientation**: All images fetched are automatically filtered for **landscape** orientation to fit the UI.

***

### ⚙️ General Configuration Settings

| Setting                | Description                                                               |
| ---------------------- | ------------------------------------------------------------------------- |
| **Active AI Provider** | Choose which engine will handle requests globally.                        |
| **Model Name**         | Specify a custom model (e.g., `gpt-4o`). Leave blank for system defaults. |
| **API Key Visibility** | Use the 👁️ icon to verify your keys before saving.                       |

***

{% hint style="info" %}
**Performance Tip**: Using `gemini-1.5-flash` or `gpt-4o-mini` provides the fastest response times for menu generation. Only use higher-tier models if you require complex creative writing.
{% endhint %}

{% hint style="danger" %}
**Billing**: Ensure your API keys have active credits on the respective provider's platform to avoid **401 Unauthorized** or **Connection Error** messages.
{% endhint %}