AI-agenter · Lektion

Anropa OpenAI API: chat.completions

Skicka meddelanden till OpenAI-slutpunkten chat.completions, ange temperature och max_tokens och tolka svaret.

Lektion 1 av 413 steg

Anropa OpenAI API: chat.completions är en gratis lektion i AI-agenter på CoddyKit. Detta är lektion 1 av 4. Ni kan läsa hela lektionen gratis nedan och sedan öva praktiskt i webbläsaren med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt. Den ingår i lärvägen för AI-agenter, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i AI-agenter innehåller totalt 4 lektioner.

Varför chat.completions?

OpenAI har två API:er:

  • chat.completions — den standardiserade endpointen med brett stöd
  • Responses API / Assistants — hanterade agenter (mer avancerade)

Den här lektionen handlar om chat.completions, som är arbetshästen för 95 % av alla agenter.

Installera SDK:t

Ett paket, en rad:

# pip install openai
from openai import OpenAI

client = OpenAI()  # reads OPENAI_API_KEY from env

Ert första anrop

En minimal completion:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=[
        {'role': 'system', 'content': 'You are concise.'},
        {'role': 'user', 'content': 'Capital of France?'},
    ],
)
print(response.choices[0].message.content)
# 'Paris'

Svarobjektets anatomi

Svaret innehåller mer än bara text. Användbara fält:

response.choices[0].message.content       # the text
response.choices[0].finish_reason          # 'stop' / 'length' / 'tool_calls'
response.usage.prompt_tokens               # input tokens
response.usage.completion_tokens           # output tokens
response.usage.total_tokens                # sum
response.id                                # 'chatcmpl-...' for tracing

Viktiga parametrar

  • model — vilken modell som ska användas
  • temperature — 0.0 deterministiskt, 1.0 kreativt
  • max_tokens — gräns för utdatalängden
  • top_p — ett alternativ till temperature
  • seed — reproducerbar utdata (med vissa förbehåll)

Temperature: välj utifrån uppgiften

  • 0.0 — extraktion, klassificering och kodgenerering
  • 0.2-0.5 — de flesta agentbeslut
  • 0.7-1.0 — kreativt skrivande och brainstorming

Stop sequences

Avsluta utdata vid en specifik markör:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=messages,
    stop=['\n\n', 'END'],
)
# Stops as soon as a blank line or 'END' appears.

Flera alternativ

Generera N kandidater i ett enda anrop:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=messages,
    n=3,  # three samples
)
for choice in response.choices:
    print(choice.message.content)

Feltyper att hantera

  • RateLimitError — 429, öka väntetiden
  • APIConnectionError — nätverksproblem
  • APITimeoutError — långsamt svar
  • AuthenticationError — felaktig API-nyckel
  • BadRequestError — schemaproblem

Asynkrona anrop

Använd den asynkrona klienten för agenter med högt genomflöde:

from openai import AsyncOpenAI
import asyncio

client = AsyncOpenAI()

async def ask(q):
    r = await client.chat.completions.create(
        model='gpt-4o-mini',
        messages=[{'role': 'user', 'content': q}],
    )
    return r.choices[0].message.content

results = asyncio.run(asyncio.gather(*[ask(q) for q in questions]))

Inbyggda tidsgränser och omförsök

SDK:t gör vissa omförsök som standard. Ni kan åsidosätta detta:

client = OpenAI(
    timeout=30.0,
    max_retries=3,
)

Slutorsaker

Vad betyder finish_reason == "length"?

Sammanfattning

Ni kan nu anropa OpenAI från Python. Nästa del handlar om Anthropic API, som har små men viktiga skillnader.

Gratis att börja

Lär dig AI-agenter med en AI-lärare – gratis

Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.

Kurser
60
Lektioner
239

Vanliga frågor

Är lektionen ”Anropa OpenAI API: chat.completions” gratis?

Ja – hela texten till ”Anropa OpenAI API: chat.completions” kan läsas gratis här på webben. Om Ni vill öva interaktivt med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt och låsa upp resten av kursen i AI-agenter, kan Ni uppgradera till CoddyKit PRO. Kursen i AI-agenter innehåller totalt 4 lektioner.

Vad lär jag mig i ”Anropa OpenAI API: chat.completions”?

Skicka meddelanden till OpenAI-slutpunkten chat.completions, ange temperature och max_tokens och tolka svaret. Ni övar på AI-agenter med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.

Behöver jag någon erfarenhet för att börja lära mig AI-agenter?

Du behöver inga förkunskaper. Utbildningen i AI-agenter på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 1 av 4.

Hur lång tid tar lektionen ”Anropa OpenAI API: chat.completions”?

De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.

Kan jag skriva och köra kod i den här AI-agenter-lektionen?

Ja. Varje AI-agenter-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.

Alla lektioner i den här kursen

  1. Anropa OpenAI API: chat.completions
  2. Anropa Anthropic API: messages
  3. Strömmande svar (SSE)
  4. Koll på kostnader: tokenräkning och budgetar
← Tillbaka till AI-agenter