Responses API och function_call_output
På denna sida
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ätterrole: "tool"call_idersättertool_call_idoutputersättercontent
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_outputistället för rollentool - Fält ändras:
call_idistället förtool_call_id,outputistället förcontent previous_response_idlåter dig kedjekoppla konversationer utan att skicka om historikenstore_messages=Trueaktiverar lagring på serversidan- Responses API är den rekommenderade slutpunkten för nya xAI-projekt
- Chat Completions finns kvar för bakåtkompatibilitet med OpenAI