langchain-topxai

LangChain chat model for TopxAI, an API gateway that serves Claude, GPT, Grok, GLM, Kimi and DeepSeek models through one OpenAI-compatible endpoint at fixed USD prices per route.

Installation

pip install -U langchain-topxai

Create a key at https://ai.topxea.com/keys and set it:

export TOPXAI_API_KEY="your-api-key"

Chat models

from langchain_topxai import ChatTopxAI

model = ChatTopxAI(model="kimi-k3.1-pro")
model.invoke("Sing a ballad of LangChain.")

model takes any text model id from https://ai.topxea.com/pricing, for example claude-sonnet-5-5, gpt-6.1-sol, grok-4.7, kimi-k3.1-pro or deepseek-flash-Abliterated. ChatTopxAI builds on langchain-openai's BaseChatOpenAI and always calls the Chat Completions API: streaming, async calls, tool calling, structured output and token usage work as they do there. For TopxAI's Responses API, use ChatOpenAI from langchain-openai with base_url="https://ai.topxea.com/v1" and use_responses_api=True.

When a model returns reasoning text in the Chat Completions reasoning_content field, ChatTopxAI puts it in additional_kwargs["reasoning_content"], also when streaming:

msg = ChatTopxAI(model="deepseek-flash-Abliterated").invoke("What is 17 * 3?")
msg.additional_kwargs.get("reasoning_content")

Kimi K3.1 Pro uses always-on reasoning; omit sampling controls such as temperature. See its model guide for supported parameters.

with_structured_output uses JSON Schema by default (method="json_schema", as in ChatOpenAI). Keep the default for the Claude models (claude-sonnet-5-5, claude-opus-5-5, claude-fable-5-1): they do not accept a forced tool call, so method="function_calling" fails for them.

The catalogue was checked on 2026-10-25. kimi-k3, deepseek-flash and deepseek-v4-pro are retired and are rejected; they are not aliases. GLM-5.3-Abliterated and deepseek-flash-Abliterated are private deployments. Check the live catalogue and the model page for current capabilities and prices; support varies by model.

Configuration

Links

• Guide: https://ai.topxea.com/docs/use-topxai-with-langchain
• Models and prices: https://ai.topxea.com/pricing
• API reference: https://ai.topxea.com/docs/api-reference

Development

make tests              # unit tests, no network
make integration_tests  # LangChain standard integration tests, needs TOPXAI_API_KEY
make lint type

MIT licensed. Maintained by TopXEA, the operator of TopxAI.