Skip to main content
LibreChat - це високо налаштовуваний відкритий AI-клієнт, який використовує librechat.yaml для опису постачальників послуг, моделей та правил маршрутизації. Він підтримує налаштовані кінцеві точки, сумісні з OpenAI, тому може підключатися до Ace Data Cloud. У цій статті описано процес налаштування.

Процес подачі заявки

Щоб підключити Ace Data Cloud у LibreChat, спочатку перейдіть до консолі Ace Data Cloud, щоб отримати ваш API Token, зберігши його для подальшого використання. Отримання Ace Data Cloud API Key Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти. Після входу або реєстрації ви автоматично повернетеся на цю сторінку. При першій подачі заявки вам буде надано безкоштовний ліміт, щоб ви могли безкоштовно випробувати модельні послуги Ace Data Cloud.

Розгортання LibreChat

LibreChat розгортається за допомогою Docker Compose, спочатку підготуйте каталог і завантажте офіційну конфігурацію:
У файлі .env за допомогою openssl rand -hex 32 згенеруйте JWT_SECRET, JWT_REFRESH_SECRET, CREDS_KEY, CREDS_IV та інші безпечні ключі, а також налаштуйте ALLOW_REGISTRATION за потреби.

Налаштування Ace Data Cloud

Створіть librechat.yaml, додайте Ace Data Cloud як налаштовану кінцеву точку, сумісну з OpenAI (повний опис полів див. в офіційній документації Custom Endpoints, замініть {token} на ваш Token):
У файлі docker-compose.yml під сервісом api підключіть цей файл до контейнера, а потім запустіть docker compose up -d:
Зверніть увагу на правила шляху baseURL:

Вибір моделі

Каталог моделей буде постійно оновлюватися. Переважно використовуйте список моделей, який автоматично завантажується клієнтом; якщо потрібно заповнити вручну, спочатку запитайте GET https://api.acedata.cloud/v1/models, щоб отримати поточний ID моделі, а потім виберіть відповідно до можливостей контексту, зображення та викликів інструментів, підтримуваних клієнтом.

Перевірка інтеграції

Якщо ви не впевнені, чи проблема в LibreChat, чи в мережі, ви можете спочатку перевірити кінцеву точку безпосередньо за допомогою curl (замініть {token} на ваш Token):
Повернення об’єкта chat.completion, сумісного з OpenAI, свідчить про те, що Token та кінцева точка готові; якщо повертається HTTP 403 used_up, це означає, що Token дійсний, але баланс недостатній, поповніть його в консолі.

Розширене: поради з налаштування yaml

librechat.yaml підтримує кілька груп кінцевих точок, ви можете використовувати apiKey: "user_provided", щоб кожен користувач міг вказати свій ключ; titleModel вказує модель для генерації заголовка діалогу; dropParams може одночасно видаляти параметри, які не підтримуються цільовим API. Детальніше див. детальний опис налаштування librechat.yaml.

Поширені запитання

Після запуску не видно кінцеву точку Ace Data Cloud

Зазвичай це означає, що yaml не підключено до контейнера або є помилка в відступах. Перевірте volumes у docker-compose.yml та перевірте відступи в yaml.

Показує 404

baseURL написано як .../openai/v1 або пропущено /v1. Змініть на https://api.acedata.cloud/v1.

Випадаючий список моделей порожній

fetch: true, але /v1/models не вдалося, змініть на fetch: false і вручну перераховуйте default.

Зміни в yaml не діють

Потрібно перезапустити контейнер: docker compose restart api.

Дізнайтеся більше