aicentosZCode
Use aicentos in ZCode — connect through custom OpenAI-compatible settings
Last updated:
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); 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/completionsor/v1/responsespath. - 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/modelsfirst, then fill in the Model ID in ZCode. - Requests fail when the account balance runs out; check the balance on the wallet page first.