Postopna migracija na Responses API
Na tej strani
Posodobljeno 3. novembra 2026: Preslikava parametrov je prej kazala, da
max_tokensohrani ime tudi v Responses API; xAI-jeva tabela ga spremeni vmax_output_tokens, prav tako se spremenijo imena števcev uporabe. Vir: Primerjava s Chat Completions.
Zakaj in kdaj migrirati
Končna točka Chat Completions je označena kot zastarela. Še naprej bo delovala, vendar ji ne bodo dodajali novih funkcij. Če tvoja aplikacija potrebuje orodja na strani strežnika (spletno iskanje, izvajanje kode), shranjevanje pogovorov ali šifrirano sklepanje, postane migracija na Responses API nujna.
Dobra novica: ta migracija lahko poteka postopoma. Ni ti treba vsega prepisati naenkrat.
1. korak: Identificiraj funkcije, ki jih uporabljaš
Pred migracijo si oglej, kaj tvoja aplikacija uporablja s Chat Completions:
# Revizija obstoječe kode
# Poišči te vzorce:
# 1. Osnovni klici (preprosto besedilo)
client.chat.completions.create(model=..., messages=...)
# 2. Pretakanje (Streaming)
client.chat.completions.create(..., stream=True)
# 3. Klicanje funkcij
client.chat.completions.create(..., tools=[...])
# 4. Vid (slike)
# sporočila z vsebino kot polje [text, image_url]
# 5. Parametri generiranja
# temperature, max_tokens, top_p, stop, seed
Osnovni klici in pretakanje so najpreprostejši za migracijo. Klicanje funkcij zahteva prilagoditev formata. Vid deluje podobno.
2. korak: Migriraj osnovne klice
Migracija preprostega klica sledi temu vzorcu:
# PRED — 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 — Responses API
response = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="You are a helpful assistant.",
input="Hello!"
)
texte = response.output_text
Preslikava polj
Glavne spremembe so:
messagesz vlogosystem→instructions(namenski parameter)messagesz vlogouser→input(preprost niz)response.choices[0].message.content→response.output_textmax_tokens→max_output_tokens, glede na xAI-jevo tabelo preslikave;temperatureohrani imeresponse.usage.prompt_tokensincompletion_tokens→input_tokensinoutput_tokens(podrobnosti:input_tokens_details.cached_tokens,output_tokens_details.reasoning_tokens)
3. korak: Migriraj večkratne pogovore
Tukaj Responses API stvari poenostavi. Namesto da bi zgodovino rekonstruirali z vsako zahtevo, jih povežete z ID-jem:
# PRED — Chat Completions (zgodovino upravljate sami)
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 — Responses API (zgodovino upravlja strežnik)
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
Koda je preprostejša in polja sporočil ni treba ročno upravljati.
4. korak: Izkoristi nove funkcije
Ko enkrat migriraš, lahko izkoristiš funkcije, ki so na voljo izključno v Responses API:
Vgrajeno spletno iskanje
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest developments in generative AI?",
tools=[{"type": "web_search"}]
)
# Odgovor vključuje citate z URL-ji virov
Shranjevanje odgovorov
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze this document...",
store=True # Shrani za 30 dni
)
# Poznejši priklic
stored = client.responses.retrieve(response.id)
Šifrirano sklepanje
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this complex problem...",
include=["reasoning.encrypted_content"]
)
# Šifrirano sklepanje lahko ponovno uporabite v naslednjih zahtevah
Priporočena strategija migracije
Namesto da bi migrirali vse naenkrat, postopaj korak za korakom:
- Identificiraj klice Chat Completions v svoji kodi
- Razvrsti jih po zahtevnosti (osnovno → pretakanje → klicanje funkcij)
- Najprej migriraj nove končne točke ali funkcije (greenfield)
- Nato migriraj najpreprostejše obstoječe klice
- Ohrani Chat Completions za integracije tretjih strani, ki jih zahtevajo (LangChain itd.)
Začasno sobivanje
Popolnoma sprejemljivo je, da med prehodom oba končni točki tečeta vzporedno:
# Ovitek, ki abstrahira uporabljeno končno točko
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
Ta pristop ti omogoča postopen preklop s testiranjem vsake migracije posebej.
Ključne ugotovitve
- Migracija je lahko postopna: ni treba vsega prepisati naenkrat
- Glavne spremembe:
messages→input/instructions,choices[0].message.content→output_text - Večkratni pogovori preidejo iz polja sporočil na preprost
previous_response_id - Responses API omogoča dostop do ekskluzivnih funkcij (web_search, shranjevanje, šifrirano sklepanje)
- Med prehodom poganjaj obe končni točki vzporedno in migriraj po vrstnem redu zahtevnosti
Preveri svoje znanje
Zastareli API razumljen – migracija pripravljena.
1. Kaj pomeni zastarel in brezstanjski status Chat Completions?
Odgovor: Končna točka ostaja podprta, vendar se ne razvija več: ker je brezstanjska, zahteva ponovno pošiljanje celotne zgodovine z vsakim klicem – Responses API je sodobna pot.
2. Katere vloge strukturirajo sporočila?
Odgovor: system (in developer), user, assistant – okvir, zahteve, odgovori: celotna zgodovina se z vsako zahtevo znova začne.
3. Kako uporabiš obstoječo kodo OpenAI z Grokom?
Odgovor: S spremembo base_url na https://api.x.ai/v1 in API ključa – združljivost formatov poskrbi za ostalo, vključno z OpenAI SDK in Vercel AI SDK.
4. Kaj bereš v odgovoru in uporabi?
Odgovor: choices nosi odgovore s finish_reason; usage podrobno navaja žetone, vključno z reasoning_tokens za modele sklepanja – osnova za sledenje stroškom.
5. Kako čisto migriraš na Responses API?
Odgovor: Postopoma: nov razvoj v Responses, obstoječe končne točke pretvorjene ena za drugo s ponovnim testiranjem pozivov – primerjava obeh formatov vodi pretvorbo.
Razumi zastarelo, gradi za sodobno: načrt postopne migracije tega tečaja je tvoj zemljevid – brez velikega poka.