librechat.yaml. It supports custom OpenAI-compatible endpoints, allowing integration with Ace Data Cloud. This article outlines the configuration process.
Application Process
To integrate Ace Data Cloud into LibreChat, first go to the Ace Data Cloud Console to obtain your API Token for future use.
If you are not logged in or registered, you will be automatically redirected to the login page to invite you to register and log in. After logging in or registering, you will be automatically returned to the current page.
There is a free quota available for first-time applicants, allowing you to experience Ace Data Cloud’s model services for free.
Deploying LibreChat
LibreChat is deployed using Docker Compose. First, prepare the directory and download the official configuration:.env file, generate JWT_SECRET, JWT_REFRESH_SECRET, CREDS_KEY, CREDS_IV, and other security keys using openssl rand -hex 32, and set ALLOW_REGISTRATION as needed.
Configuring Ace Data Cloud
Createlibrechat.yaml and set Ace Data Cloud as a custom OpenAI-compatible endpoint (for complete field descriptions, see the official Custom Endpoints documentation, replacing {token} with your Token):
api service in docker-compose.yml, then start with docker compose up -d:
baseURL:
Selecting Models
The model directory will continue to update. Prefer using the model list automatically loaded by the client; if manual entry is needed, first requestGET https://api.acedata.cloud/v1/models to get the current model ID, then choose based on the context, image, and tool invocation capabilities supported by the client.
Verifying Integration
If you are unsure whether the issue lies with LibreChat or the network, you can first verify the endpoint directly using curl (replace{token} with your Token):
chat.completion object indicates that both the Token and endpoint are ready; if you receive HTTP 403 used_up, it means the Token is valid but the balance is insufficient, and you can recharge at the console.
Advanced: YAML Configuration Tips
librechat.yaml supports multiple endpoint groups, allowing you to use apiKey: "user_provided" so that each user can enter their own Key; titleModel specifies the model for generating conversation titles; dropParams can be used to uniformly remove parameters not supported by the target API. For more details, see librechat.yaml Configuration Explained.
Frequently Asked Questions
Cannot see Ace Data Cloud endpoint after starting
This is usually due to the yaml not being mounted into the container or indentation errors. Check the volumes indocker-compose.yml and verify the yaml indentation.
Getting a 404 error
ThebaseURL may have been written as .../openai/v1 or missing /v1. Change it to https://api.acedata.cloud/v1.
Model dropdown is empty
Iffetch: true but /v1/models fails, change it to fetch: false and manually list default.
Changes to yaml do not take effect
You need to restart the container:docker compose restart api.