OpenAI API på svenska

Grunderna

Vad är ett API och en API-nyckel?

Ett API är ett sätt för program att prata med varandra. En webbplats har sidor för människor. Ett API har en adress för program. Programmet skickar en förfrågan i ett bestämt format och får svar i ett bestämt format, oftast JSON. JSON är ett textformat med namngivna fält, som program läser lätt.

En API-nyckel är en hemlig kod som visar vem som skickar förfrågan. Med nyckeln kopplar OpenAI varje anrop till ditt konto och tar betalt för det. Alla som har din nyckel kan använda ditt konto, så behandla den som ett lösenord.

Är ChatGPT Plus och OpenAI API samma sak?

ChatGPT Plus och OpenAI API är två olika saker, och OpenAI skriver själv att API-priserna är skilda från prenumerationen. En ChatGPT-prenumeration ger dig ChatGPT och Codex med inbyggda gränser. API:t betalar du per token, en bit text som ofta är en del av ett ord, via ditt konto på OpenAI:s plattform.

Behöver du bara svar och texter, använd ChatGPT. Behöver ett program som du bygger få svar från en modell, använd API:t. Programmet kan vara en kundtjänst, en översättare eller ett skript som sorterar mejl.

Vem behöver OpenAI API?

OpenAI API är för utvecklare och för dig som vill lära dig bygga med AI. För exemplen behöver du kunna köra kommandon i en terminal. Du behöver också Python eller Node.js på datorn. Node.js är programmet som kör JavaScript utanför webbläsaren. Är terminalen ny för dig, läs del 2 om Codex först.

API:t kan mer än text. OpenAI:s modeller tar emot text och bilder, och API:t har inbyggda verktyg för webbsökning, filsökning och körning av kod, enligt OpenAI:s dokumentation.

Kom igång

Hur kommer man igång med OpenAI API?

Tre steg ger dig ett konto och en nyckel som ditt program kan använda.

export OPENAI_API_KEY="your_api_key_here"

setx OPENAI_API_KEY "your_api_key_here"

Ditt första anrop till OpenAI API

Responses API är den väg in i API:t som OpenAI rekommenderar för alla nya projekt, enligt OpenAI:s guide för att byta från det äldre Chat Completions. Inbyggda verktyg som webbsökning och filsökning hör till Responses, enligt samma guide.

Installera först OpenAI:s SDK för ditt programspråk. Ett SDK är ett färdigt kodpaket som sköter anropen åt dig. Spara sedan exemplet i en fil med namnet example.py eller example.mjs och kör filen. Exemplen i Python och JavaScript kommer från OpenAI:s snabbstart och curl-exemplet från OpenAI:s guide om textgenerering. Programmet curl skickar förfrågningar från terminalen på Mac och Linux och behöver inget SDK.

Anropet skickar ett modellnamn i fältet model och en text i fältet input. Modellnamnet i exemplet gäller i skrivande stund, och OpenAI:s modellsida visar vilka namn som gäller nu. Svaret kommer tillbaka med flera fält, och fältet output_text innehåller texten. Byt ut texten mot en egen fråga på svenska och kör igen.

pip install openai

npm install openai

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6-astra",
    input="Write a one-sentence bedtime story about a unicorn.",
)

print(response.output_text)

import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  input: "Write a one-sentence bedtime story about a unicorn.",
});

console.log(response.output_text);

curl "https://api.openai.com/v1/responses" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "gpt-6-astra",
        "input": "Write a one-sentence bedtime story about a unicorn."
    }'

python example.py

node example.mjs

Modeller och verktyg

Vilka modeller finns, och vad kostar OpenAI API?

Du betalar per miljon tokens för texten du skickar in och, till ett högre pris, för texten modellen skriver. Din fråga, filer du skickar med och modellens svar räknas alla i tokens. En större modell kostar mer per token än en mindre, enligt OpenAI:s prissida.

OpenAI har modeller i flera storlekar, enligt OpenAI:s modellsida. Den största passar svåra resonemang och kod, och OpenAI rekommenderar att du börjar med den. En balanserad modell väger förmåga mot kostnad. En snabb modell passar bilder, naturlig text och datoranvändning, alltså att styra en dator. Den minsta passar stora volymer där kostnaden väger tyngst.

Ett exempel: den största modellen kostar i skrivande stund 10 dollar per miljon tokens in och 50 dollar per miljon tokens ut för anrop med kort kontext, alltså lite text per anrop, enligt OpenAI:s prissida. Prissidan visar priset för varje modell.

Hur får man svaret som JSON? Structured Outputs

Structured Outputs gör att modellen alltid svarar enligt ett JSON-schema som du bestämmer, enligt OpenAI:s dokumentation. Ett JSON-schema är en mall som säger vilka fält svaret ska ha. Då saknas inget obligatoriskt fält, och modellen hittar inte på värden utanför de tillåtna. Structured Outputs passar när ett program ska läsa svaret, till exempel för att plocka ut namn, datum och deltagare ur ett mejl.

I Python beskriver du formatet med en klass, en beskrivning av fälten i koden. responses.parse ger tillbaka svaret med fälten ifyllda. OpenAI rekommenderar Structured Outputs framför JSON-läge, som ger giltig JSON men inte följer ett schema.

