Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Paprastas POST /v1/responses užklausos pavyzdys

Paskaita 9 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Tavo pirmasis sėkmingas kvietimas
  2. Užklausos struktūra
  3. Atsako anatomija
  4. Dažni neprivalomi parametrai
  5. Pokalbio tęsimas
  6. Išlaidų stebėjimas
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d., remiantis „xAI“ geriausiomis praktikomis ir API nuoroda: temperatūra ribojama iki 1, o „xAI“ rekomenduoja naudoti 0.7 kartu su top_p reikšme 0.95. Šaltinis: Geriausios praktikos.

Tavo pirmasis sėkmingas kvietimas

Turi paskyrą, API raktą ir įdiegtą SDK. Metas siųsti pirmąją užklausą „Grok“ API ir suprasti atsako struktūrą. Šioje pamokoje dėmesys skiriamas pagrindiniam galiniam taškui /v1/responses – tai moderniausias ir labiausiai rekomenduojamas būdas.

Užklausos struktūra

Galiniame taške POST /v1/responses būtina nurodyti bent du parametrus:

  • model: naudojamo modelio ID
  • input: tavo užklausos tekstas (arba turinio masyvas sudėtingesniais atvejais)

Minimali užklausa naudojant „Python“

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="What's the most widely used programming language in 2026?"
)

print(response.output[0].content[0].text)

Su sistemos instrukcijomis

Parametras instructions leidžia apibrėžti modelio elgseną:

response = client.responses.create(
    model="grok-4.5",
    instructions="You are a web development expert. Answer concisely.",
    input="What's the difference between SSR and SSG?"
)

Atsako anatomija

API grąžina struktūrizuotą JSON objektą. Štai pagrindiniai laukai:

{
  "id": "resp-abc123",
  "object": "response",
  "status": "completed",
  "model": "grok-4.5",
  "output": [
    {
      "type": "message",
      "content": [
        {
          "type": "output_text",
          "text": "The model's answer appears here."
        }
      ],
      "status": "completed"
    }
  ],
  "usage": {
    "input_tokens": 42,
    "output_tokens": 156,
    "total_tokens": 198
  }
}

Svarbūs laukai

  • id: unikalus atsako ID, naudingas vėliau jį atkurti
  • status: completed, kai generavimas baigtas
  • output: masyvas, kuriame yra sugeneruoti pranešimai
  • usage: žetonų skaitikliai, padedantys stebėti tavo sunaudojimą

Dažni neprivalomi parametrai

Kūrybiškumo valdymas

response = client.responses.create(
    model="grok-4.5",
    input="Suggest a name for an AI startup.",
    temperature=0.7,  # „xAI“ rekomenduojama reikšmė
    top_p=0.95,
)
  • API priima temperatūros reikšmes nuo 0 iki 2, tačiau visas didesnes reikšmes apriboja iki 1
  • „xAI“ rekomenduoja naudoti temperature=0.7 ir top_p=0.95 bei pataria nuo jų nenukrypti: kokybė paprastai suprastėja
  • Jei nori daugiau kūrybiškumo, paprašyk to tiesiogiai užuominoje („pasiūlyk netikėtų pavadinimų“)

Ilgio ribojimas

response = client.responses.create(
    model="grok-4.5",
    input="Summarize the concept of machine learning.",
    max_output_tokens=200  # Atsakymo ilgio riba
)

Įjungimas samprotavimą

Samprotavimo modeliams gali reguliuoti mąstymo intensyvumą:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Solve this problem: if 3x + 7 = 22, what is x?",
    reasoning={"effort": "high"}
)

Galimi lygiai trys lygiai: low, medium ir high.

Pokalbio tęsimas

Galutinis taškas /v1/responses palaiko daugkartinio keitimosi žinutėmis pokalbius naudodamas parametrą previous_response_id:

# Pirmoji žinutė
r1 = client.responses.create(
    model="grok-4.5",
    input="I'm building an API in Python."
)

# Antroji žinutė (modelis prisimena kontekstą)
r2 = client.responses.create(
    model="grok-4.5",
    input="Which framework do you recommend?",
    previous_response_id=r1.id
)

Šis būdas yra paprastesnis nei žinučių istorijos valdymas savo jėgomis.

Išlaidų stebėjimas

Atsako laukas usage leidžia apskaičiuoti kiekvieno kvietimo kainą. Laukas output_tokens_details.reasoning_tokens rodo, kiek žetonų buvo panaudota vidiniam modelio samprotavimui (šie žetonai apmokestinami, tačiau atsakyme nematomi).

Svarbiausi punktai

  • Galutinis taškas POST /v1/responses yra moderniausias ir labiausiai rekomenduojamas
  • Du būtini parametrai: model ir input
  • Atsakymas randamas lauke output[0].content[0].text
  • Naudok previous_response_id pokalbiams, susidedantiems iš kelių etapų
  • Laukas usage padeda stebėti tavo sunaudojamus žetonus