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

Ročni response_format

Lekcija 5 od 12 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Več nadzora z response_format
  2. Delovni tok
  3. Celoten primer
  4. Razlike glede na parse()
  5. Razčlenjevanje brez Pydantica
  6. Kdaj izbrati response_format
  7. Obravnava napak
  8. Ključne ugotovitve

Več nadzora z response_format

Ročna metoda prek response_format ti daje popoln nadzor nad razčlenjevanjem. Za razliko od parse(), ki vrne tipiziran objekt, ta pristop vrne JSON niz, ki ga razčleniš sam – model Pydantic zagotavlja le shemo (model_json_schema()) in preverja veljavnost naknadno. To metodo izberi, ko potrebuješ prilagodljivost ali ko delaš v okolju brez Pydantica.

Delovni tok

Pri response_format postopek poteka v dveh korakih:

  1. API vrne JSON kot niz v response.choices[0].message.content
  2. Ta niz razčleniš po metodi po lastni izbiri

Celoten primer

from openai import OpenAI
from pydantic import BaseModel

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

class MovieReview(BaseModel):
    title: str
    rating: float
    summary: str
    recommend: bool

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Review the movie Inception"
    }],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "movie_review",
            "schema": MovieReview.model_json_schema()
        }
    }
)

# Vsebina je JSON niz
json_string = response.choices[0].message.content
print(type(json_string))  # <class 'str'>
print(json_string)
# {"title": "Inception", "rating": 9.2, "summary": "...", "recommend": true}

# Ročno razčlenjevanje s Pydanticom
parsed = MovieReview.model_validate_json(json_string)
print(parsed.title)  # "Inception"

Razlike glede na parse()

Vidikparse()response_format
Vrnjena vrednost(Response, ParsedModel)Samo Response
RazčlenjevanjeSamodejnoRočno
Dostop do podatkovparsed.fieldjson.loads() ali model_validate_json()
PrilagodljivostStandardnaNajvečja
Obravnava napakVgrajenaTvoja odgovornost

Razčlenjevanje brez Pydantica

Za razčlenjevanje rezultata ni nujno uporabiti Pydantica. Deluje tudi standardni modul json:

import json

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Analyze this text and extract entities"
    }],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "entities",
            "schema": {
                "type": "object",
                "properties": {
                    "people": {
                        "type": "array",
                        "items": { "type": "string" }
                    },
                    "places": {
                        "type": "array",
                        "items": { "type": "string" }
                    }
                }
            }
        }
    }
)

data = json.loads(response.choices[0].message.content)
print(data["people"])  # ["Marie Curie", "Pierre Curie"]
print(data["places"])      # ["Paris", "Warsaw"]

Kdaj izbrati response_format

response_format se izkaže vedno, ko želiš JSON videti ali pregledati, preden postane objekt. Najpogostejši primer je beleženje: v produkcijskem okolju je hranjenje surovega JSON-a pred pretvorbo pogosto zahteva revizije ali razhroščevanja, parse() pa ti te točke prestrezanja ne omogoča. Sledi vprašanje sheme: če je pogodba tvojega vmesnika surova JSON shema – ki jo deliš z drugimi ekipami, jo generira orodje ali je različičena neodvisno od kode Python – je njeno neposredno uveljavljanje bolj zvesto kot njena rekonstrukcija kot model Pydantic. Nazadnje, ne vsak projekt deluje znotraj ekosistema Pydantic: če tvoje preverjanje veljavnosti poteka prek drugega ogrodja ali prek vmesnega koraka obdelave, specifičnega za tvoj cevovod, ti response_format predroči JSON takšen, kot je, in ti prepusti nadzor nad tem, kaj sledi.

Obravnava napak

Pri ročni metodi moraš napake pri razčlenjevanju obravnavati sam:

import json

try:
    data = json.loads(response.choices[0].message.content)
except json.JSONDecodeError as e:
    print(f"Parsing error: {e}")

V praksi se ta napaka nikoli ne bi smela zgoditi, saj API zagotavlja veljaven JSON. Vendar pa obrambno ravnanje ostaja najboljša praksa v produkcijskem okolju.

Ključne ugotovitve

  • response_format vrne JSON niz v response.choices[0].message.content
  • Razčlenjevanje je tvoja odgovornost: json.loads(), model_validate_json() ali druga metoda
  • Uporabiš lahko surovo JSON shemo namesto modela Pydantic
  • Več prilagodljivosti kot parse(), a več kode za zapisati
  • Vrnjeni JSON je zagotovljeno veljaven – napake pri razčlenjevanju se ne bi smele zgoditi