diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/index.mdx b/content/docs/configuration/librechat_yaml/ai_endpoints/index.mdx index 87e51cbf3..9cf4c0873 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/index.mdx +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/index.mdx @@ -66,6 +66,7 @@ OPENAI_API_KEY=user_provided + diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.de.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.de.json index 332e7c704..aabbf2e7a 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.de.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.de.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.es.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.es.json index 3e2bbff75..b70b9a089 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.es.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.es.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.fr.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.fr.json index 757c760a5..bcb7f2e6d 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.fr.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.fr.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.id.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.id.json index 5edda54f1..d7ba81c75 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.id.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.id.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.it.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.it.json index 5edda54f1..d7ba81c75 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.it.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.it.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ja.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ja.json index 0811cb637..9f89b4a49 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ja.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ja.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.json index c46fe3dfd..51c957dd3 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ko.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ko.json index a514bbd3b..6ae6133fa 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ko.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.ko.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.nl.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.nl.json index d6e2495c9..1e609f564 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.nl.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.nl.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pl.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pl.json index d3181723e..8ac01f93d 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pl.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pl.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pt-BR.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pt-BR.json index 3e2bbff75..b70b9a089 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pt-BR.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.pt-BR.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.tr.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.tr.json index 2d2557db3..01cbeab5a 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.tr.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.tr.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.vi.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.vi.json index 46539e0db..309b75d6f 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.vi.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.vi.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.zh.json b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.zh.json index 477cd7759..d17c65c1b 100644 --- a/content/docs/configuration/librechat_yaml/ai_endpoints/meta.zh.json +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/meta.zh.json @@ -26,6 +26,7 @@ "portkey", "shuttleai", "togetherai", + "topxai", "truefoundry", "vllm", "vultrcloudinference", diff --git a/content/docs/configuration/librechat_yaml/ai_endpoints/topxai.mdx b/content/docs/configuration/librechat_yaml/ai_endpoints/topxai.mdx new file mode 100644 index 000000000..6598ab74e --- /dev/null +++ b/content/docs/configuration/librechat_yaml/ai_endpoints/topxai.mdx @@ -0,0 +1,43 @@ +--- +title: TopxAI +icon: Plug +description: Configure TopxAI as a custom endpoint in LibreChat. +--- + +TopxAI serves compatible Claude, GPT, Grok, GLM, Kimi and DeepSeek chat models through one OpenAI-compatible endpoint with one prepaid key. Every model has a fixed USD price per route, listed at [api.topxai.xyz/pricing](https://api.topxai.xyz/pricing). + +## Get an API key + +Sign in at [api.topxai.xyz](https://api.topxai.xyz/) and create a key on the **Keys** page; pick **Auto route** so one key covers the available chat models. Add it to your `.env` file: + +```bash filename=".env" +TOPXAI_API_KEY=sk-your-key-here +``` + +## Configuration + +Add the endpoint under `endpoints.custom` in your `librechat.yaml`: + +```yaml filename="librechat.yaml" +endpoints: + custom: + - name: "TopxAI" + apiKey: "${TOPXAI_API_KEY}" + baseURL: "https://api.topxai.xyz/v1" + models: + default: ["claude-sonnet-5-5", "gpt-6.2-astra", "gpt-6.2-sol", "grok-4.7", "kimi-k3.1-pro-Abliterated", "deepseek-flash-Abliterated"] + fetch: false + titleConvo: true + titleModel: "gpt-6.2-sol" + modelDisplayLabel: "TopxAI" +``` + +Choose text models available to your key and set `titleModel` to one of them. Keeping `fetch: false` limits the picker to that list. A key with access to several TopxAI routes can also see image, video and System One models in `/v1/models`, which LibreChat's OpenAI-compatible chat configuration cannot use for text conversations. + +To let each user supply their own key through the LibreChat UI instead of reading one from `.env`, set `apiKey: "user_provided"`. + +## Notes + +- Model ids are the plain names from the [price list](https://api.topxai.xyz/api/pricing) (`claude-sonnet-5-5`, `gpt-6.2-sol`, `grok-4.7` and so on), with no provider prefix. +- A key can be pinned to one route (for example the Claude route, `claude-shared`) or set to Auto route; a model the key's route does not sell answers `403` with "Model is not available on this API key route". See [routes and prices](https://api.topxai.xyz/docs/routes-and-the-auto-route). +- This example uses Chat Completions. To use Claude through the native Messages API, configure a separate [Anthropic custom endpoint](/docs/configuration/librechat_yaml/object_structure/custom_endpoint#provider) with `provider: anthropic`, `baseURL: "https://api.topxai.xyz"` and an explicit list of Claude model IDs. See the [TopxAI API reference](https://api.topxai.xyz/docs/api-reference).