Настройка LangChain
Подключите LangChain ChatOpenAI к GonkaGate.
Подключите LangChain к GonkaGate, не меняя wrapper: оставьте ChatOpenAI и замените только API-ключ, base URL и model ID.
Сначала проверьте один запрос. Tool calling, structured outputs и более крупные agent flow проверяйте только после того, как базовое подключение заработало.
Проверьте подключение одним запросом
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="qwen/qwen3-235b-a22b-instruct-2507-fp8",
api_key=os.environ["GONKAGATE_API_KEY"],
base_url="https://api.gonkagate.com/v1",
)
response = llm.invoke("Return exactly: LangChain connected")
print(response.content)Если в ответ приходит LangChain connected, значит ChatOpenAI уже ходит в GonkaGate. Перед рабочим трафиком замените пример model ID на актуальное значение из GET /v1/models.
Что менять в конфиге
- Оставьте LangChain
ChatOpenAIна месте. - Меняйте только API-ключ, base URL и model ID.
- Ваши текущие вызовы
invoke()иstream()вокруг этого wrapper можно оставить без изменений. - Tool calling, structured outputs и более крупный agent flow проверяйте только после базового подключения.
- LangGraph, embeddings, retrievers и более широкая архитектура LangChain вне рамок этого гайда.
Частые первые ошибки
| Если видите | Обычно это значит | Что делать |
|---|---|---|
401 invalid_api_key | API-ключ неверный или не загружен в runtime | Проверьте GONKAGATE_API_KEY, загрузку секрета и состояние ключа на странице Аутентификация и API-ключи |
404 model_not_found | Model ID устарел или неверен | Возьмите model ID из GET /v1/models |
429 insufficient_quota | Предоплаченного USD-баланса недостаточно для этого запроса | Сначала пополните баланс или уменьшите стоимость запроса |
429 rate_limit_exceeded | Запрос уперся в throttling | Учитывайте Retry-After и добавьте bounded backoff |
Если базовый запрос работает, а следующий шаг в LangChain всё равно падает, сначала убедитесь, что этот шаг всё ещё идёт через ChatOpenAI, а уже потом разбирайте внутренности LangChain.
См. также
- Гайд по миграции с OpenAI на GonkaGate для более широкой миграции OpenAI-совместимого приложения
- POST /v1/chat/completions — Создать chat completion для точного контракта запроса и ответа за
ChatOpenAI - Обработка ошибок API для правил retry и разбора ошибок после того, как подключение заработало
Была ли эта страница полезной?