Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Chat Completions pret Responses API: Salīdzinājums

Nodarbība 11 no 12 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Divi galapunkti, divas filozofijas
  2. Stāvokļa pārvaldība: fundamentālā atšķirība
  3. Ekskluzīvi rīki un funkcijas
  4. Kad lietot Chat Completions?
  5. Kad lietot Responses API?
  6. Galvenās atziņas

Divi galapunkti, divas filozofijas

xAI piedāvā divus galapunktus mijiedarbībai ar Grok modeļiem: Chat Completions (/v1/chat/completions) un Responses API (/v1/responses). Ir būtiski saprast to atšķirības, lai izvēlētos savam projektam piemērotāko galapunktu un saplānotu iespējamo migrāciju.

Aspekts Chat Completions API Responses
Statuss Mantojums (Legacy) Primārais (ieteicams)
Stāvokļa pārvaldība Bez stāvokļa (sūta vēsturi) Ar stāvokli (previous_response_id)
Servera glabātuve Nē Jā (30 dienas ar store: true)
Saruna Ziņojumu masīvs Sasaistīta pēc ID
Servera rīki Tikai funkciju izsaukumi web_search, x_search, code_interpreter, functions
Šifrēta spriešana Nē Jā (encrypted_content)
Jaunas funkcijas Nav prioritāte Prioritāte
Saderība ar OpenAI Pilnīga Daļēja

Stāvokļa pārvaldība: fundamentālā atšķirība

Chat Completions: tu pārvaldi vēsturi

Ar katru pieprasījumu tev ir jānosūta visa saruna no jauna:

# Chat Completions — nosūti visu katru reizi
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, my name is Alice."},
        {"role": "assistant", "content": "Hello Alice! How can I help you?"},
        {"role": "user", "content": "What is my first name?"}
    ]
)

Responses API: serveris pārvalda vēsturi

Izmantojot Responses API, sarunas turpināšanai pietiek ar vienkāršu identifikatoru:

# Responses API — tikai iepriekšējās atbildes ID
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Hello, my name is Alice."
)

response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is my first name?",
    previous_response_id=response1.id
)

Serveris saglabā kontekstu un automātiski atjauno vēsturi. Tu nemaksā mazāk par tokeniem (vēsture joprojām tiek tarifēta), taču vienkāršo savu kodu un samazini pieprasījumu apjomu.

Ekskluzīvi rīki un funkcijas

Responses API nodrošina piekļuvi servera rīkiem, ko Chat Completions nepiedāvā:

  • web_search: meklēšana tiešsaistē reāllaikā
  • x_search: meklēšana X (Twitter) ierakstos
  • code_interpreter: Python koda izpilde servera pusē

Šie rīki ir tieši integrēti pieprasījumā:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Chat Completions atbalsta funkciju izsaukumus (izstrādātāja definētus rīkus), bet ne šos xAI pārvaldītos servera rīkus.

Kad lietot Chat Completions?

Chat Completions joprojām ir pareizā izvēle vairākos scenārijos:

  • Migrācija no OpenAI: tavs esošais kods strādā bez lielām izmaiņām
  • Vairāki nodrošinātāji: vēlies pārslēgties starp OpenAI, Anthropic un xAI, izmantojot vienu un to pašu kodu
  • Trešo pušu ietvari: LangChain, LlamaIndex, Haystack un lielākā daļa ietvaru izmanto Chat Completions formātu
  • Pilnīga kontrole: vēlies pats pārvaldīt vēsturi (apkopošana, filtrēšana, modificēšana)

Kad lietot Responses API?

Responses API ir vēlams izmantot, ja:

  • Jauni projekti: vēlies uzreiz baudīt jaunākās funkcijas
  • Servera rīki: nepieciešama tīmekļa meklēšana, koda izpilde vai X meklēšana
  • Garas sarunas: nav jānosūta vēsture ar katru pieprasījumu
  • Šifrēta spriešana: piekļuve spriešanas saturam nepārtrauktībai starp pieprasījumiem

Galvenās atziņas

  • Chat Completions ir bez stāvokļa (tu pārvaldi vēsturi), savukārt Responses API ir ar stāvokli (pārvalda serveris)
  • Responses API piedāvā ekskluzīvus servera rīkus: web_search, x_search, code_interpreter
  • Chat Completions nodrošina pilnīgu saderību ar OpenAI, bet Responses API ir specifisks xAI
  • Abi galapunkti tarifē visu sarunas vēsturi
  • Izmanto Chat Completions saderībai, bet Responses API – jaunām funkcijām