Palaipsnis migravimas į Responses API
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d.: Anksčiau parametrų atitikmenyse buvo nurodyta, kad
max_tokensiš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:
messagessu vaidmeniusystem→instructions(specialus parametras)messagessu vaidmeniuuser→input(paprasta eilutė)response.choices[0].message.content→response.output_textmax_tokens→max_output_tokens, pagal xAI atitikmenų lentelę;temperatureišlaiko savo pavadinimąresponse.usage.prompt_tokensircompletion_tokens→input_tokensiroutput_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:
- Nustatyk „Chat Completions“ kvietimus savo kode
- Susiek juos pagal sudėtingumą (paprasti → srautiniai → funkcijų kvietimai)
- Pirmiausia migruok naujus galinius punktus arba funkcijas („greenfield“)
- Tada migruok paprasčiausius esamus kvietimus
- 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ų.