English version of this page

Ta i bruk KI med API-tilgang

Denne siden beskriver hvordan du kan bruke GPT UiO med personlige API-nøkler til kodeverktøy eller andre agentiske verktøy. For å ta dette i bruk må du først få tilgang. Se informasjon på siden Bruke GPT UiO med API-nøkler.

Om kode agenter, installasjon og forberedelser

Sikkerhet

Verktøy som opencode, codex, claude code og andre er KI-agenter. Det betyr at de kan utføre handlinger på maskinen din, som f.eks. å lage, slette eller redigere filer, eller utføre andre handlinger du ber agenten din om å gjøre.

Siden agentene kan gjøre endringer for deg, må du være ekstra oppmerksom på tilganger og sikkerhet.

Gi alltid kodeagenten minst mulig rettigheter:

Kjør agenten (start opp verktøyet) i en egen prosjektmappe, ikke fra hjemmeområdet ditt.
Del bare de filene og mappene agenten faktisk trenger.
Unngå å gi tilgang til mapper med begrenset eller fortrolig innhold som nøkler, passord og andre hemmeligheter (gule og røde data) som ikke er nødvendige for oppgaven.

API nøkler må behandles på samme måte som passord. Ikke del agent konfigurasjonsfiler eller andre filer som inneholder nøkler i versjonskontroll (for eksempel Git) eller med andre. Følg UiOs retningslinjer for informasjonssikkerhet og bruk av KI‑verktøy.

Installasjon av agentapper

På en UiO-driftet maskin får du tilgang til agent programvare som VSCode (ikke strengt tatt en agentapp), Codex, Cline, OpenCode og andre, fra

Company Portal (for Windows)
Managed Software Center for Mac.

Har du ikke en UiO-driftet maskin, så følg veiledningene lenket opp fra IT-tjenestesiden for programvare.

Hvordan sette opp miljøvariabler

I agent-appene er det god praksis å lagre API nøklene i såkalte miljøvariabler, heller enn i klartekst i konfigurasjonsfilene til appene. Her er en beskrivelse av hvordan du gjør dette på Mac og Windows.

Miljøvariabler på Mac

På Mac kan du legge følgende to linjer i filen `~/.bash_profile`.

export UIO_YELLOW_API_KEY=yellow_API_key_xxxdin-egen-nokkelxxx
export UIO_RED_API_KEY=red_API_key_xxxdin-egen-nokkelxxx

For å aktivere de må enten

lukke terminalen og åpne den igjen for at de skal være aktive
eller kjøre kommandoen `source ~/bash_profile` i samme terminalvindu.

Miljøvariablene er da tilgjengelige fra terminal som $UIO_YELLOW_API_KEY og $UIO_RED_API_KEY.

Miljøvariabler på Windows

For å legge til miljøvariabler i Windows:

System settinger -> 'Rediger miljøvariabler for bruker'
Legg til en ny variabel med navn UIO_YELLOW_API_KEY eller UIO_RED_API_KEY og lim inn selve API-nøkkelen som du finner i gpt.uio.no
Avvis alle dialogene ved å velge “OK”. Endringene dine lagres!

Etter at du har laget miljøvariablene er de tilgjengelige som $env:UIO_YELLOW_API_KEY eller $env:UIO_RED_API_KEY i Powershell eller %UIO_YELLOW_API_KEY% og %UIO_RED_API_KEY% i Command Prompt.

Eksempel på bruk

I konfigurasjonsfilene for Codex og opencode bruker du da disse variablene heller enn å legge inn API nøkkelen i klartekst.

MAC:

curl "https://gpt.uio.no/api/v1/responses" -H "Content-Type: application/json" -H "Authorization: Bearer $UIO_YELLOW_API_KEY" -d '{"model": "gpt-oss-120b","input": "Write a one-sentence bedtime story about a unicorn."}'

Windows Powershell

curl "https://gpt.uio.no/api/v1/responses" -H "Content-Type: application/json" -H "Authorization: Bearer $env:UIO_YELLOW_API_KEY" -d '{"model":"gpt-oss-120b","input":"Write a one-sentence bedtime story about a unicorn"}'

Windows Command Prompt

curl "https://gpt.uio.no/api/v1/responses" -H "Content-Type: application/json" -H "Authorization: Bearer %UIO_YELLOW_API_KEY%" -d "{\"model\":\"gpt-oss-120b\",\"input\":\"Write a one-sentence bedtime story about a unicorn\"}"

