Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Palaipsnis migravimas į Responses API

Paskaita 12 iš 12 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Kodėl ir kada migruoti
  2. 1 žingsnis: nustatyk, kokias funkcijas naudoji
  3. 2 žingsnis: migruok paprastus kvietimus
  4. 3 žingsnis: migruok daugiažingsnius pokalbius
  5. 4 žingsnis: pasinaudok naujomis funkcijomis
  6. Rekomenduojama migracijos strategija
  7. Svarbiausi punktai
  8. Patikrink savo žinias

Atnaujinta 2026 m. lapkričio 3 d.: Anksčiau parametrų atitikmenyse buvo nurodyta, kad max_tokens išlaiko savo pavadinimą Responses API; tačiau xAI lentelėje jis keičiamas į max_output_tokens, taip pat keičiasi ir naudojimo skaitiklių pavadinimai. Šaltinis: Palyginimas su Chat Completions.

Kodėl ir kada migruoti

„Chat Completions“ galinė punktas (endpoint) pažymėtas kaip pasenęs. Jis toliau veiks, tačiau naujos funkcijos jam nebebus pridėtos. Jei tavo programai reikia serverio pusės įrankių (interneto paieškos, kodo vykdymo), pokalbių saugojimo arba šifruoto samprotavimo, migracija į Responses API tampa būtina.

Geros naujienos: šią migraciją galima atlikti palaipsniui. Tau nereikia visko perrašyti vienu ypu.

1 žingsnis: nustatyk, kokias funkcijas naudoji

Prieš migruodamas, įsivertink, ką tavo programa naudoja su „Chat Completions“:

# Audituokite esamą kodą
# Ieškokite šių šablonų:

# 1. Paprasti kvietimai (paprastas tekstas)
client.chat.completions.create(model=..., messages=...)

# 2. Srautinis perdavimas (Streaming)
client.chat.completions.create(..., stream=True)

# 3. Funkcijų kvietimas
client.chat.completions.create(..., tools=[...])

# 4. Rega (vaizdai)
# žinutės, kurių turinys yra masyvas [text, image_url]

# 5. Generavimo parametrai
# temperature, max_tokens, top_p, stop, seed

Paprasti kvietimai ir srautinis perdavimas migruojami lengviausiai. Funkcijų kvietimui reikia pritaikyti formatą. Rega veikia panašiai.

2 žingsnis: migruok paprastus kvietimus

Paprasto kvietimo migracija vyksta pagal šį šabloną:

# ANKSČIAU — Chat Completions
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)
texte = response.choices[0].message.content

# PO TO — Responses API
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    instructions="You are a helpful assistant.",
    input="Hello!"
)
texte = response.output_text

Laukų atitikmenys

Pagrindiniai pokyčiai:

  • messages su vaidmeniu system → instructions (specialus parametras)
  • messages su vaidmeniu user → input (paprasta eilutė)
  • response.choices[0].message.content → response.output_text
  • max_tokens → max_output_tokens, pagal xAI atitikmenų lentelę; temperature išlaiko savo pavadinimą
  • response.usage.prompt_tokens ir completion_tokens → input_tokens ir output_tokens (detalės: input_tokens_details.cached_tokens, output_tokens_details.reasoning_tokens)

3 žingsnis: migruok daugiažingsnius pokalbius

Čia Responses API viską supaprastina. Užuot atkūręs istoriją su kiekvienu užklausimu, tu ją grandini pagal ID:

# ANKSČIAU — Chat Completions (istoriją valdai pats)
historique = [
    {"role": "system", "content": "You are a helpful assistant."}
]

def envoyer_message(texte: str) -> str:
    historique.append({"role": "user", "content": texte})
    response = client.chat.completions.create(
        model="grok-4.20-0309-reasoning",
        messages=historique
    )
    reponse = response.choices[0].message.content
    historique.append({"role": "assistant", "content": reponse})
    return reponse

# PO TO — Responses API (istoriją valdo serveris)
dernier_id = None

def envoyer_message(texte: str) -> str:
    response = client.responses.create(
        model="grok-4.20-0309-reasoning",
        instructions="You are a helpful assistant.",
        input=texte,
        previous_response_id=dernier_id
    )
    dernier_id = response.id
    return response.output_text

Kodas tampa paprastesnis, ir tau nebereikia rankiniu būdu valdyti žinučių masyvo.

4 žingsnis: pasinaudok naujomis funkcijomis

