API-ul Responses și function_call_output
Pe această pagină
API-ul Responses: noul punct de acces
API-ul Responses este noul punct de acces principal al xAI, distinct de punctul de acces Chat Completions compatibil cu OpenAI. Acesta introduce un format diferit pentru apelarea funcțiilor, utilizând tipul function_call_output pentru a returna rezultatele instrumentelor.
Diferențe față de Chat Completions
Punctul de acces Chat Completions (compatibil cu OpenAI) utilizează mesaje cu rolul tool pentru a returna rezultatele. API-ul Responses folosește un format diferit, structurat în jurul tipurilor de evenimente.
Chat Completions (format legacy)
# Returnează rezultatul printr-un mesaj cu rolul "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
API-ul Responses (noul format)
# Returnează rezultatul printr-un obiect function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Diferențe cheie:
type: "function_call_output"înlocuieșterole: "tool"call_idînlocuieștetool_call_idoutputînlocuieștecontent
Utilizarea API-ului Responses cu SDK-ul OpenAI
Puteți utiliza SDK-ul OpenAI pentru a apela API-ul Responses al xAI:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Creează un răspuns cu instrumente
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"]
}
}]
)
Rețineți că API-ul Responses utilizează input în loc de messages, iar structura instrumentelor este ușor diferită (fără obiectul imbricat function).
Gestionarea răspunsului
Răspunsul API-ului Responses conține un tablou output cu evenimente:
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}")
# Execută funcția
result = get_weather(city="Paris")
# Continuă conversația cu rezultatul
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
)
Câmpul previous_response_id
API-ul Responses introduce un mecanism de înlănțuire a conversațiilor prin intermediul câmpului previous_response_id. În loc să retrimiteți întregul istoric al mesajelor, faceți simplu referire la răspunsul anterior:
# Prima cerere
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# A doua cerere (înlănțuită)
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
)
Acest lucru simplifică gestionarea contextului și reduce dimensiunea cererilor.
Stocarea mesajelor pe server
Cu store_messages=True, xAI stochează mesajele pe serverele sale:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Combinat cu previous_response_id, acest lucru vă permite să mențineți conversații lungi fără a retrimite întregul istoric la fiecare cerere.
Când să utilizați API-ul Responses?
Pentru un proiect nou construit specific pe xAI, API-ul Responses este alegerea implicită, din mai multe motive cumulative. Inovațiile ajung aici primele – noile funcționalități sunt adăugate în API-ul Responses înainte de orice alt loc, uneori exclusiv. Anumite instrumente server integrate sunt disponibile doar prin acest canal. Iar pentru conversațiile lungi, înlănțuirea prin previous_response_id este structural mai eficientă decât retransmiterea întregului istoric la fiecare pas: mai puțini tokeni transferați, mai puțin cod de gestionare a stării din partea dumneavoastră.
Chat Completions păstrează două cazuri de utilizare puternice: codul existent scris pentru API-ul OpenAI, care funcționează ca atare prin schimbarea URL-ului de bază, și proiectele multi-furnizor unde portabilitatea are prioritate – în aceste situații, compatibilitatea câștigă în fața funcționalităților exclusive.
Puncte cheie
- API-ul Responses utilizează
function_call_outputîn loc de rolultool - Câmpurile se schimbă:
call_idîn loc detool_call_id,outputîn loc decontent previous_response_idvă permite să înlănțuiți conversațiile fără a retrimite istoriculstore_messages=Trueactivează stocarea pe partea serverului- API-ul Responses este punctul de acces recomandat pentru noile proiecte xAI
- Chat Completions rămâne disponibil pentru compatibilitatea retroactivă cu OpenAI