LibreChat
LibreChat adiciona UberLLM como um endpoint personalizado em librechat.yaml.
Antes de começar
- Uma conta UberLLM com crédito, e uma API key de
Dashboard → Chaves (
ull_...).
1. Adicione a chave a .env
UBERLLM_API_KEY=ull_your-key-here
2. Adicione o endpoint a librechat.yaml
Se o arquivo já tiver uma lista endpoints.custom, cole apenas a entrada - name: nela, com a mesma indentação.
version: 1.3.18
endpoints:
custom:
- name: "UberLLM"
apiKey: "${UBERLLM_API_KEY}"
baseURL: "https://api.uberllm.dev/v1"
models:
default: ["deepseek/deepseek-v4.1-flash", "z-ai/glm-5.2", "moonshotai/kimi-k3", "google/gemini-2.5-flash"]
fetch: true
titleConvo: true
titleModel: "qwen/qwen3-vl-235b-a22b-instruct"
modelDisplayLabel: "UberLLM"
iconURL: "https://uberllm.dev/apple-icon"
headers:
X-Title: "LibreChat"
fetch: truecarrega todos os modelos de chat de/v1/models(cerca de 250). Para um menu curto, definafetch: falsee liste os modelos que você deseja emdefault.titleModelé um modelo rápido que responde sem uma etapa de raciocínio, então os títulos dos chats voltam curtos.- Para permitir que cada usuário insira sua própria chave na tela do LibreChat, escreva
apiKey: "user_provided"(sem${}).
3. Monte o arquivo (Docker)
Crie docker-compose.override.yml ao lado de docker-compose.yml:
services:
api:
volumes:
- type: bind
source: ./librechat.yaml
target: /app/librechat.yaml
Em seguida, reinicie: docker compose down && docker compose up -d.
Modelos recomendados
Verificado em 30 de outubro de 2026: cada um transmitiu uma resposta via UberLLM.
| ID do modelo | Contexto | Observações |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | Rápido; raciocina antes de responder |
z-ai/glm-5.2 |
1,048,576 | |
moonshotai/kimi-k3 |
1,048,576 | Raciocina antes de responder |
google/gemini-2.5-flash |
1,048,576 | Lê imagens |
Erros comuns
| O que você vê | Causa e solução |
|---|---|
| LibreChat fecha ao iniciar | librechat.yaml falhou na validação. Execute docker compose logs api na linha. |
| Nenhum endpoint UberLLM no menu | Um dos três passos está faltando: a chave .env, a entrada yaml, ou a montagem. |
402 |
Seu saldo UberLLM está vazio. Adicione crédito em Painel → Créditos. |
404 model_not_found |
Um ID de modelo em default está digitado incorretamente. Copie os IDs do catálogo. |