Draai LobeChat op een aangepast OpenAI-compatibel endpoint.
Updated 2026-07-29
De providermodule van LobeChat accepteert elke OpenAI-compatibele dienst: maak een aangepaste provider aan met het SDK-type OpenAI, stel het endpoint in op https://api.apisrouter.com/v1, plak één sleutel, en haal de modellijst op. Claude-, GPT-, Gemini- en DeepSeek-ID's komen terecht in de modelkiezer van elke assistent.
Snel antwoord: één aangepaste provider, één endpoint, één sleutel.
Open de instellingen van LobeChat en ga naar de sectie AI-serviceprovider (gelabeld als AI Service Provider of Language Model, afhankelijk van de release). Sinds de module voor providerbeheer in v1.44 landde, kun je een aangepaste provider aanmaken in plaats van mee te liften op de ingebouwde OpenAI-vermelding: voeg een provider toe, geef hem een ID en een weergavenaam (apisrouter / APIsRouter), kies het SDK-type OpenAI, en vul dan de API-sleutel en de endpoint-proxy-URL in met https://api.apisrouter.com/v1. Gebruik in de modellijst van de provider de actie fetch-models om elk ID op te halen dat het endpoint via /v1/models bedient, schakel de gewenste ID's in, en draai de ingebouwde connectiviteitscontrole. Vanaf dat moment kan elke assistent of elk gesprek die ID's selecteren uit de modelkiezer. Het project leeft nu op lobehub/lobehub op GitHub (de repo-naam lobe-chat verwijst daarnaartoe door), en menulabels verschuiven tussen releases, dus behandel de flow — providervermelding, SDK-type, URL, sleutel, fetch — als het stabiele deel in plaats van de exacte bewoording.
Provider ID: apisrouter
Provider Name: APIsRouter
SDK Type: OpenAI
API Key: sk-YOUR-APISROUTER-KEY
API Proxy URL: https://api.apisrouter.com/v1
Model List → Fetch models → enable ids → checkHoe LobeChat verzoeken routeert naar een provider.
LobeChat (rond de 80K GitHub-sterren, nu onder de naam LobeHub) is een van de meest gedeployde open-source chatframeworks: een gepolijste webclient, assistenten met hun eigen prompts en modellen, een pluginsysteem, en kennisbankfuncties, inzetbaar in een browsersessie of self-hosted met een database. Elke providervermelding beschrijft waar verzoeken naartoe gaan en welk SDK-dialect gesproken moet worden. Een aangepaste provider op het OpenAI-SDK-type stuurt standaard chat-completions-verzoeken naar je proxy-URL met het model-ID als platte string, precies de vorm die een gateway met meerdere leveranciers verwacht. Eén vermelding draagt daarom de hele catalogus: assistenten kunnen claude-sonnet-4-6 vastpinnen voor zorgvuldig werk terwijl snelle gesprekken gemini-3.5-flash draaien, zonder ergens een tweede account. De endpoint-URL heeft één gedocumenteerde nuance die het waard is om te citeren: of de URL een /v1-suffix nodig heeft, hangt af van de dienst erachter. LobeChat voegt routepaden zoals /chat/completions toe aan de base die je opgeeft, dus voor APIsRouter is de juiste waarde https://api.apisrouter.com/v1. Het gedocumenteerde symptoom van een ontbrekend suffix is dat het model een leeg antwoord teruggeeft bij de test; zie je dat, voeg dan /v1 toe en probeer opnieuw.
Self-hosting: het pad via omgevingsvariabelen.
Als je LobeChat zelf deployt, kan dezelfde routering in de container worden meegeleverd in plaats van in de UI aangeklikt te worden. Het klassieke paar overschrijft de ingebouwde OpenAI-provider: OPENAI_API_KEY neemt de gatewaysleutel en OPENAI_PROXY_URL neemt https://api.apisrouter.com/v1. Elke gebruiker van die deployment erft dan het endpoint zonder de instellingen aan te raken. Modelzichtbaarheid wordt geregeld met de model-list-syntax: OPENAI_MODEL_LIST accepteert +id om toe te voegen, -id om te verbergen, en id=Weergavenaam om te hernoemen, met komma-gescheiden vermeldingen. De waarde beginnen met -all wist de ingebouwde lijst zodat alleen je expliciete ID's verschijnen, wat de schone vorm is voor een gecureerde deployment. Nieuwere serverbuilds documenteren ook een familie CUSTOM_PROVIDER_* (count, id, name, type, base URL, keys) voor het declareren van volledige aangepaste providers ten tijde van deployment, wat overeenkomt met wat de UI-module doet. Controleer de actuele referentie voor omgevingsvariabelen voor jouw versie voordat je erop vertrouwt, aangezien dit oppervlak nieuwer is dan het paar OPENAI_* en nog in ontwikkeling is.
OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-proModellen kiezen voor assistenten.
Omdat alle assistenten via één sleutel factureren, is modelvergelijking een wijziging in de assistent-instellingen. Pin twee kandidaten op twee gedupliceerde assistenten, draai je echte prompts een week lang, en lees de uitgaven per model in de APIsRouter-console naast de antwoordkwaliteit die je hebt waargenomen.
- Assistenten zijn modelpins per rol. Een schrijfassistent op claude-sonnet-4-6, een snelantwoord-assistent op claude-haiku-4-5-20251001, en een onderzoeksassistent op gpt-5.5 bestaan allemaal naast elkaar achter één providervermelding.
- gemini-3.5-flash is de responsiviteitskeuze voor het standaard gespreksmodel; de meeste beurten in een chatframework zijn kort en snelle modellen houden de UI instant aanvoelen.
- deepseek-v4-pro verdient een plek voor lange meertalige gesprekken en zwaar samenvatten, waar zijn langecontextgedrag per uitgegeven token de trekpleister is.
- Vision-gesprekken hebben een vision-capabel ID nodig met de capaciteit ingeschakeld in de modelconfig van de provider; LobeChat toont schakelaars per model per capaciteit in de providermodule.
- Schakel bewust een tweelaags kiezer in, één snel ID en één frontier-ID, en voeg er alleen meer toe wanneer een echte assistent ze nodig heeft; elk ingeschakeld model is een rij die gebruikers moeten scrollen.
Betaal naar gebruik · onder officiële prijzen
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Model | Officiële prijs | Onze prijs |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| Gemini 3.5 Flash | $1.50 / $9.00 per M | $1.20 / $7.20 per M |
| DeepSeek V4 Pro | $0.43 / $0.87 per M | $0.40 / $0.90 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
Faalmodi specifiek voor LobeChat.
Een leeg antwoord bij de connectiviteitscontrole is de gedocumenteerde handtekening van een suffixprobleem bij de base-URL. Voeg de /v1 toe of verwijder hem (voor APIsRouter moet hij aanwezig zijn) en probeer opnieuw voordat je dieper gaat debuggen. Modellen die ontbreken in de kiezer van een assistent betekenen meestal dat ze zijn opgehaald maar niet ingeschakeld in de modellijst van de provider, of dat de providerschakelaar zelf uit staat. Beide leven op hetzelfde instellingenscherm als de fetch-actie. Bij self-hosted deployments, onthoud de precedentie: omgevingsvariabelen configureren de standaardwaarden aan serverzijde, terwijl gebruikers nog steeds hun eigen providerinstellingen client-side kunnen invoeren, afhankelijk van de auth- en feature flags van jouw deployment. Als een deployment je OPENAI_PROXY_URL negeert, bevestig dan dat de container daadwerkelijk is herstart met de nieuwe omgeving en dat de clientsessie het niet lokaal overschrijft. Versiedrift is hier reëel: de instellingenboom is meer dan eens gereorganiseerd (Language Model, daarna AI Service Provider, met de providermodule die in v1.44 arriveerde), en screenshots uit oudere tutorials komen niet overeen met de huidige menu's. De velden zelf — id, name, SDK-type, URL, sleutel — zijn stabiel gebleven.
Wie routeert LobeChat via een gateway.
- Self-hosters die LobeChat voor een team draaien en één endpoint in de container en één gebruikslogboek voor iedereen willen, in plaats van leverancierssleutels per gebruiker.
- Powerusers van assistenten die verschillende leveranciers per rol vastpinnen — Claude voor schrijven, GPT voor analyse, DeepSeek voor volume — zonder voor elk een account te onderhouden.
- Gebruikers die modellen willen die de ingebouwde providerlijst niet draagt, ingeschakeld door de gatewaycatalogus op te halen in plaats van te wachten op upstream-releases.
- Developers zonder toegang tot de facturering van een bepaalde leverancier. Toegang op basis van opwaarderen zonder kaartvereiste verwijdert de aanmeldingsafhankelijkheid per provider.
- Mensen die hun editor-, launcher- of CLI-tools al via een gateway routeren en hun chatframework op dezelfde sleutel willen.
Verifieer het endpoint en debug het eerste gesprek.
Curl eerst de modellijst op en houd de output open; het is de gezaghebbende spelling voor elk ID dat je inschakelt, of dat nu via fetch of handmatig is. Draai vervolgens één chat completion tegen het ID dat je van plan bent standaard te maken. Werk binnen LobeChat de connectiviteitscontrole af vóór echte gesprekken. Authenticatiefouten wijzen naar het sleutelveld. Een leeg antwoord wijst naar het /v1-suffix. Not-found-fouten bij een specifiek model betekenen dat het ingeschakelde ID niet overeenkomt met de lijst, wat meestal gebeurt na het samen handmatig bewerken van weergavenamen en ID's. Zodra gesprekken vloeien, toont de APIsRouter-console model per verzoek, tokenaantallen en uitgaven. Een chatframework met assistenten genereert verkeer over verschillende modellen tegelijk, en de gebruiksweergave per sleutel is waar de gewoonte van elke assistent een kost wordt die je per model, per dag kunt zien.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3.5-flash",
"messages":[{"role":"user","content":"ping"}]}'Veelgestelde vragen
Hoe voeg ik een aangepaste OpenAI-compatibele provider toe aan LobeChat?
Open in de instellingen de sectie AI-serviceprovider en maak een aangepaste provider aan: ID en weergavenaam, SDK-type OpenAI, endpoint https://api.apisrouter.com/v1, en je sleutel. Haal de modellijst op, schakel de gewenste ID's in, en draai de connectiviteitscontrole.
Heeft de endpoint-URL /v1 nodig?
Voor APIsRouter, ja: https://api.apisrouter.com/v1. LobeChat voegt routes zoals /chat/completions toe aan de base die je opgeeft, en de documentatie vermeldt dat een verkeerd suffix meestal naar voren komt als een leeg antwoord bij de test. Zie je dat, herstel dan het suffix en probeer opnieuw.
Wat is OPENAI_PROXY_URL en wanneer gebruik ik het?
Het is de self-hosting-omgevingsvariabele die de ingebouwde OpenAI-provider van LobeChat naar een andere base-URL herwijst. Zet hem samen met OPENAI_API_KEY in de container, en elke gebruiker van die deployment erft het endpoint; gebruik OPENAI_MODEL_LIST om te cureren welke ID's verschijnen.
Kunnen verschillende assistenten verschillende leveranciers gebruiken via één provider?
Ja. Elke assistent pint zijn eigen model, en het ID reist per verzoek als platte string naar het endpoint. Eén providervermelding kan een Claude-assistent, een GPT-assistent en een DeepSeek-assistent naast elkaar bedienen, allemaal gefactureerd via dezelfde sleutel.
Is LobeChat hetzelfde project als LobeHub?
Ja. Het project is herbrand en de GitHub-repo leeft nu op lobehub/lobehub, waarbij de oude naam lobe-chat doorverwijst. Documentatie en menu's mixen beide namen tijdens de overgang, wat ook is waarom instellingslabels variëren tussen releases.
Waarom verschijnen mijn opgehaalde modellen niet in gesprekken?
Fetchen lijst ID's op; ze inschakelen is een aparte schakelaar per model in de modellijst van de provider, en de provider zelf heeft een aan/uit-schakelaar. Controleer beide, en heropen dan de modelkiezer. Als een ingeschakeld ID nog steeds een fout geeft, vergelijk de spelling dan met de /v1/models-output.