# ZCode

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

Language: en

> Use aicentos in ZCode — connect through custom OpenAI-compatible settings

ZCode supports custom OpenAI-compatible model configurations. Point the Base URL at aicentos and fill in the API Key, and the models aicentos offers become available in ZCode's chats and coding tasks.

## Prerequisites

Create a dedicated key in the aicentos console (naming it `zcode` makes usage easier to track).

## Configuration to fill in

| Field    | Value                                              |
| -------- | -------------------------------------------------- |
| Provider | `OpenAI Compatible`                                |
| API Key  | The key created in the console                     |
| Base URL | `https://aicentos.com/v1`                          |
| Model ID | A model name from the Model Gallery in the console |

## Setup steps

* Open ZCode's settings and go to the model / AI configuration area.
* Find the provider options and choose **OpenAI Compatible** (or "Custom OpenAI").
* Enter the API Key you created in the aicentos console.
* Set the Base URL to: `https://aicentos.com/v1`
* Enter the model ID (see [Supported models](https://docs.aicentos.com/en/billing/models-list)); if the dropdown does not include the target model, type it in manually.
* Save the settings; if a **Verify** button is offered, click it once.

## Test

Start a new conversation or coding task and send a simple prompt; confirm content comes back normally.

## Notes

* The Base URL only goes up to `/v1`; do not extend it to the full `/chat/completions` or `/v1/responses` path.
* If the current version only offers the official built-in models with no editable Base URL, it cannot connect to this gateway directly and you must switch to a client that supports custom endpoints.
* It is a good idea to confirm the visible models with `GET /v1/models` first, then fill in the Model ID in ZCode.
* Requests fail when the account balance runs out; check the balance on the [wallet page](https://aicentos.com/wallet) first.