Agent-apper

Det finnes mange agent-apper. Her beskriver vi noen og hvordan du setter de opp for API tilgang.

VSCode og Cline extension

API oppsettet til gpt.uio.no er av typen OpenAI Compatible. Du må velge denne typen for at API tilgangen skal fungere.

Eksempel på konfigurasjon for agent plugins i VSCode som f.eks. Cline ser

Skjermbilde av Cline API konfigurasjon i VSCode

Opencode

OpenCode er en åpen KI kode agent. Den er tilgjengelig fra terminal (kommandolinje), som en desktop app eller også som en IDE extension (fra din kode editor).

OpenCode kan settes opp til å bruke språkmodellene som er tilgjengelige via gpt.uio.no. Da kan du bruke opencode til både gule og røde data avhengig av hvilken modell du velger. Husk at det er modellvalget og konfigurasjonen som avgjør hva som er lov.

Konfigurasjon

Du kan konfigurere opencode slik at oppsettet gjelder på ulike nivåer på din laptop.

Globalt oppsett: Gjelder uansett hvor du bruker OpenCode.
Prosjektoppsett: Gjelder bare i et bestemt filområde (et OpenCode‑prosjekt).

For oppdatert og detaljert dokumentasjon, se opencode sin egen dokumentasjon.

Konfigurasjonsfilen opencode.json

Du konfigurerer opencode ved å redigere filen `opencode.json`.

Global konfigurasjon, opprett eller rediger filen i ditt hjemmeområde: `~/.config/opencode/opencode.json`.
For prosjektspesifikk konfigurasjon, opprett en ny file `opencode.json` i den prosjektmappen du vil jobbe i.

Eksempel konfigurasjonsfil

Under finner du et eksempel på en opencode.json konfigurasjonsfil som setter opp en gul og en rød modell som kjører på lokal infrastruktur, og en gul modell som kjører i Azure. Sjekk alltid hvilke modeller som er tilgjengelige for øyeblikket i gpt.uio.no, de oppdateres jevnlig. Det er kun feltene i "models" som da må oppdateres.

Du må også legge inn din egen api nøkkel i "apiKey" feltet, Hent din API nøkkel hos gpt.uio.no som beskrevet i Bruke GPT med API-nøkler. Bruk miljøvariablene som du har satt opp i som forklart i Hvordan sette opp miljøvariabler.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
  "gpt-ntnu-red": {
  	"npm": "@ai-sdk/openai-compatible",
  	"name": "GPT UIO Lokal red",
  	"api": "chat",
  	"options": {
  		"baseURL": "https://gpt.uio.no/api/v1",
  		"apiKey": "{env:UIO_RED_API_KEY}"
  	},
	"models": {
		"gpt-oss-120b": {
			"name": "GPT UiO - GPT OSS"
		}
	  }
    },
    "gpt-ntnu-yellow": {
    	"npm": "@ai-sdk/openai-compatible",
		"name": "GPT UIO Lokal yellow",
	 	"api": "chat",
	  	"options": {
              "baseURL": "https://gpt.uio.no/api/v1",
	    	  "apiKey": "{env:UIO_YELLOW_API_KEY}"
	  	},
	  	"models": {
	  		"moonshotai/Kimi-K2.6": {
	  			"name": "GPT UiO - Kimi-K2.6"
	  		}
	    }
    },
    "gpt-azure-yellow": {
    	"npm": "@ai-sdk/openai",
    	"name": "GPT Azure yellow gpt",
    	"api": "chat",
    	"options": {
    		"baseURL": "https://gpt.uio.no/api/v1",
    		"apiKey": "{env:UIO_YELLOW_API_KEY}"
    	},
    	"models": {
    		"gpt-5.4": {
    			"name": "GPT UiO - GPT 5.4",
    			"options": { "forceReasoning": true }
    		}
    	}
    }
  }
}

Hvordan åpne OpenCode Desktop App

Dersom du kjører desktop appen og ikke kommandolinje appen så må du starte appen fra terminalen, ellers vil ikke miljøvariablene du har satt opp være tilgjengelig for appen.

#For macOS
open /Applications/OpenCode.app
#For Linux
opencode-desktop &
#For Windows
opencode

Demo kommandolinje app

Her viser vi hvordan du starter opp OpenCode kommandolinje appen, og hvordan du velger en uio modell, etter at du har satt opp en liknende konfigurasjonsfil som vist over.

