Ročni response_format
Na tej strani
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:
- API vrne JSON kot niz v
response.choices[0].message.content - 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()
| Vidik | parse() | response_format |
|---|---|---|
| Vrnjena vrednost | (Response, ParsedModel) | Samo Response |
| Razčlenjevanje | Samodejno | Ročno |
| Dostop do podatkov | parsed.field | json.loads() ali model_validate_json() |
| Prilagodljivost | Standardna | Največja |
| Obravnava napak | Vgrajena | Tvoja 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_formatvrne JSON niz vresponse.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