Migravęs galėsi naudotis funkcijomis, prieinamomis tik Responses API:

Integruota interneto paieška

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest developments in generative AI?",
    tools=[{"type": "web_search"}]
)
# Atsakyme pateikiamos citatos su šaltinių URL

Atsakymų saugojimas

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze this document...",
    store=True  # Išsaugoma 30 dienų
)

# Atkūrimas vėliau
stored = client.responses.retrieve(response.id)

Šifruotas samprotavimas

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Solve this complex problem...",
    include=["reasoning.encrypted_content"]
)
# Šifruotą samprotavimą galima panaudoti vėlesniuose užklausimuose

Rekomenduojama migracijos strategija

Užuot migravęs viską vienu metu, veiksmus atlik žingsnis po žingsnio:

  1. Nustatyk „Chat Completions“ kvietimus savo kode
  2. Susiek juos pagal sudėtingumą (paprasti → srautiniai → funkcijų kvietimai)
  3. Pirmiausia migruok naujus galinius punktus arba funkcijas („greenfield“)
  4. Tada migruok paprasčiausius esamus kvietimus
  5. Palik „Chat Completions“ trečiųjų šalių integracijoms, kurioms to reikia (pvz., LangChain ir kt.)

Laikinas gretimas veikimas

Pereinamuoju laikotarpiu visiškai priimtina abu galinius punktus naudoti greta:

# Apvalkalas, kuris abstrahuoja naudojamą galinį punktą
class GrokClient:
    def __init__(self, use_responses: bool = False):
        self.use_responses = use_responses
        self.client = OpenAI(
            api_key=os.getenv("XAI_API_KEY"),
            base_url="https://api.x.ai/v1"
        )

    def generate(self, system: str, user_message: str) -> str:
        if self.use_responses:
            response = self.client.responses.create(
                model="grok-4.20-0309-reasoning",
                instructions=system,
                input=user_message
            )
            return response.output_text
        else:
            response = self.client.chat.completions.create(
                model="grok-4.20-0309-reasoning",
                messages=[
                    {"role": "system", "content": system},
                    {"role": "user", "content": user_message}
                ]
            )
            return response.choices[0].message.content

Šis požiūris leidžia pereiti palaipsniui, kiekvieną migraciją testuojant atskirai.

Svarbiausi punktai

  • Migracija gali būti palaipsnė: nereikia visko perrašyti vienu ypu
  • Pagrindiniai pokyčiai: messages → input/instructions, choices[0].message.content → output_text
  • Daugiažingsniai pokalbiai pereina nuo žinučių masyvo prie paprasto previous_response_id
  • Responses API suteikia prieigą prie išskirtinių funkcijų (web_search, saugojimas, šifruotas samprotavimas)
  • Pereinamuoju laikotarpiu naudok abu galinius punktus greta ir migruok pagal sudėtingumo tvarką

Patikrink savo žinias

Pasenusi API suprasta – migracijai pasiruošta.

1. Ką reiškia pasenęs ir be būsenos (stateless) „Chat Completions“ statusas?

Atsakymas: Galinis punktas lieka palaikomas, bet nebe vystomas: būdamas be būsenos, jis reikalauja siųsti visą istoriją su kiekvienu kvietimu – Responses API yra šiuolaikiškas kelias.

2. Kokie vaidmenys struktūruoja žinutes?

Atsakymas: system (ir developer), user, assistant – sistema, užklausos, atsakymai: visa istorija pradedama iš naujo su kiekvienu užklausimu.

3. Kaip naudoti esamą OpenAI kodą su Grok?

Atsakymas: Pakeitus base_url į https://api.x.ai/v1 ir API raktą – formato suderinamumas atlieka likusį darbą, įskaitant OpenAI SDK ir Vercel AI SDK.

4. Ką skaitai atsakyme ir naudojimo statistikoje?

Atsakymas: choices neša atsakymus su finish_reason; usage detalizuoja tokenus, įskaitant reasoning_tokens samprotavimo modeliams – tai pagrindas kaštų stebėsenai.

5. Kaip švariai migruoti į Responses API?

Atsakymas: Palaipsniui: nauji kūriniai Responses API, esami galiniai punktai konvertuojami po vieną iš naujo testuojant promptus – dviejų formatų palyginimas padeda konversijoje.

Suprask pasenusį, kurk šiuolaikiškam: kurso palaipsnio migracijos planas yra tavo žemėlapis – be didelių sprogimų.