Vi viser to eksempler på hvordan du kan velge hvilken modell opencode skal bruke. Først viser vi hvordan åpne opencode uten å velge spesifikk modell, og deretter bruke /model kommandoen i opencode. Så viser vi hvordan du kan åpne opencode med en gitt model med å gi --model opsjonen til opencode kommandoen.

ChatGPT Codex

Codex appen er for tiden ikke tilgjengelig i Company Portal eller Managed Software Center. Ting er i rask endring, og vi forventer å ha denne appen tilgjengelig etterhvert.

Før du starter må du lage noen miljøvariabler som inneholder din API nøkkel, se Hvordan sette opp miljøvariabler.

For å konfigurerer codex med modellene i gpt.uio.no, legg til følgende i din `~/.codex/config.toml` fil som automatisk blir opprettet når du installerer codex.

Merk: For øyeblikket fungerer ikke andre modeller enn gpt-5.4 i codex. Men konfigurasjonen viser hvordan legge til et par modeller som kjører på NTNU.

model_reasoning_effort = "medium"
personality = "pragmatic"
##################
# Default model
##################
model = "gpt-5.4"
model_provider = "UIO-gpt5-4"
##################################
# UIO 5.4 settings - Azure OPENAI 
##################################
[model_providers.UIO-gpt5-4]
name = "UIO-GPT5-4"
base_url = "https://gpt.uio.no/api/v1"
env_key = "UIO_YELLOW_API_KEY"
[profiles.uio-gpt5.4]
model_provider = "UIO-gpt5-4"
model = "gpt-5.4"
##########################
# UIO red settings - NTNU
##########################
[model_providers.UIO-red]
name = "UIO-red"
base_url = "https://gpt.uio.no/api/v1"
env_key = "UIO_RED_API_KEY"
[profiles.uio-red]
model_provider = "UIO-red"
model = "gpt-oss-120b"
############################
# UIO yellow settings - NTNU
############################
[model_providers.UIO-yellow]
name = "UIO-yellow"
base_url = "https://gpt.uio.no/api/v1"
env_key = "UIO_YELLOW_API_KEY"
[profiles.uio-yellow]
model_provider = "UIO-yellow"
model = "google/gemma-4-31B-it"

Mer informasjon om codex configurasjon finner du i codex sin egen dokumentasjon.

Hvordan åpne Codex / ChatGPT-Codex Desktop App

Dersom du kjører desktop appen og ikke kommandolinje appen så må du starte appen fra terminalen, ellers vil ikke miljøvariablene du har satt opp være tilgjengelig for appen.

#For macOS
open /Applications/ChatGPT.app
# TODO: Linux/Windows beskrivelse

Eksempelbruk - sjekk at API-en fungerer

Før du går igang med agent-apper kan det være lurt å sjekke at API tilgangen din fungerer som den skal. Det kan du enklest gjøre ved hjelp av curl kommandoen.

curl

Den enkleste type bruk av API mot språkmodeller er ved hjelp av kommandoen "curl". Dette er den raskeste måten å sjekke om API koblingen fungerer.

Bruk av curl forutsetter at du er komfortabel med terminalbruk. Er du ikke det, kan noen av de andre metodene beskrevet i dette dokumentet passe bedre for deg.

De vanligste endepunktene er v1/chat/completions og v1/responses. Sistenevnte begynner å ta mer og mer over og er en nyere type som bedre støtter agentisk bruk.

chat-completions

Eksempel på hvordan et curl kall til chat/completions ser ut. Kopier denne teksten inn i terminal. Husk å bytte ut <DIN-API-NØKKEL> med din faktiske api nøkkel og uten "<" og ">" tegnet.

export token=<DIN-API-NØKKEL>
curl -X POST "https://gpt.uio.no/api/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $token" \
-d '{
"model": "gpt-oss-120b", 
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Hei, dette er en test, svar med ok"
      }
    ]
}'

responses

Eksempel på hvordan et API kall til responses endepunktet ser ut.

Kopier denne teksten inn i terminal. Husk å bytte ut <DIN-API-NØKKEL> med din faktiske api nøkkel og uten "<" og ">" tegnet.

export token=<DIN-API-NØKKEL>
curl "https://gpt.uio.no/api/v1/responses" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $token" \         
    -d '{
        "model": "gpt-oss-120b",
        "input": "Write a one-sentence bedtime story about a unicorn."
    }'

Publisert 28. sep. 2026 11:10 - Sist endret 28. sep. 2026 14:49