> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aleph Alpha

> [!WARNING]
>
> As of Cognigy 2026.6.0, the support for the Completions API for custom LLMs is deprecated. The full removal is planned for Cognigy 2026.24.0.&#x20;

To start using an Aleph Alpha model with Cognigy features, follow these steps:

1. [Add models](#add-models)
2. [Apply the model](#apply-the-model)

## Add models

You can add a model using one of the following interfaces:

* [GUI](#add-models-via-gui)
* [API](#add-models-via-the-api)

### Add models via GUI

You can add a model provided by Aleph Alpha to Cognigy in **Manage > AI & Voice Providers > Language Models**. In **Generative AI Connection**, select an existing connection or click the + button to create one. The connection stores the credentials. To add the model, you'll need the following parameters:

> [tab] Standard model
>
> | Parameter | Type | Description |
> | - | - | - |
> | API Token | Text | Enter the API key that you created in your [Aleph Alpha account](https://docs.aleph-alpha.com/). |
> | Use a base address | Toggle | Activate to enter a base address. Use a base address unless your URL is a fully qualified endpoint URL. |
> | Base address | Text | This parameter appears if **Use a base address** is activated. To control the connection between your clusters and the Aleph Alpha provider, you can route connections through dedicated proxy servers, creating an additional layer of security. To do this, specify the base URL. For example, `https://api.aleph-alpha.com`. |

> [tab] Custom model
>
> | Parameter | Type | Description |
> | - | - | - |
> | Type | List | Select the **Completion** type. |
> | Custom model | Text | Enter the name of the model that you want to use as a custom model. To find model names, refer to the [Aleph Alpha](https://docs.aleph-alpha.com/docs/Deprecated%20Luminous/Deprecated-Luminous/model-card/) documentation. |
> | API Token | Text | Enter the API key that you created in your [Aleph Alpha account](https://docs.aleph-alpha.com/). |
> | Use a base address | Toggle | Activate to enter a base address. Use a base address unless your URL is a fully qualified endpoint URL. |
> | Base address | Text | This parameter appears if **Use a base address** is activated. To control the connection between your clusters and the Aleph Alpha provider, you can route connections through dedicated proxy servers, creating an additional layer of security. To do this, specify the base URL. For example, `https://api.aleph-alpha.com`. |

Apply changes. Check if the connection was set up by clicking **Test Connection**. You can switch generative models at any time using the **Model** list without setting up a new connection. For embedding models, the selection is locked because different embedding models can generate incompatible embeddings for [Knowledge AI](https://docs.cognigy.com/ai/agents/develop/knowledge-ai/overview#embedding-model). To switch an embedding, delete the connection and create a new one.

### Add models via the API

You can add either a standard or custom model using the [Cognigy API POST /v2.0/largelanguagemodels](https://docs.cognigy.com/api-reference/large-language-models/create-a-large-language-model.md) request.
Then, test your connection for the created model via the [Cognigy API POST /v2.0/largelanguagemodels//test](https://docs.cognigy.com/api-reference/large-language-models/test-large-language-model-connection.md).

## Apply the model

To apply a model, follow these steps:

1. In the navigation menu of the project, go to **Manage > AI & Voice Providers > Language Models**.
2. Click **Assignments**.
3. Find the capability that should use the model. Capabilities are grouped under **Runtime Features**, **Design-Time**, and **Knowledge**. For Knowledge AI, select a model for **Knowledge Search** and **Answer Extraction**. To find models that support these features, refer to [Model support by feature](https://docs.cognigy.com/ai/agents/develop/gen-ai-and-llms/model-support-by-feature.md).
4. Select the model in the capability's list. If no model in the project supports the capability, **None** is selected and the list shows **No model in this project supports this capability**.
5. Click **Save changes**.

## More information

* [Other LLM operations](https://docs.cognigy.com/ai/agents/develop/gen-ai-and-llms/other-operations.md)
* [Large language models (LLMs)](https://docs.cognigy.com/ai/agents/develop/gen-ai-and-llms/llms)
* [All LLM providers](https://docs.cognigy.com/ai/agents/develop/gen-ai-and-llms/providers/all-providers)
* [Model support by feature](https://docs.cognigy.com/ai/agents/develop/gen-ai-and-llms/model-support-by-feature.md)
