Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Postopna migracija na Responses API

Lekcija 12 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Zakaj in kdaj migrirati
  2. 1. korak: Identificiraj funkcije, ki jih uporabljaš
  3. 2. korak: Migriraj osnovne klice
  4. 3. korak: Migriraj večkratne pogovore
  5. 4. korak: Izkoristi nove funkcije
  6. Priporočena strategija migracije
  7. Ključne ugotovitve
  8. Preveri svoje znanje

Posodobljeno 3. novembra 2026: Preslikava parametrov je prej kazala, da max_tokens ohrani ime tudi v Responses API; xAI-jeva tabela ga spremeni v max_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:

  • messages z vlogo system → instructions (namenski parameter)
  • messages z vlogo user → input (preprost niz)
  • response.choices[0].message.content → response.output_text
  • max_tokens → max_output_tokens, glede na xAI-jevo tabelo preslikave; temperature ohrani ime
  • response.usage.prompt_tokens in completion_tokens → input_tokens in output_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:

  1. Identificiraj klice Chat Completions v svoji kodi
  2. Razvrsti jih po zahtevnosti (osnovno → pretakanje → klicanje funkcij)
  3. Najprej migriraj nove končne točke ali funkcije (greenfield)
  4. Nato migriraj najpreprostejše obstoječe klice
  5. 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.