De ce API-ul Responses?
Pe această pagină
Un nou punct de acces pentru noi ambiții
API-ul Responses este noul punct de acces principal oferit de xAI pentru interacțiunea cu modelele Grok. Dacă sunteți deja familiarizat cu punctul de acces Chat Completions (compatibil cu OpenAI), vă întrebați probabil de ce a creat xAI un al doilea punct de acces. Răspunsul se rezumă la un singur cuvânt: evoluție.
Chat Completions rămâne disponibil pentru compatibilitatea retroactivă cu SDK-urile OpenAI, însă xAI adaugă toate noile funcționalități ale platformei mai întâi în API-ul Responses. Acesta este punctul de acces în care merită să vă investiți timpul pentru învățare.
Cu stare vs. Fără stare: Schimbarea fundamentală
Cea mai importantă diferență dintre cele două puncte de acces este modul în care gestionează starea conversației.
Chat Completions (fără stare)
În cazul Chat Completions, fiecare cerere este independentă. Trebuie să trimiteți întregul istoric al conversației la fiecare apel:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are an assistant."},
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Tell me about AI."}
]
}
Cu cât conversația este mai lungă, cu atât cererea este mai voluminoasă. Dvs. gestionați contextul manual.
API-ul Responses (cu stare)
În cazul API-ului Responses, serverul xAI reține istoricul. Trimiteți simplu noul mesaj și o referință la răspunsul anterior:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
Serverul reconstruiește întregul context pentru dvs. Mai puține date de transmis, mai puțin cod de scris, mai puține erori posibile.
Funcționalități exclusive
Mai multe funcționalități sunt disponibile exclusiv prin API-ul Responses:
- Instrumente native pe server:
web_search,x_searchșicode_interpreterrulează direct pe serverele xAI, fără nicio configurare din partea dvs. - Înlănțuirea conversațiilor: prin
previous_response_id, modelul reține tot contextul fără ca dvs. să trebuiască să îl retrimiteți. - Stocare persistentă: cu
store: true, răspunsurile dvs. sunt reținute timp de 30 de zile și pot fi recuperate prin GET. - Raționament criptat: recuperați raționamentul intern al modelelor Grok recente sub formă criptată pentru a-l reutiliza în cererile ulterioare.
- Urmărire granulară a costurilor:
cost_in_nano_usdîn fiecare răspuns pentru un control precis al cheltuielilor dvs.
Când să utilizați fiecare punct de acces?
Utilizați Chat Completions doar dacă migrați un proiect existent de la API-ul OpenAI și nu vă puteți modifica codul imediat.
Pentru orice proiect nou, utilizați API-ul Responses. Este mai simplu, mai puternic și va beneficia de toate îmbunătățirile viitoare ale platformei xAI.
Puncte cheie
- API-ul Responses este punctul de acces principal al xAI; Chat Completions este considerat învechit
- Este cu stare: serverul gestionează istoricul conversației
- Oferă instrumente native pe server (căutare web, X, interpret de cod)
- Stocarea persistentă vă permite să reluați conversații chiar și după 30 de zile
- Orice proiect nou ar trebui să utilizeze API-ul Responses