Skip to main content
Modeltoegang bepaalt welke modellen een individuele API-sleutel kan aanroepen. Dit verandert niet het ingeschakelde modellenbereik van je team — het beperkt alleen, binnen dat bereik, de set modellen die een bepaalde sleutel mag aanroepen. Aanroepen naar modellen buiten het toegangsbereik van een sleutel worden geweigerd.
Deze mogelijkheid geldt voor modellen in de LLM-productlijn. Losstaande multimodale mogelijkheden voor afbeeldingen en video maken voorlopig geen deel uit van de configuratie voor modeltoegang.
Veelvoorkomende gebruiksscenario’s:
  • Sleutels isoleren op doel: laat productiesleutels alleen stabiele modellen bereiken en laat experimentele sleutels alleen goedkope modellen bereiken.
  • Risico snel beperken: wanneer een sleutel onverwachte aanroepen naar dure modellen veroorzaakt, beperk deze dan tot een paar veilige modellen.
  • Externe samenwerking: stel voor sleutels die met aannemers of partners worden gedeeld alleen de overeengekomen modellen beschikbaar.

Toegangsmodi

Elke API-sleutel heeft een van twee toegangsmodi: In beide modi overschrijden de toegankelijke modellen nooit het ingeschakelde modellenbereik van je team en bevatten ze nooit modellen die offline zijn gehaald.
  • Alle ingeschakelde modellen: toegankelijke modellen = ingeschakelde modellen van het team (inclusief toekomstige modellen) − uitgesloten modellen.
  • Alleen geselecteerde modellen: toegankelijke modellen = geselecteerde modellen (doorsneden met de ingeschakelde modellen van het team).

Modeltoegang configureren

Alleen teambeheerders kunnen modeltoegang voor een API-sleutel configureren. Developer- en Basic-leden zien een alleen-lezen samenvatting voor sleutels waartoe ze toegang hebben, maar kunnen deze niet bewerken; Billing-leden zien modeltoegang helemaal niet.
1

Key Management openen

Ga naar Key Management en zoek de API-sleutel die je wilt configureren.
2

Instellingen voor modeltoegang openen

Open tijdens het maken of bewerken van de sleutel de sectie Model Access.
3

Een toegangsmodus kiezen

Selecteer Alle ingeschakelde modellen of Alleen geselecteerde modellen:
  • Voeg voor Alle ingeschakelde modellen alle modellen die je wilt blokkeren toe onder Uitgesloten modellen.
  • Voeg voor Alleen geselecteerde modellen ten minste één model toe onder Toegankelijke modellen.
4

Opslaan

Nadat je hebt opgeslagen, kan het enige tijd duren voordat de nieuwe instellingen voor modeltoegang van kracht worden.
Wanneer je een nieuwe sleutel maakt of een bestaande sleutel bewerkt, kun je de instellingen van een andere sleutel binnen hetzelfde team hergebruiken met Copy config en Paste config. Na het plakken kun je direct opslaan of eerst aanpassingen doen.

Wanneer een model offline wordt gehaald

Als een model door het platform offline wordt gehaald, verdwijnt het uit de set beschikbare modellen:
  • Alle aanroepen naar dat model retourneren onmiddellijk een “model unavailable”-respons.
  • Als de opgeslagen configuratie van een sleutel het offline model nog bevat, blijft het zichtbaar maar wordt het grijs weergegeven. Je moet het verwijderen voordat je opslaat — anders kan de configuratie niet worden opgeslagen.

Wanneer een aanroep wordt geweigerd

Wanneer een API-sleutel een model buiten zijn toegangsbereik aanroept, retourneert de aanroep HTTP 403 met de foutcode model_access_denied, wat aangeeft dat de sleutel geen toegang heeft tot dat model. Neem contact op met je teambeheerder om de modeltoegang van de sleutel aan te passen. Zie ook Veelvoorkomende foutcodes. Zie Beleid voor modeltoegang van API-sleutel ophalen om de modeltoegang van een sleutel programmatisch te beheren.
Laatst gewijzigd op 10 augustus 2026