AIRouter

LangChain · ChatOpenAI

LangChain и AIRouter: OpenAI-compatible base_url

LangChain можно подключать к AIRouter через ChatOpenAI, если указать AIRouter API‑ключ, base_url/baseURL и model id из каталога.

Прямая настройка Документация LangChain: ChatOpenAI

Короткий ответ

Да, LangChain можно подключить к AIRouter через ChatOpenAI.

В Python используйте base_url, в JavaScript — configuration.baseURL.

Основные параметры: https://api.ai-router.app/v1, AIROUTER_API_KEY и <AIROUTER_MODEL>.

Начните с одного вызова модели, затем подключайте chains или agents.

Что понадобится

Начните с регистрации AIRouter, проверьте модели и цены, пополните баланс от 100 ₽, а базовый OpenAI‑compatible quickstart держите под рукой в документации.

  • AIRouter аккаунт, подтверждённый email и положительный баланс.
  • LangChain в версии с поддержкой OpenAI-compatible/custom provider.
  • AIRouter API‑ключ, сохранённый как секрет.
  • Model id из публичного каталога AIRouter.

Quick test

Быстрая проверка перед рабочим сценарием

Начните с пополнения от 100 ₽ и короткого тестового запроса.

  1. Создайте аккаунт AIRouter.Создайте аккаунт и откройте кабинет.
  2. Выберите модель.Возьмите id из публичного каталога и начните с короткого текстового prompt.
  3. Пополните баланс от 100 ₽.Пополните баланс в кабинете и проверяйте итоговый статус в истории платежей.
  4. Отправьте короткий запрос.Например: «Проверь подключение и ответь коротко», затем проверяйте более сложные agent flows.

Пошаговая настройка

  1. Установите LangChain OpenAI packageИспользуйте пакет вашей платформы: Python или JavaScript.
  2. Передайте base_url/baseURLAIRouter endpoint указывается как base_url в Python или configuration.baseURL в JS.
  3. Проверьте цепочку маленьким promptНачните с одного вызова ChatOpenAI, затем подключайте chains, agents или retrievers.

Пример конфига

В публичных примерах используйте <AIROUTER_API_KEY>, <AIROUTER_MODEL> или переменную AIROUTER_API_KEY.

Python

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    api_key="<AIROUTER_API_KEY>",
    base_url="https://api.ai-router.app/v1",
    model="<AIROUTER_MODEL>",
)

JavaScript / TypeScript

import { ChatOpenAI } from "@langchain/openai";

const llm = new ChatOpenAI({
  apiKey: process.env.AIROUTER_API_KEY,
  model: "<AIROUTER_MODEL>",
  configuration: { baseURL: "https://api.ai-router.app/v1" },
});

Проверка

  • Отправьте короткий prompt без доступа к приватным данным.
  • Проверьте, что endpoint указывает на https://api.ai-router.app/v1.
  • Если клиент сообщает об ошибке модели, auth или баланса, сначала проверьте model id, API‑ключ и состояние платежа.

Частые ошибки

  • Указать корень https://ai-router.app вместо канонического API base URL.
  • Скопировать реальный API‑ключ в публичный конфиг.
  • Использовать model id, которого нет в каталоге AIRouter.
  • Включить сложные agent tools до проверки простого ответа.

FAQ

Какой класс использовать?

ChatOpenAI из langchain_openai для Python или @langchain/openai для JavaScript.

Где указать endpoint?

В Python — base_url, в JavaScript — configuration.baseURL.

Можно ли использовать agents?

Можно после проверки конкретной модели, tool calling и нужного workflow.

Ограничения

LangChain wrappers быстро меняются; сверяйте параметры с версией пакета.

Для публичных примеров используйте переменную AIROUTER_API_KEY.

Tool calling и structured output зависят от выбранной модели и режима клиента.

Официальные источники

Документация LangChain: ChatOpenAI

  • Официальная документация LangChain ChatOpenAI подтверждает настройку OpenAI-compatible клиента с base_url/baseURL.

← Все инструкции · Модели и цены · Начать