Ručni response_format
Na ovoj stranici
Više kontrole s response_format
Ručna metoda putem response_format daje ti punu kontrolu nad parsiranjem. Za razliku od parse(), koji vraća tipizirani objekt, ovaj pristup vraća JSON niz koji sam parsiraš – Pydantic model ovdje služi samo za definiranje sheme (model_json_schema()) i naknadnu validaciju. Odaberi ovu metodu kada ti treba fleksibilnost ili kada radiš u okruženju bez Pydantica.
Tijek rada
Kod response_format, proces se odvija u dva koraka:
- API vraća JSON kao niz u
response.choices[0].message.content - Taj niz parsiraš metodom po vlastitom izboru
Cjeloviti primjer
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()
}
}
)
# Sadržaj 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}
# Ručno parsiranje s Pydanticom
parsed = MovieReview.model_validate_json(json_string)
print(parsed.title) # "Inception"
Razlike u odnosu na parse()
| Aspekt | parse() | response_format |
|---|---|---|
| Povratna vrijednost | (Response, ParsedModel) | Samo Response |
| Parsiranje | Automatsko | Ručno |
| Pristup podacima | parsed.field | json.loads() ili model_validate_json() |
| Fleksibilnost | Standardna | Maksimalna |
| Rukovanje greškama | Ugrađeno | Tvoja odgovornost |
Parsiranje bez Pydantica
Ne moraš koristiti Pydantic za parsiranje rezultata. Standardni modul json također radi:
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"]
Kada odabrati response_format
response_format briljira kad god trebaš vidjeti ili pregledati JSON prije nego što postane objekt. Najčešći slučaj je bilježenje (logging): u proizvodnji, čuvanje sirovog JSON-a prije transformacije često je zahtjev za reviziju ili otklanjanje grešaka, a parse() ti ne daje tu točku presretanja. Sljedeće je pitanje sheme: ako je tvoj ugovor o sučelju sirova JSON shema – koju dijele drugi timovi, generira alat ili se verzionira neovisno o Python kodu – njezino izravno nametanje vjernije je od rekonstrukcije kao Pydantic modela. Konačno, ne svaki projekt djeluje unutar Pydantic ekosustava: ako tvoja validacija prolazi kroz drugi okvir ili kroz međukorak obrade specifičan za tvoj pipeline, response_format ti predaje JSON kakav jest i prepušta tebi kontrolu nad onim što slijedi.
Rukovanje greškama
Kod ručne metode, sam moraš rukovati greškama parsiranja:
import json
try:
data = json.loads(response.choices[0].message.content)
except json.JSONDecodeError as e:
print(f"Parsing error: {e}")
U praksi, ova greška nikada ne bi trebala nastati jer API jamči valjani JSON. No, defensivno rukovanje ostaje najbolja praksa u proizvodnji.
Ključne točke
response_formatvraća JSON niz uresponse.choices[0].message.content- Parsiranje je tvoja odgovornost:
json.loads(),model_validate_json()ili druga metoda - Možeš koristiti sirovu JSON shemu umjesto Pydantic modela
- Veća fleksibilnost od
parse(), ali zahtijeva više koda - Vraćeni JSON je zajamčeno valjan – greške parsiranja ne bi se trebale dogoditi