from openai import OpenAI
from pydantic import BaseModel

client = OpenAI()


class CalendarEvent(BaseModel):
    name: str
    date: str
    participants: list[str]


response = client.responses.parse(
    model="gpt-6-astra",
    input=[
        {"role": "system", "content": "Extract the event information."},
        {
            "role": "user",
            "content": "Alice and Bob are going to a science fair on Friday.",
        },
    ],
    text_format=CalendarEvent,
)

event = response.output_parsed

Vad är function calling?

Function calling, även kallat tool calling, låter modellen använda funktioner i ditt program. En funktion är en bit kod som gör en sak, till exempel hämtar vädret eller slår upp en order. Modellen kör aldrig koden själv, utan säger vilken funktion den vill använda och med vilka värden. Ditt program kör funktionen och skickar tillbaka resultatet.

Flödet har fem steg, enligt OpenAI:s dokumentation:

• Skicka en förfrågan med de verktyg modellen får använda.
• Ta emot ett verktygsanrop från modellen.
• Kör koden i ditt program med värdena från anropet.
• Skicka en ny förfrågan med resultatet från verktyget.
• Ta emot det slutliga svaret, eller fler verktygsanrop.

Hur visar man svaret medan det skrivs?

Streaming skickar svaret bit för bit medan modellen skriver, i stället för allt på en gång. Användaren ser då texten växa fram, som i ChatGPT. Du slår på streaming med stream=True. Svaret kommer då som en följd av händelser, små meddelanden som ditt program läser ett i taget.

from openai import OpenAI

client = OpenAI()

stream = client.responses.create(
    model="gpt-6-astra",
    input=[
        {
            "role": "user",
            "content": "Say 'double bubble bath' ten times fast.",
        },
    ],
    stream=True,
)

for event in stream:
    print(event)

Batch API: lägre pris för jobb som kan vänta

Batch API kör många förfrågningar i bakgrunden till lägre pris. OpenAI:s dokumentation anger 50 procents rabatt, en egen pott med högre gränser och svar inom 24 timmar. Du samlar förfrågningarna i en JSONL-fil, en textfil med en förfrågan per rad. Varje rad har ett eget custom_id, ett namn som du väljer. Hämta resultatet när jobbet är klart. Varje fil får bara innehålla förfrågningar till en modell, enligt samma dokumentation.

Batch passar för jobb som inte brådskar, till exempel att klassa tusentals texter, sammanfatta ett arkiv eller testa en prompt mot många exempel.

Gränser och säkerhet

Rate limits och usage tiers: hur mycket får man använda?

Rate limits begränsar hur mycket du får skicka. OpenAI mäter bland annat förfrågningar per minut (RPM) och tokens per minut (TPM), enligt OpenAI:s sida om gränser. Gränserna gäller per organisation och projekt, inte per person, enligt samma sida.

OpenAI höjer gränserna automatiskt när du har köpt mer krediter. Nivåerna kallas usage tiers, och en högre nivå ger högre gränser, enligt OpenAI:s sida om gränser. Samma sida har en gratisnivå för användare i tillåtna länder och visar vad som krävs för varje nivå och vilka gränser som gäller för varje modell.

Sätt en utgiftsgräns för kontot eller projektet. OpenAI har två sorter. En varning skickar ett meddelande men låter anropen fortsätta. En hård gräns stoppar anropen.

Vad gör OpenAI med datan du skickar till API:t?

OpenAI tränar inte sina modeller på data som du skickar till OpenAI API, om du inte själv väljer att dela den. Så har det varit sedan den 1 mars 2023, enligt OpenAI:s sida om data. Som standard sparar OpenAI loggar i upp till 30 dagar för att upptäcka missbruk, enligt samma sida. Godkända kunder kan få Zero Data Retention eller Modified Abuse Monitoring, som håller innehållet borta från loggarna.

OpenAI har en europeisk region för EES och Schweiz med adressen eu.api.openai.com, enligt OpenAI:s sida om data. För att använda regionen kontaktar du OpenAI:s säljare, blir godkänd för kontrollerna mot missbruk och skriver under ett tillägg om ändrad lagring, enligt samma sida. Regionen gäller ditt innehåll men inte systemdata som kontouppgifter och fakturering. För modeller släppta från den 5 mars 2026 kostar regional behandling 10 procent mer, enligt OpenAI:s prissida.

Skickar du personuppgifter till API:t gäller GDPR. Skriv först ett personuppgiftsbiträdesavtal med OpenAI, ett avtal om hur OpenAI får hantera uppgifterna.

Data från dina användare kan innehålla försök att styra modellen, så kallad promptinjektion. Låt aldrig modellens svar ensamt avgöra något som kostar pengar eller raderar data. Mer om risker finns i guiden om AI-säkerhet.

OpenAI API, Claude API eller Gemini API?

OpenAI API, Claude API och Gemini API fungerar på samma sätt. Du har en nyckel och en adress, skickar text in och får ett svar ut, och betalar per token. Skillnaderna ligger i modellerna, priserna och de inbyggda verktygen.

Samla anropet på ett ställe i ditt program, så att modellen går att byta. Då kan du jämföra pris och kvalitet för just din uppgift. Promptguiden visar hur du skriver bra instruktioner till alla tre.

Vanliga frågor om OpenAI API