AI-modellen en uw eigen sleutel

AI in het paneel werkt op veel plaatsen: product- en gerechtbeschrijvingen, antwoorden aan gasten, gespreksanalyse, het samenstellen van lesmateriaal, een assistent per sectie. Standaard kiezen wij de model per taak — en voor de meesten is dat voldoende.

De sectie „AI-modellen (LLM)” is bedoeld voor wie het zelf wil bepalen: welke dienst verantwoordelijk is voor de assistentfuncties van het account en op welk model die werkt. En als u al een eigen overeenkomst met een provider heeft, kunt u een eigen sleutel koppelen, en dan verlopen de aanroepen via die sleutel.

Openen: de kaart „AI-modellen (LLM)” in de extensiewinkel (categorie „Account”) → admin.cenaly.com/ai-models. De sectie heeft geen eigen menu-item — dat is geen fout, er is één ingang, via de winkel. De sectie is alleen voor de accounteigenaar toegankelijk.

Waarom deze sectie#

Scenario	Wat te doen
„Laat alles vanzelf werken”	niets: u hoeft de sectie niet te openen, het platform kiest zelf een model per taak
„Ik wil dat een specifiek model antwoordt”	een kant-en-klare dienst koppelen en als voorkeur instellen
„Wij hebben een eigen overeenkomst met een provider / eigen inference”	een aangepaste koppeling toevoegen met uw eigen adres en sleutel
„Ik wil begrijpen waar de AI-credits naartoe gaan”	bekijk de balanskaarten op de pagina abonnement

Wat u nodig heeft om te starten#

Wat	Waarvoor
U bent de accounteigenaar	de sectie is owner-only, en dat controleert de server, niet alleen de interface
De kaart in de extensiewinkel	dit is de enige ingang naar de sectie; er is geen aparte vergoeding voor het koppelen van de kaart
Voor uw eigen sleutel — een OpenAI-compatibel endpoint	u heeft een adres nodig (base URL met versie, alleen `https`), een API-sleutel en een model-id
AI-balans — voor kant-en-klare diensten	zij werken via onze infrastructuur en worden betaald met AI-credits op basis van daadwerkelijk gebruik

Stap 1. Een kant-en-klare AI-dienst koppelen#

Het eerste blok van de pagina is „AI-diensten van Cenaly”: ChatGPT (OpenAI), Gemini (Google), Grok (xAI) en DeepSeek. Koppelen met één klik:

Klik op „Koppelen” bij de gewenste dienst — API-sleutels zijn niet nodig, het verzoek loopt via onze infrastructuur.
Bij de gekoppelde dienst verschijnt een regel „Model” — kies een specifiek model uit de lijst van de dienst (elke lijst is eigen en wordt af en toe bijgewerkt).
Een overbodige dienst wordt uitgeschakeld met de knop „Ontkoppelen”.

Betaling — met AI-credits van het account, zoals bij alle andere AI-functies: er verschijnt geen aparte factuur voor „ChatGPT koppelen”, u betaalt voor de daadwerkelijke aanroepen.

Stap 2. Uw eigen sleutel koppelen#

Het tweede blok is „Aangepaste LLM's”. Het is voor wie eigen toegang tot een model heeft: een eigen overeenkomst met een provider, een bedrijfsgateway of een eigen uitgerold model met een OpenAI-compatibele API.

„Aangepaste LLM toevoegen” en vul in: Naam (hoe u het gaat herkennen), Base URL API — het adres inclusief versie, bijvoorbeeld https://api.example.com/v1 (alleen https), API-sleutel, Model — de model-id bij die provider.
Klik op „Verbinding testen” — er gaat een testverzoek uit, en u ziet „Verbinding is er” met een latentiemeting of de reden van de weigering. De test werkt zowel vóór het opslaan als daarna op een reeds opgeslagen record.
„Toevoegen” — de koppeling verschijnt in de lijst. U kunt deze tijdelijk uitschakelen met de schakelaar of verwijderen (met bevestiging: samen met het record wordt ook de opgeslagen sleutel verwijderd).

