Responses API og function_call_output
På denne side
Responses API: Det nye endpoint
Responses API er xAI’s nye primære endpoint, som adskiller sig fra det OpenAI-kompatible Chat Completions-endpoint. Det introducerer et andet format til funktionskald ved at bruge typen function_call_output til at returnere værktøjsresultater.
Forskelle fra Chat Completions
Chat Completions-endpointet (OpenAI-kompatibelt) bruger beskeder med rollen tool til at returnere resultater. Responses API bruger et andet format struktureret omkring begivenhedstyper.
Chat Completions (gammelt format)
# Returner resultatet via en besked med rollen "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (nyt format)
# Returner resultatet via et function_call_output-objekt
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Vigtige forskelle:
type: "function_call_output"erstatterrole: "tool"call_iderstattertool_call_idoutputerstattercontent
Brug af Responses API med OpenAI SDK
Du kan bruge OpenAI SDK til at kalde xAI’s Responses API:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Opret et svar med værktøjer
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"]
}
}]
)
Bemærk, at Responses API bruger input i stedet for messages, og at værktøjsstrukturen er lidt anderledes (ingen indlejret function-objekt).
Håndtering af svaret
Svaret fra Responses API indeholder et output-array med begivenheder:
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}")
# Udfør funktionen
result = get_weather(city="Paris")
# Fortsæt samtalen 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
)
Feltet previous_response_id
Responses API introducerer en mekanisme til kædning af samtaler via previous_response_id. I stedet for at gensende hele historikken for beskeder, henviser du blot til det foregående svar:
# Første anmodning
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Anden anmodning (kædet)
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
)
Dette forenkler konteksthåndteringen og reducerer størrelsen på anmodninger.
Lagring af beskeder på serveren
Med store_messages=True gemmer xAI beskeder på deres servere:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Kombineret med previous_response_id giver dette dig mulighed for at opretholde lange samtaler uden at skulle gensende hele historikken med hver anmodning.
Hvornår skal du bruge Responses API?
Til et nyt projekt, der er bygget specifikt på xAI, er Responses API det standardvalg af flere sammenfaldende årsager. Innovationer ankommer hertil først – nye funktioner føjes til Responses API før noget andet sted, nogle gange eksklusivt. Visse indbyggede serverværktøjer er kun tilgængelige gennem denne kanal. Og til lange samtaler er kædning via previous_response_id strukturelt mere effektiv end at gensende hele historikken ved hver tur: færre tokens overføres, og mindre kode til tilstandshåndtering på din side.
Chat Completions beholder to stærke anvendelsestilfælde: Eksisterende kode skrevet til OpenAI API, som fungerer som den er ved blot at ændre base-URL’en, og projekter med flere udbydere, hvor portabilitet har førsteprioritet – i disse situationer vejer kompatibilitet tungere end eksklusive funktioner.
Vigtige pointer
- Responses API bruger
function_call_outputi stedet for rollentool - Felter ændres:
call_idi stedet fortool_call_id,outputi stedet forcontent previous_response_idlader dig kæde samtaler uden at gensende historikkenstore_messages=Trueaktiverer lagring på serveren- Responses API er det anbefalede endpoint til nye xAI-projekter
- Chat Completions forbliver tilgængelig for bagudkompatibilitet med OpenAI