← Документация для разработчиков

Интеграция

LangChain через aictrlx

ChatOpenAI из LangChain работает с aictrlx, если указать base_url его API: цепочки и агенты на Python на любой модели каталога, с вызовом инструментов и структурированным ответом.

Настройка

Сохраните ключ в переменной окружения

Все примеры ниже читают ключ из AICTRLX_API_KEY, поэтому он не попадает в код.

Shell
export AICTRLX_API_KEY="aictrlx_live_..."
Установка
pip install langchain-openai
Python
import os

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="auto",
    base_url="https://aictrlx.ru/v1",
    api_key=os.environ["AICTRLX_API_KEY"],
)
reply = llm.invoke("Explain vector databases in two sentences.")
print(reply.content)
print(reply.response_metadata.get("model_name"))  # the model that actually answered

Какую модель указать

  • auto — aictrlx сам выбирает модель для каждого запроса по его типу (код, рассуждение, короткий ответ).
  • Для вызова инструментов и ответа в JSON выберите на странице моделей модель, которая их поддерживает.

Модели и цены →

Сколько это стоит

Оплачиваются токены, которые модель читает и пишет, по ценам за 1 млн токенов со страницы моделей, в рублях: сначала из того, что включено в подписку, сверх — с баланса.

Каждый запрос с моделью, токенами и стоимостью виден в журнале запросов в кабинете.

Если что-то не работает

  • 401 с invalid_api_key или missing_api_key: инструмент не передаёт ключ или это не действующий ключ aictrlx_live_.... Создайте новый на странице «API-ключи».
  • 404 с model_not_found: имя модели — не режим маршрутизации (auto, fast, smart, coding) и не id со страницы моделей.
  • 403 с model_not_allowed: ключ ограничен частью моделей; разрешите эту модель в настройках ключа.
  • 429: слишком много запросов в минуту (rate_limit_exceeded) или закончилась квота либо бюджет (monthly_quota_exceeded и другие).

Все ошибки и лимиты →

Другие интеграции