Conecte o LibreChat ao CheapTokens: endpoint personalizado no librechat.yaml

Seu LibreChat está rodando, mas o menu de modelos só mostra o que veio de fábrica. Para adicionar o CheapTokens, você escreve uma entrada endpoints.custom em librechat.yaml: um nome, a URL base https://api.cheaptokens.dev/v1, a chave como variável de ambiente e uma lista de ids de modelos. Reinicie o contêiner, e um endpoint "CheapTokens" aparece no menu.

Os nomes de campo abaixo vêm da referência de endpoints personalizados do LibreChat (branch "Latest (dev)" da documentação, verificada em 30 de outubro de 2026). A página não traz número de versão, então se sua instalação for mais antiga e algum campo se comportar de forma diferente, compare com a documentação da sua versão. O lado da API é o da nossa documentação: formato OpenAI Chat Completions, um saldo para todos os modelos.

O que a entrada precisa#

Quatro campos são obrigatórios, e cada um tem uma função simples:

• name — como o endpoint é chamado no menu.
• apiKey — a chave. A documentação recomenda uma referência como ${VAR} em vez da chave em si, para que o segredo fique fora do YAML.
• baseURL — para onde vão as requisições: https://api.cheaptokens.dev/v1.
• models.default — a lista de ids de modelos exibidos no menu.

Dois campos opcionais valem a pena ser definidos. titleConvo: true permite que o LibreChat nomeie seus chats (os títulos são criados a menos que seja false), e modelDisplayLabel é o rótulo ao lado das respostas (o padrão é "AI"). models.fetch é false por padrão, então o LibreChat não vai pedir à API uma lista de modelos; o menu vem de models.default. É por isso que os ids abaixo estão escritos por extenso.

Conecte em três passos#

services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here

endpoints:
  custom:
    - name: 'CheapTokens'
      apiKey: '${CHEAPTOKENS_API_KEY}'
      baseURL: 'https://api.cheaptokens.dev/v1'
      models:
        default:
          - 'zai-org/GLM-5.3-Flash'
          - 'deepseek-ai/DeepSeek-V4-Flash-0731'
          - 'MiniMaxAI/MiniMax-M2.7'
      titleConvo: true
      modelDisplayLabel: 'CheapTokens'

services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

docker compose up -d

Abra o LibreChat no navegador, inicie um novo chat e escolha CheapTokens no menu de endpoints. Os três modelos estão na lista. Envie "Diga oi em uma frase" e você deve receber uma resposta. Se não receber, pule para a última seção.

Três modelos em um menu#

Esta é a parte que torna um chat auto-hospedado vantajoso. Digamos que você o rode para uma equipe pequena. A maioria das perguntas é do dia a dia: reescrever este e-mail, explicar este erro. Para essas, zai-org/GLM-5.3-Flash basta, com janela de contexto de 390K e até 8.192 tokens por resposta. Quando alguém cola um documento longo e quer uma resposta longa, troca o mesmo chat para deepseek-ai/DeepSeek-V4-Flash-0731 (contexto de 380K, até 32.768 tokens por resposta). MiniMaxAI/MiniMax-M2.7 (contexto de 180K) é a terceira opinião quando duas respostas divergem. Sem segunda assinatura, sem segunda chave: os três são cobrados de um único saldo.

Quanto custa esse chat? Considere uma equipe de cinco pessoas enviando 200 mensagens por dia, cada uma com cerca de 3.000 tokens de entrada (o histórico cresce) e recebendo cerca de 500 tokens de volta:

Na tabela, o preço de cada modelo para essas 200 requisições é contado com entrada e saída juntas, e no total sai mais barato que o OpenRouter. Escolha a linha que corresponde ao seu uso e compare com a página de preços.

Se o endpoint não aparecer ou responder com erro#

A maioria dos problemas é uma de três coisas. Escolha a que corresponde ao que você vê:

Assim que a primeira mensagem passar, você pode adicionar mais ids a models.default sempre que quiser outro modelo no menu. Prefere outro front end? A mesma ideia, uma URL base mais uma chave, está em Conectar o Open WebUI ao CheapTokens, e o panorama geral está em API compatível com OpenAI: o que é base_url. Os modelos em si estão na página do GLM.