Hoe de sleutel wordt opgeslagen: deze staat op de server en komt niet terug naar de browser — in de interface is alleen de markering „API-sleutel opgeslagen” en een masker zichtbaar. De sleutel vervangen kan, hem uit het paneel uitlezen niet.

Wat betreft kosten: voor aanroepen via uw sleutel worden geen AI-credits afgeschreven — u betaalt uw provider rechtstreeks. Maar als uw endpoint niet heeft geantwoord, mislukt de aanroep niet: deze gaat via de gewone platformwachtrij — en die aanroep wordt wél met credits verrekend. Controleer de beschikbaarheid van uw endpoint als u verbruik ziet waar u het niet verwachtte.

Er kunnen meerdere koppelingen zijn (tot tien) — bijvoorbeeld verschillende modellen voor verschillende experimenten; actief zijn die met de schakelaar aan.

Stap 3. De voorkeursmodel kiezen#

Het derde blok is „Voorkeursmodel”, een schakelaar voor het hele account:

„Standaard (aanbevolen per taak)” — het platform kiest zelf een model, apart voor elke functie. Dit is de begintoestand;
een specifieke dienst of aangepaste koppeling — de assistentfuncties gebruiken deze in de eerste plaats.

Volgorde van pogingen bij een gekozen voorkeur: eerst uw aangepaste endpoint (als dat de voorkeur heeft), dan de platformaanroep op het gekozen model, dan de gewone terugvalroute — zodat een functie niet „sterft” door één niet-beschikbare provider.

⚠️ De keuze geldt niet in alle AI-functies — details vindt u in „Beperkingen”.

Waar het verbruik zichtbaar is#

Het AI-verbruik staat op de pagina abonnement, in twee kaarten: „LLM-credits” — het resterende saldo voor AI-taken, en „AI-kosten” — het maandelijkse verbruik per functie, de factuurprognose tot het einde van de maand en het maandplafond. Per regel is te zien welke functie precies verbruikt: beschrijvingen, gesprekken, vertaler, training.

Regels voor aanroepen via uw eigen sleutel staan daar niet — zulke aanroepen verbruiken ons saldo niet.

Beperkingen#

De keuze geldt niet op cenaly.ru. In de Russische omgeving werken de AI-functies op YandexGPT en worden de instellingen van dit gedeelte daar niet opgevraagd: de pagina opent en wordt opgeslagen, maar er is niemand om die toe te passen. Dit is een gevolg van de eisen aan gegevensverwerking, niet een vergeten instelling.
De keuze geldt niet voor aanroepen met tools. Een deel van de functies is opgebouwd als „model + tools” — de AI-bot van de gastchat, de copiloot van het paneel, de e-mailsouffleur in e-mail. Ze werken op hun eigen model, ongeacht wat hier is gekozen.
Het gedeelte is alleen voor de eigenaar. Een medewerker ziet het niet in het menu en krijgt via een directe link een foutscherm bij het laden met de knop „Opnieuw”, niet een vriendelijk „geen toegang” — we weten het, we werken eraan.
Een aangepaste sleutel heeft geen termijn en geen automatische rotatie. Wijzigt u de sleutel bij de provider — wijzig die dan ook hier, anders gaan aanroepen via de reserveweg (en tegen credits).
Alleen een OpenAI-compatibele API en alleen https. Het eindpunt wordt samen met de padversie opgegeven; willekeurige protocollen en eigen antwoordformaten worden niet ondersteund.
De modellenlijst van uw provider kennen we niet — de id van het model voert u handmatig in, uit de documentatie van de provider.
Er zijn vier kant-en-klare services. ChatGPT, Gemini, Grok, DeepSeek; de rest — via een aangepaste verbinding.

Problemen oplossen#

