# Kilo

Source: https://docs.aicentos.com/en/clients/kilo

Language: en

> Use aicentos in Kilo through a custom OpenAI-compatible provider

Kilo supports custom providers, so chat and agent requests can be pointed at any OpenAI-compatible endpoint. Just add a Custom Provider in the settings and fill in aicentos's Base URL and key.

## Prerequisites

First create a dedicated key for Kilo on the console's "API Keys" page (naming it `kilo` is a good idea).

* Console: [https://aicentos.com](https://aicentos.com)
* Create a key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Top up when the balance runs out: [https://aicentos.com/wallet](https://aicentos.com/wallet)

## Configuration to fill in

| Field              | Value                                              |
| ------------------ | -------------------------------------------------- |
| Provider ID / name | Custom, e.g. `aicentos`                            |
| API type           | OpenAI Compatible (Chat Completions)               |
| Base URL           | `https://aicentos.com/v1`                          |
| API Key            | The key created in the console                     |
| Model ID           | A model name from the Model Gallery in the console |
| Context Window     | Match the chosen model                             |
| Max Output Tokens  | Match the chosen model                             |

## Setup steps

* Open Kilo's settings panel (gear icon).
* Go to **Providers**, scroll to the very bottom of the list and choose **Custom provider**.
* Fill in the Provider ID and Display name freely, e.g. `aicentos`.
* Choose **OpenAI Compatible (Chat Completions)** as the API type.
* Enter `https://aicentos.com/v1` as the Base URL.
* Enter the API Key created in the console.
* Add the Model ID manually, using the model name from the console.
* After saving, select a model under this provider in the model picker.

## Test

After saving the settings, start a new task and send a simple prompt as a lightweight test; once content comes back normally, move on to real Agent-mode work.

## Notes

* If the gateway does not offer a `/v1/models` listing endpoint, automatic model detection fails; just fill in the Model ID manually.
* The Base URL only goes up to `https://aicentos.com/v1`; do not extend it to the full `/v1/chat/completions`.
* Set Context Window and Max Output Tokens explicitly for custom models; leaving them out makes the context length treated as 0, which breaks auto-compaction and lets conversations grow without bound.
* Official documentation: [https://kilo.ai/docs/ai-providers/openai-compatible](https://kilo.ai/docs/ai-providers/openai-compatible)
* More details on the docs site: [https://docs.aicentos.com](https://docs.aicentos.com)