LibreChat setup

Add Asterionyx to LibreChat as a custom OpenAI-compatible endpoint in librechat.yaml.

This page describes how to point LibreChat at Asterionyx’s Chat Completions endpoint. It is a setup guide, not a partnership or endorsement.

Before you startYou need an Asterionyx account, a customer API key, the Base URL, a published Model ID from the live catalog, and enough Credits for a test request.
Last verified 2026-08-27Checked against official documentation on 2026-08-27. A clean third-party install was not re-run in this environment. Official source: LibreChat custom endpoints.
Base URL
https://api.a.eus/v1

librechat.yaml excerpt

Last verified against LibreChat custom endpoint documentation on 2026-08-27. Restart after changing the file. A clean LibreChat install was not run in this environment.

librechat.yaml
endpoints:
  custom:
    - name: "Asterionyx"
      apiKey: "${ASTERIONYX_API_KEY}"
      baseURL: "https://api.a.eus/v1"
      models:
        default: ["<MODEL_ID_FROM_CATALOG>"]
        fetch: true
      titleConvo: true
      titleModel: "<MODEL_ID_FROM_CATALOG>"
      modelDisplayLabel: "Asterionyx"
  1. Open librechat.yaml

    In your LibreChat deployment, add a custom endpoint entry under endpoints.custom.

  2. Set baseURL

    Set baseURL to the Asterionyx Base URL shown below.

  3. Store the API key safely

    Put your Asterionyx key in an environment variable and reference it from librechat.yaml instead of writing the key directly into the file.

  4. List the Model IDs

    Add the published Asterionyx model IDs you want to expose.

  5. Restart LibreChat

    Restart the LibreChat server or container, then choose Asterionyx from the endpoint selector.

TipFor team deployments, keep the key in server-side environment variables or use LibreChat's user-provided key mode if each user should bring their own Asterionyx key.

Troubleshooting

401 / unauthorized

Recopy the API key from the portal. Do not use a placeholder or a key from another account.

402 / insufficient Credits

Create a recharge in the portal. The same API key and Base URL continue to work after Credits are added.

Unknown model

Copy a published public model ID from the live Model Catalog instead of typing a remembered name.

Related guides