Salt la conținutul principal
Română— Alege o limbă
Meniu

API-ul Responses și function_call_output

Lecția 10 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. API-ul Responses: noul punct de acces
  2. Diferențe față de Chat Completions
  3. Utilizarea API-ului Responses cu SDK-ul OpenAI
  4. Gestionarea răspunsului
  5. Câmpul previous_response_id
  6. Stocarea mesajelor pe server
  7. Când să utilizați API-ul Responses?
  8. Puncte cheie

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ște role: "tool"
  • call_id înlocuiește tool_call_id
  • output înlocuiește content

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 rolul tool
  • Câmpurile se schimbă: call_id în loc de tool_call_id, output în loc de content
  • previous_response_id vă permite să înlănțuiți conversațiile fără a retrimite istoricul
  • store_messages=True activează 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