Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Responses API och function_call_output

Lektion 10 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Responses API: den nya slutpunkten
  2. Skillnader jämfört med Chat Completions
  3. Använda Responses API med OpenAI SDK
  4. Hantera svaret
  5. Fältet previous_response_id
  6. Lagring av meddelanden på serversidan
  7. När ska du använda Responses API?
  8. Viktiga punkter

Responses API: den nya slutpunkten

Responses API är xAI:s nya primära slutpunkt, skild från den OpenAI-kompatibla slutpunkten för Chat Completions. Den introducerar ett annat format för funktionsanrop genom att använda typen function_call_output för att returnera verktygsresultat.

Skillnader jämfört med Chat Completions

Slutpunkten Chat Completions (OpenAI-kompatibel) använder meddelanden med rollen tool för att returnera resultat. Responses API använder ett annat format strukturerat kring händelsetyper.

Chat Completions (gammalt format)

# Returnera resultatet via ett meddelande med rollen "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (nytt format)

# Returnera resultatet via ett function_call_output-objekt
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Viktiga skillnader:

  • type: "function_call_output" ersätter role: "tool"
  • call_id ersätter tool_call_id
  • output ersätter content

Använda Responses API med OpenAI SDK

Du kan använda OpenAI SDK för att anropa xAI:s Responses API:

from openai import OpenAI

client = OpenAI(
    api_key="votre-cle-api",
    base_url="https://api.x.ai/v1"
)

# Skapa ett svar med verktyg
response = client.responses.create(
    model="grok-4.5",
    input="What's the weather like in Paris?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Get the weather for a city",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string"}
            },
            "required": ["city"]
        }
    }]
)

Observera att Responses API använder input istället för messages, och att verktygsstrukturen skiljer sig något (inget nästlat function-objekt).

Hantera svaret

Svaret från Responses API innehåller en output-array med händelser:

for item in response.output:
    if item.type == "function_call":
        print(f"Function: {item.name}")
        print(f"Arguments: {item.arguments}")
        print(f"Call ID: {item.call_id}")

        # Kör funktionen
        result = get_weather(city="Paris")

        # Fortsätt konversationen med resultatet
        follow_up = client.responses.create(
            model="grok-4.5",
            input=[
                {"type": "function_call_output",
                 "call_id": item.call_id,
                 "output": json.dumps(result)}
            ],
            tools=tools,
            previous_response_id=response.id
        )

Fältet previous_response_id

Responses API introducerar en mekanism för kedjekoppling av konversationer via previous_response_id. Istället för att skicka om hela meddelandehistoriken refererar du helt enkelt till föregående svar:

# Första begäran
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Andra begäran (kedjekopplad)
response2 = client.responses.create(
    model="grok-4.5",
    input=[{
        "type": "function_call_output",
        "call_id": response1.output[0].call_id,
        "output": {temp: 22}
    }],
    previous_response_id=response1.id
)

Detta förenklar kontexthantering och minskar begärans storlek.

Lagring av meddelanden på serversidan

Med store_messages=True lagrar xAI meddelanden på sina servrar:

response = client.responses.create(
    model="grok-4.5",
    input="User question",
    tools=tools,
    store_messages=True
)

Kombinerat med previous_response_id låter detta dig upprätthålla långa konversationer utan att skicka om hela historiken vid varje begäran.

När ska du använda Responses API?

För ett nytt projekt byggt specifikt på xAI är Responses API det självklara valet av flera samverkande skäl. Innovationer lanseras här först – nya funktioner läggs till i Responses API innan någon annanstans, ibland exklusivt. Vissa inbyggda serververktyg finns endast tillgängliga via denna kanal. För långa konversationer är kedjekoppling via previous_response_id strukturellt mer effektiv än att skicka om hela historiken vid varje tur: färre token överförs och mindre kod för tillståndshantering på din sida.

Chat Completions behåller två starka användningsområden: befintlig kod skriven för OpenAI API, som fungerar som den är genom att bara ändra bas-URL:n, samt projekt med flera leverantörer där portabilitet väger tyngst – i dessa situationer går kompatibilitet före exklusiva funktioner.

Viktiga punkter

  • Responses API använder function_call_output istället för rollen tool
  • Fält ändras: call_id istället för tool_call_id, output istället för content
  • previous_response_id låter dig kedjekoppla konversationer utan att skicka om historiken
  • store_messages=True aktiverar lagring på serversidan
  • Responses API är den rekommenderade slutpunkten för nya xAI-projekt
  • Chat Completions finns kvar för bakåtkompatibilitet med OpenAI