Helicone
Configure Helicone's AI Gateway as a custom endpoint in LibreChat.
Archived documentation
You are reading the frozen documentation for v0.8.7, which is no longer maintained. Go to the latest docs.
Helicone is an AI gateway that routes requests to models from OpenAI, Anthropic, Google, Meta, Mistral, and other providers through a single OpenAI-compatible endpoint, with built-in request logging and usage analytics.
Get an API key
Create an account at helicone.ai and generate a key from Settings → API Keys. Add it to your .env file:
HELICONE_KEY=your-api-keyMake sure your account has credits, otherwise model requests will fail.
Configuration
Add the endpoint under endpoints.custom in your librechat.yaml:
- name: "Helicone"
apiKey: "${HELICONE_KEY}"
baseURL: "https://ai-gateway.helicone.ai"
headers:
x-librechat-body-parentmessageid: "{{LIBRECHAT_BODY_PARENTMESSAGEID}}"
models:
default: ["gpt-4o-mini", "claude-4.5-sonnet", "llama-3.1-8b-instruct", "gemini-2.5-flash-lite"]
fetch: true
titleConvo: true
titleModel: "gpt-4o-mini"
modelDisplayLabel: "Helicone"
iconURL: "https://marketing-assets-helicone.s3.us-west-2.amazonaws.com/helicone.png"Notes
- With
fetch: true, LibreChat loads the full model list from Helicone, so thedefaultarray is only the initial selection. Browse everything available in the Helicone model library. - The
x-librechat-body-parentmessageidheader passes each request's parent message ID to Helicone so logs can be grouped by conversation. - Set rate limits, caching policies, and review usage from the Helicone dashboard.