Symptoom	Controleer
„Verbinding testen” geeft een fout	het adres moet volledig zijn, samen met de versie (`…/v1`) en via `https`; de sleutel moet geldig zijn; bij de provider moet toegang vanaf externe adressen openstaan
Er is een verbinding, maar de antwoorden blijven „zoals voorheen”	de functie kan een van die zijn die buiten de keuze om gaan (chatbot, copiloot, e-mailsouffleur); of het account werkt in de omgeving `cenaly.ru`
Er worden credits verbruikt, hoewel er een eigen sleutel is verbonden	uw eindpunt antwoordt niet en de aanroepen gaan via de reserveweg. Controleer de verbinding met de knop en bekijk de regels in „AI-uitgaven”
De sleutel in het veld wordt met sterretjes weergegeven	dat is de bedoeling: de sleutel wordt op de server opgeslagen en niet teruggegeven. Hebt u een andere nodig — voer een nieuwe in
Een medewerker ziet „Kan LLM-instellingen niet laden”	het gedeelte is alleen beschikbaar voor de eigenaar van het account
De pagina staat niet in het menu	daar staat hij niet: de ingang is alleen via de kaart „AI-modellen (LLM)” in de appstore

Een algemene uitleg per symptoom — problemen oplossen; als niets heeft geholpen, schrijf ons — hoe u hulp krijgt.

Veelgestelde vragen#

Moet u überhaupt naar dit gedeelte gaan?#

Nee. Zonder dit werkt alles: het platform kiest zelf een model voor elke taak. Het gedeelte is nodig als u zelf een model wilt kiezen of een eigen sleutel wilt verbinden.

Is een eigen OpenAI-sleutel nodig om AI te gebruiken?#

Nee. Kant-en-klare services worden met één klik verbonden en werken via onze infrastructuur, de betaling gaat met AI-credits van het account. Een eigen sleutel is een alternatief, geen vereiste.

Is een eigen sleutel goedkoper?#

Dat hangt af van uw overeenkomst met de provider. Technisch gezien gaat het „buiten onze rekening om”: voor zulke aanroepen worden geen AI-credits afgeschreven, maar betaalt u rechtstreeks aan de provider.

Wie ziet mijn API-sleutel?#

Niemand via de interface: de sleutel wordt naar de server geschreven en niet terug naar de browser gestuurd — u ziet alleen de markering dat hij is opgeslagen. Het gedeelte is uitsluitend beschikbaar voor de eigenaar van het account.

Kunt u verschillende modellen voor verschillende functies kiezen?#

Nee, er is één voorkeur per account. Verschillende modellen voor verschillende taken — dat is juist de modus „standaard”, waarin het platform kiest.

Waarom werkt de keuze op `cenaly.ru` niet?#

De Russische omgeving werkt op YandexGPT: gegevens gaan het omgevingsgebied niet uit, daarom worden externe providers en een eigen eindpunt daar niet verbonden.

Wat gebeurt er als mijn eindpunt tijdelijk niet beschikbaar is?#

De functie raakt niet defect: de aanroep gaat via de gewone platformwachtrij — en wordt met AI-credits geteld. Een stille verlies van het verzoek zal niet gebeuren.

Wat kost de kaart „AI-modellen” zelf?#

Er is geen aparte vergoeding voor het verbinden van de kaart — u betaalt alleen voor het daadwerkelijke gebruik van modellen via onze infrastructuur.

Gerelateerde gedeelten#

Abonnement — de kaarten „LLM-credits” en „AI-uitgaven”: resterend saldo, verbruik per functie en maandelijkse limiet
Appstore — de enige deur naar het gedeelte „AI-modellen”
Kennisbank — de keuze van AI-provider voor het samenstellen van de kennisbank en toestemming voor verwerking
Medewerkers trainen — welk model de leermaterialen en opdrachten samenstelt
AI-vertaler voor de gast — een van de functies die het AI-saldo verbruiken
Chat met gasten — de AI-bot die op zijn eigen model werkt, ongeacht deze keuze
E-mail en AI-autobeantwoorder — nog een functie „model plus tools” die buiten deze keuze om gaat
Hoe u hulp krijgt — als de verbinding de test niet doorstaat